コールバックのエンコード

URLエンコードは、URLのデータを一定の規則に基づいて符号化し、サーバーで読み取れるようにする方法です。URLは必ずエンコードする必要があります。URLを正しくエンコードしていないと、サーバーエラーが発生し、Adjustがパラメーターを読み込んで処理できなくなる恐れがあります。その結果、貴重なコールバックデータが失われ、リダイレクトやフォールバックが機能しなくなります。

コールバックURLとリンクURLには、同じエンコードの規則が適用されます。

AdjustのURLエンコーディングの要件

エンコードは、コールバックURLのみに必要です。

警告:
AdjustリンクURLとAdjustリンクURL内のキャンペーンパラメーターはエンコードしないでください。

以下は、必ずエンコードするようにしてください。より包括的なリストについては、RFC 3986の仕様を参照してください。

  • 安全でない特殊文字：@, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, ``, ^, ~, [, ], `````, (, )
  • スペース（ ）
  • パラメーター値としてのURL（例：フォールバックURLなど）
  • パラメーター内のパラメーター（例：Androidインストールリファラー値）

コールバックのURLには、スペースや特殊文字を使用しないことをお勧めします。代わりに、アンダースコアを使用してください。

URLの重要な部分をエンコードする必要がある場合は具体的に説明しますが、安全でない文字は全てエンコードする必要があることをご留意ください。値に安全でない文字が含まれているかどうか不明な場合は、値をURLエンコーダーに入力すると、値の中の安全でない文字が変換されます。 

注意:
中かっこ（{ }）を使用したプレースホルダーはエンコードする必要がありません 。

URLが適切にエンコードされていないと、サーバーでエラーが発生し、フォールバックやリダイレクトの誤動作、パラメータの読み取りや処理ができないなどの不具合につながります。

例

コールバックURL内の特殊文字

エンコードされたURL常にURLをエンコード
エンコードされていないURL使用不可
http://callbacks.myserver.com/registration?username=bob_uncle&email=bob.uncle%40mail.com

パラメーターとしてURLを含むリンクURL

エンコードされたURL常にURLをエンコード
エンコードされていないURL使用不可
https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Flanding_page

パラメーター内にパラメーターを含むリンクURL

エンコードされたURL常にURLをエンコード
エンコードされていないURL使用不可
https://app.adjust.com/abc123?referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc
注意:
この例では、実際はすでにエンコードされたURLの中にコールバックパラメータがあるため、コールバックURL値を二重にエンコードする必要があります。