ディープリンクのよくある質問

さまざまな要因がディープリンクの動作に影響する可能性があります。テストであれ本番用(production)であれ、ディープリンクの結果が想定と異なる場合は、このガイドを参考にして設定が正しいことを確認してください。 

ここで説明する手順を確認した後も問題が解決しない場合は、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/path?path_param=value&adjust_t=abc123
  • クエリ文字列がエンコードされている場合は、クエリ文字列を/で始めるか、クエリ文字列がディープリンクパラメーターの一部であることを確認してください。 

アプリがまだインストールされておらず、これらの条件が満たされていない場合、adjust_tパラメーターはブラウザによって破棄されます。Adjustは、クリックのソースを特定するためにこのパラメーターが必要です。このパラメーターがない場合、HTTP 404エラーURL not foundが返されます。

URLの設定方法に応じて、ディープリンクは以下のように動作します。

トラッカーURL + deep_linkパラメーター - アプリを開く: https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath

ユニバーサルリンク - アプリを開く: https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7

ユニバーサルリンク - ストアを開く: https://abcd.adj.st/?path&adjust_t=r40ncx7

ユニバーサルリンク - 無効であり、エラーを返す: https://abcd.adj.st%3Fpath?adjust_t=r40ncx7

アトリビューションデータやキャンペーンレベルが管理画面に表示されない

ディープリンクのトラッカーURLからアトリビューションデータまたはキャンペーンレベルが表示されない場合は、設定方法をご確認ください。デバイスIDパラメーターやキャンペーンパラメーター(該当する場合)が、エンコードのエラーによりフォールバックまたはコールバックから欠落していないことを確認してください。例えば、URLにスペースが入っていないか、あるいは無効な文字が使用されていないかなどです。 

アプリがインストールされているのにストアに転送される

この動作は通常、ディープリンクがアプリを開くのに失敗し、フォールバックとしてストアにリダイレクトされたことを意味します。これをテストするには、以下の手順に従ってください。

  1. 既存ユーザーとしてユニバーサルリンクのテストと、deep_linkパラメーターを使用したトラッカーのテスト手順に従います。 
  2. テストに成功してアプリが開いた場合、失敗したときにはどの環境からディープリンクがクリックされたのかを検討します。次に、その状況で追加のパラメーターが必要かどうかを確認します。 
    1. たとえば、JSR ulinkがSlackにてクリックされる場合、adjust_deeplink_js=1flagの指定が必要です。これにより、ストアにリダイレクトされる前に管理画面からスキームが読み込まれます。js-flagを指定してもリンクが機能しない場合は、管理画面でApp Scheme(アプリスキーム)の入力が誤っている可能性があります。 
  3. トラッカーURL内で、フォールバックまたはコールバックにエンコードエラーがないことを確認します。エラーがあると、URLが破損する可能性があります。

ディープリンクでアプリは開くが、指定された遷移先では開かない 

