ディープリンクのよくある質問
様々な要因がディープリンクの動作に影響する可能性があります。テストであれ本番用であれ、ディープリンクの動作が想定と異なる場合は、このページをご参照ください。それでも問題が解決しない場合は、support@adjust.comにお問い合わせください。
一般的な問題
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}
パラメーターを含めます。
リンクとdeep_link パラメーターを使用したディープリンクのトラブルシューティング
Facebookの投稿に使用したディープリンクが機能しません。
Facebookの投稿を通じて実施されるキャンペーンでは、 deeplink
パラメーターが追加されたAdjustリンクURLを使用する必要があります。さらに、 deeplink
パラメーターにはパスが追加されている必要があります。パスが追加されていない場合、アプリがインストールされている場合でもユーザーをストアに誘導します。指定するパスは有効である必要はありません。
パスが追加されたパラメーターの例:https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
ディファードディープリンクについてよくある質問
アプリインストール後に、ディファードディープリンクがアプリの正しい場所を開きません。
インストール後、ディファードディープリンクがアプリ内の正しいパスに遷移しない場合は、まずこのパスが実際に存在するかどうかを確認してください。 Web環境でスキーム (myapp://
) をホストし、そこからクリックして、リンクまたはアプリの設定が問題の原因かどうかをテストします。 開発者に連絡して、アプリ内のパスが正しく設定されていることを確認してください。
既存のユーザーでは正しいパスに遷移するが新規ユーザーでは遷移しない場合、テストコンソールを使用してデバイスを検査し、クリックにアトリビュートされていることを確認します。アトリビュートされていない場合は、テストコンソールを使用してデバイス情報を削除し、再試行してください。
クリックにアトリビュートされている場合は、デバイスを検査し、 deeplink
パラメーターが含まれているかどうかを確認します。 含まれていない場合、エンコードの問題または特殊文字が原因でURLが deeplink
パラメーターの前で切れていないことを確認してください。
最後に、 deeplink
パラメーターが含まれている場合は、パスが存在することを確認してください。パスが存在しない場合、何らかの理由でパスが切れています。ご不明な点がありましたら、 support@adjust.comまでお問い合わせください 。
デバイス情報を削除した後に、ディファードディープリンクが機能ません。
テストの際、テストコンソールを使用してデバイス情報を削除した後も、しばらくの間クリック後のディファードディープリンクが維持される場合があります。
これは、次のようにテストを行った場合に発生することがあります。
- ディープリンクをクリックしてアプリをインストールし、アプリを開いた。
- アプリをアンインストールした。
- テストコンソールを使用して、デバイス情報を削除した。
- 他のテスト(クリック、インストール、オープン)を実行したが、ディファードディープリンクが機能しない。
この場合は、アプリをもう一度アンインストールし、テストコンソールを使用してデバイス情報を削除してから、再びテストを実施してください。これを行った後は、ディファードディープリンクは想定どおりに機能するはずです。