ユニバーサルリンクについてよくあるご質問
様々な要因が、ユニバーサルリンクの動作に影響する可能性があります。テストであれ本番用であれ、ユニバーサルリンクの結果が想定と異なる場合は、このページをご参照ください。それでも問題が解決しない場合は、Adjustまでお問い合せください。
一般的な問題
URL構文とエンコードが正しく設定されているかを確認する方法は?
ディープリンクで、指定された遷移先に転送されないかHTTP 404エラーが返される場合は、はじめに、URLの構文とエンコードが正しいことを確認してください。
URLは通常、次の構文を使用します:scheme://host:port/path?query-string#fragment-id
URLの各部分は異なる機能を実行し、特定の文字を使用して値を識別および区別します。スキームとホストは大文字と小文字を区別しませんが、パスとクエリ文字列は区別します。URLの構成が誤っていると、意図したとおりにURLが開きません。
ディープリンクを設定するときは、以下の条件に注意してください。
- クエリパラメーターがすでに含まれているURLクエリ文字列にAdjustパラメーターを追加する場合は、
&
を使用します。 それ以外の場合、URLの2番目の?
よりも後の情報は全て破棄されます。- 正しい例:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012
- 誤った例:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- 正しい例:
- クエリ文字列がエンコードされている場合は、
/
で始めるか、deeplink
パラメーターの一部であることを確認してください。
アプリがまだインストールされておらず、これらの条件が満たされていない場合、 adjust_t
パラメーターはブラウザーによって破棄されます。Adjustは、クリックのソースを特定するためにこのパラメーターを必要とします。これがないと、HTTP 404エラー URL not found
が返されます。
例
URLの設定方法に応じて、ディープリンクは以下のように動作します。
ディープリンクの設定 | リンクURLの例 | 動作 |
---|---|---|
リンクURL + deep_link パラメーター | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | 指定したアプリ内ページでアプリを開く |
Universal Link | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | 指定したアプリ内ページでアプリを開く |
Universal Link | https://abcd.adj.st/?path&adjust_t=r40ncx7 | アプリがインストール済みだが、指定したアプリ内ページに到達できない場合にアプリを開く |
Universal Link | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | 無効なため、エラーを返す |
アトリビューションデータやキャンペーンレベルが表示されない理由とは?
ディープリンクURLからアトリビューションデータまたはキャンペーンレベルを取得できない場合、設定に問題がある可能性があります。 デバイスIDパラメーターやキャンペーンパラメーター(該当する場合)が、エンコードのエラーによりフォールバックまたはコールバックから欠落していないことを確認してください。例えば、URLにスペースが含まれていないか、または無効な文字が含まれていないかなどです。
アプリがインストールされているのに、ストアにリダイレクトされる理由とは?
この動作は通常、ディープリンクがアプリを開くのに失敗し、フォールバックとしてストアにリダイレクトされたことを意味します。これをテストするには、以下の手順に従ってください。
既存ユーザーとして、 ユニバーサルリンクとdeep_linkパラメーターを使用したリンクのテスト手順に従ってください。
テストに成功してアプリが開いた場合、失敗したときにはどの環境からディープリンクがクリックされたのかを検討します。次に、その状況で追加のパラメーターが必要かどうかを確認します。
- 例:JSRユニバーサルリンクがSlackからクリックされた場合、
adjust_deeplink_js=1
フラグが表示されます。これにより、ストアにリダイレクトする前にスキームを読み込むことができます。adjust_deeplink_js
フラグが存在してもリンクが機能しない場合、アプリスキームがCampaign Labに誤って入力されている可能性があります。
- 例:JSRユニバーサルリンクがSlackからクリックされた場合、
リンクURL内のフォールバックまたはコールバックに、リンクを壊す可能性のある エンコードエラー がないことを確認してください。これにより、パラメーターが削除されます。パラメーターがドロップされると、完全なリンクが意図したとおりに機能しなくなります。
ディープリンクがアプリの正しい場所を開かない理由とは?
リンクが正しい場所で開かず、アプリが開いてしまう場合は、リンクまたはアプリの設定が問題の原因となっていないかどうかを確認してください。
- Web環境でユニバーサルリンクドメイン (
https://abcd.adj.st/
) またはスキーム (myapp://
) をホストし、そこからクリックしてください。 - 開発者に連絡して、アプリ内のパスが正しく設定されていることを確認してください。
Adjustは、AdjustリンクまたはAdjustパラメーターが追加されたディープリンクのクリックデータを受信します。アプリ固有のドメインのみを含むダイレクトディープリンクは、Adjustにデータを返しません。
クリックデータを送信:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
クリックデータを送信しない:
myapp://welcome
すでにインストール済みのアプリのクリックデータとディープリンクのリアトリビューションのクリックデータを受信するには、Adjust SDK(iOS、Android)でSDKクリックを必ず有効にしてください。
SDKクリックをトリガーするディープリンクは、Datascapeでクリックとしてレポートされます。また、click
コールバックを使用してローデータにも表示されます。ディープリンクのSDKクリックから発生したクリックを詳細に確認するには、{is_deeplink_click}
パラメーターを含めます。
ユニバーサルリンクの問題
ユニバーサルリンクがインストール済みのアプリを開きません。
ユニバーサルリンクの設定が正しいかどうかを確認してください。
Appleがリンクを開こうとしている環境を確認してください。ユニバーサルリンクへのリダイレクトはSafariを除きAppleによって許可されていないため、RawユニバーサルリンクまたはスキームをWeb環境でホストする必要があります。例えば、
https://abcd.adj.st/
またはmyapp://
などです。アプリをテスト用デバイスにインストールし、Rawユニバーサルリンクまたはスキームをホストしたページにアクセスして、リンクを選択します。
アプリが 開かない 場合:
- Safariでテスト用のHTMLを開き、共有アイコンを選択します。「...で開く」メニューで、アプリがオプションの1つとして表示されます。これが表示された場合、Associated Domainsの設定は正しく、Apple App Site Association (AASA) のファイルが正しくダウンロードされています。このオプションが表示されない場合は、アプリをアンインストールして再インストールしなければならないことがあります。
- テストと本番用(production)のバンドルIDが同じであることを確認します。
- AppViewのアプリのiOSバンドルIDとApp Prefixが正しいことを確認します。正しく設定してもアプリが開かない場合は、開発者に相談して、ユニバーサルリンクまたはスキームアプリの関連付けの調査をしてください。
target=“_blank”
アトリビュートがリンクに含まれているかどうかを確認してください。
これがあると、テスト中ではアプリが開く可能性がありますが、本番用(production)環境では開きません。
例えば、target=“_blank”
アトリビュートがあると、HTMLコードは次のようになります。
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
この問題を解決するには、次の例のように該当するアトリビュートを削除します。
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
アプリがインストールされているにも関わらず、ストアにリダイレクトされます。
- ユニバーサルリンクのテスト手順に従ってください。また、上記の「ユニバーサルリンクがインストール済みのアプリを開きません」に記載されている手順を実行してください。
- 失敗した場合、どの環境からユニバーサルリンクがクリックされたのかを確認してください。次に、その状況で追加のパラメーターが必要かどうかを確認します。
- 例えば、JSRユニバーサルリンクがSlackにてクリックされる場合、
adjust_deeplink_js=1
の指定が必要です。これにより、ストアにリダイレクトされる前にダッシュボードからスキームが読み込まれます。adjust_deeplink_js
を指定してもリンクが機能しない場合は、ダッシュボードでApp Scheme(アプリスキーム)の入力が誤っている可能性があります。
- 例えば、JSRユニバーサルリンクがSlackにてクリックされる場合、
アプリインストール後に、ディープリンクやディープリンクディープリンクがアプリの正しい場所を開きません。
リンクが正しい場所で開かず、アプリが開いてしまう場合は、リンクまたはアプリの設定が問題の原因となっていないかどうかを確認してください。
- ユニバーサル リンク ドメイン(
https://abcd.adj.st/
)またはスキーム(myapp://
)をWeb環境でホストし、そこからリンクをクリックしてみてください。 - 開発者に連絡して、アプリ内のパスが正しく設定されていることを確認してください。
既存のユーザーでは正しいパスに遷移するが新規ユーザーでは遷移しない場合、テストコンソールを使用してデバイスを検査し、クリックにアトリビュートされていることを確認します。アトリビュートされていない場合は、テストコンソールを使用してデバイス情報を削除し、再試行してください。
クリックにアトリビュートされている場合、デバイスを調査し、deeplink
パラメーターがデバイスに含まれていることを確認します。含まれていない場合、エンコードの問題または特殊文字が原因で、deeplink
パラメーターよりも前の部分でURLが切れていないことを確認してください。
最後に、deeplink
パラメーターが含まれている場合は、パスが存在していることを確認してください。存在しない場合、何らかの理由によりパスが切れています。サポートが必要な場合はsupport@adjust.comにご連絡ください。
FacebookやInstagramの投稿に使用したユニバーサルリンクが機能しません。
ユニバーサルリンクにパスが追加されていることを確認してください。追加されていないと、アプリがインストールされている場合でも、ユーザーがストアにリダイレクトされます。指定するパスが有効である必要はありません。
パスが追加されたパラメーターの例:https://abcd.adj.st/path?adjust_t=abc123
メールキャンペーンでユニバーサルリンクを使用できるか
ほとんどの場合、iOSではSafari外部でユニバーサルリンクへのリダイレクトが許可されていないため、SFSafariViewControllerを使用する全ての環境が影響を受けます。
ユニバーサルリンクをサポートしていないブラウザや別のメールアプリケーションなど、メールが開かれる環境はさまざまです。そのため、JSRリンクを使用するか、あるいは可能であればAdjustのESP連携を使用していただくことを推奨します。
アトリビューションデータやキャンペーンレベルが表示されません。
Adjustパラメーターにadj_
またはadjust_
のプレフィックスが指定されているかを確認してください。adj_
またはadjust_
のプレフィックスが指定されていない全てのAdjustパラメーターはドロップされ、これらのパラメーターのデータを確認できない可能性があります。
インストールが正しくアトリビュートされているにも関わらず、パートナーがアトリビュートされたコールバックを受け取っていません。
- クリックIDパラメーターをユニバーサルリンクに追加したことを確認します。
- リンクURL内のフォールバックまたはコールバックに、リンクを壊す可能性のある エンコードエラー がないことを確認してください。
- クリックIDパラメーターに
adj_
またはadjust_
のプレフィックスが指定されていることを確認します。
iOS 12.2と12.3のSafari上で、JSRユニバーサルリンクに問題が発生します。
iOS 12.2および12.3では、Safari環境でJSRユニバーサルリンクをクリックしても、常に正しく開くとは限りません。これは特に、プライベートブラウズの使用時など、リファラーのHTTPヘッダーが読み取れない状況に影響します。
従って、Safariのキャンペーンには、Rawユニバーサルリンクを使用することを推奨します。ただし、ラップされたURLを含むメールキャンペーンでは機能しません。
iOS 13以降では、スキームにフォールバックを追加することが可能なため、この問題は該当しません。ただし、これによって追加のポップアップが表示されます。