一般的には、アプリが開いた時点でAdjustの処理は完了しています。問題の原因がリンクにあるのか、それともアプリの設定にあるのかをテストするために、ユニバーサル リンク ドメイン(https://abcd.adj.st/)またはスキーム(myapp://)をWeb環境でホストし、そこからリンクをクリックしてみてください。 

リンクが正しい場所で開かないがアプリは開く場合は、開発チームに連絡して、アプリ内のパスが正しく設定されていることを確認してください。 

ユニバーサルリンクについてよくある質問

ユニバーサルリンクがインストール済みのアプリを開かない

まず、Appleがリンクを開こうとしている環境を確認してください。ユニバーサルリンクへのリダイレクトはSafariを除きAppleによって許可されていないため、RawユニバーサルリンクまたはスキームをWeb環境でホストする必要があります。例えば、それぞれhttps://abcd.adj.st/またはmyapp://をホストします。アプリをテスト用デバイスにインストールしてページにアクセスし、ディープリンクを選択します。 

Rawスキーム/ユニバーサルリンクが選択されているときにアプリを開いている場合、省略されていない元のURLを壊すエンコードされていないコールバックやフォールバックがないかどうかを確認します。存在する場合、パラメーターが破棄される可能性があります。パラメーターが破棄されると、完全なトラッカーやユニバーサルリンクが意図したとおりに機能しなくなります。

もう1つ確認する点は、次のtargetアトリビュートです。

target=“_blank”

これがあると、テスト中にアプリが開かれる可能性があります。しかし、テスト環境以外では開かれません。

例えば、次の例のようにHTMLコードにtarget=“_blank”アトリビュートが含まれる場合です。

<a href="https://abcd.adj.st"target="_blank">Universal Link to App</a>

この問題を解決するには、次の例のように該当するアトリビュートを削除します。

<a href="https://abcd.adj.st">Universal Link to App</a>

アプリが開かない場合、ユニバーサルリンクまたはスキームのいずれかが、アプリと正しく関連付けられていません。

アプリが開かない場合、ユニバーサルリンクまたはスキームが、アプリと正しく関連付けられていません。Adjust管理画面その他の設定(All Settings)> プラットフォーム(Platform)> ユニバーサルリンク(Universal Linking)で、アプリのiOS Bundle IDおよびApp Prefixを確認してください。正しく設定してもアプリが開かない場合は、開発者に相談して、ユニバーサルリンクまたはスキームアプリの関連付けの調査を進めてください。

ユニバーサルリンク(Universal Linking)のApp Prefixフィールド

メールキャンペーンでユニバーサルリンクを使用できるか 

残念ながら、iOSではユニバーサルリンクへのリダイレクトが許可されていないため、SFSafariViewControllerを使用するすべての環境が影響を受けます。

iOS 12.2および12.3のSafariでJSRディープリンクに問題がある

iOS 12.2および12.3では、Safari環境でJSRユニバーサルリンクをクリックしても、常に正しく開くとは限りません。これは特に、プライベートブラウズの使用時などに、リファラーのHTTPヘッダーが読み取れない状況に影響します。 

従って、SafariのキャンペーンにはRawユニバーサルリンクを使用することを推奨します。ただし、URLがラップされるメールキャンペーンではこの限りではありません。

iOS 13以降では、スキームへのフォールバックが可能なため、この問題は該当しません。ただし、これによって追加のポップアップが発生します。

トラッカーとdeep_linkパラメーターを使用したディープリンクのトラブルシューティング

Facebookの投稿に使用したディープリンクが機能しない

Facebookへの投稿を通じて実施されるキャンペーンでは、ディープリンクパラメーターを追加した上でAdjustトラッカーURLを使用する必要があります。さらに、ディープリンクパラメーターにはパスが追加されていなければなりません。追加されていないと、アプリがインストールされている場合でもユーザーがストアにリダイレクトされます。指定するパスは有効である必要はありません。 

パスを追加したパラメーターの例: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path

ディファードディープリンクについてよくある質問

インストール後のアプリがディファードディープリンクによって正しい場所で開かない  

ディファードディープリンクがインストール後のアプリ内の正しいパスに遷移しない場合は、そのパスが実際に存在するかどうかをまず確認してください。このテストを実行することで確認できます。  

既存のユーザーでは正しいパスに遷移するが新規ユーザーでは遷移しない場合、テストコンソールを使用してデバイスを検査し、クリックにアトリビュートされていることを確認します。アトリビュートされていない場合は、テストコンソールを使用してデバイス情報を削除し、再試行してください。 

クリックにアトリビュートされている場合、デバイスを調査し、ディープリンクパラメーターがデバイスに含まれていることを確認します。含まれていない場合、エンコードの問題または特殊文字が原因で、ディープリンクパラメーターよりも前の部分でURLが切れていないことを確認してください。

最後に、ディープリンクパラメーターが含まれている場合は、想定どおりにパスが存在していることを確認してください。存在しない場合、何らかの理由によりディープリンクのパスが切れています。サポートが必要な場合はsupport@adjust.comにご連絡ください。 

デバイス情報を削除した後に、ディファードディープリンクが機能しない

テストの際、テストコンソールを使用してデバイス情報を削除した後も、しばらくの間クリック後のディファードディープリンクが維持される場合があります。

これは、次のようにテストを行った場合に発生することがあります。

  1. ディープリンクをクリックし、アプリをインストールし、アプリを開いた

  2. アプリをアンインストールした

  3. テストコンソールを使用してデバイス情報を削除した

  4. 他のテスト(クリック、インストール、オープン)を実行したが、ディファードディープリンクが機能しない  

この場合は、アプリをもう一度アンインストールし、テストコンソールを使用してデバイス情報を削除してから、再びテストを実施してください。これを行った後は、ディファードディープリンクは再び想定どおりに機能するはずです。

このトピックについて