OneLinkトラブルシューティングとよくある質問

ユニバーサルリンク：iOSユーザーの98%以上で必要な方法です

URIスキーム： Samsung端末でアプリを起動するための主要な方法です。それ以外の場合は、アプリを開くための従来のフォールバック方法です。
次の場合に使用できます。

• バージョン6.0以前を使用しているAndroidユーザー（Androidユーザーの15%以下）の場合。
• Universal LinksとApp Linksが機能しない、または設定されていないためにアプリが開かない場合のフォールバックとして使用

  注：ユニバーサルリンクのフォールバックとしてURIスキームを使用することは、iOSベースの制限の対象となります。詳細はこちらを参照してください。

ディープリンク

ユニバーサルリンク、アプリリンク、およびURIスキームは、アプリを起動するための安全な方法です。ユーザーをアプリ内の特定のアクティビティまたはページにディープリンクしてリダイレクトするためには、OneLinkディープリンクの手順に従ってください。

はい。ユニバーサルリンクまたはアプリリンクが実装され、既存のユーザー用にアプリを開くたびに、iOS 関連ドメインまたは AndroidManifest.xml が更新されます。つまり、新しいバージョンのアプリを関連するアプリストアにアップロードする必要があります。ポイント：アプリバージョンの更新の必要性を最小限に抑えるには、アプリ起動とディープリンクに必要な開発関連のすべての変更を一度に行います。

はい。 しかし、テンプレートをそのように設定すると、すべてのユーザー（新規および既存）に影響し、全員がランディングページ/ウェブURLにリダイレクトされます。つまり、新規ユーザーはアプリストアに送られません。

ユーザーをWebページに遷移させたい場合：

1. OneLinkテンプレートでは、Universal Links, App Links, およびURIスキームを設定しないでください。
2. 「アプリがインストールされていない場合」の項目で、ランディングページ/ウェブURLへのリダイレクトを設定します。
   • ランディングページ/ウェブのURLがaf_android_urlとaf_ios_urlパラメータの値として追加されます。
   • その後、アプリをインストールした時（既存のユーザー）にも自動的にリダイレクトが適用されます。

注意： アプリ起動後にのみ、既存のユーザー をモバイルWebページにリダイレクトさせたい場合は、アプリ開発者がその動作を設定する必要があります。

特定のリダイレクトは、次のものに対して設定できます。

• Windows Phone
• iPads
• Amazon Kindle Fire

他のタブレットは現在、個別のリダイレクトではサポートされていません。

はい。単一のOneLinkテンプレートを使用して、無制限の数のOneLink URLを作成できますが、場合によっては、アプリを複数のOneLinkテンプレートに割り当てることが必要になることがあります。たとえば、外部ストア用に複数バージョンのAndroidアプリを用意している場合は、同じiOSアプリが割り当てられている、Androidバージョンごとの別々のOneLinkテンプレートが必要になることがあります。

重要：

アプリを開くためにiOSユニバーサルリンクとAndroidアプリリンクを使用するテンプレートの場合、かつ テンプレートのサブドメインが異なる場合 、それぞれにiOSアプリとAndroidアプリを設定し、アップデートする必要があります。

• iOS ユニバーサルリンク： 新しいOneLinkテンプレートを作成し、アプリ内の関連ドメイン (Associated Domain) を更新した後、App Storeに新バージョンを提出します。新しいバージョンに更新したiOSユーザーのみが、新しいテンプレートで構築されたOneLink URLをアクティブ化できます。
• Android アプリリンク：
  1. 新しいOneLinkテンプレートを作成した後、App Linkセクションの下部にあるXMLスニペットをコピーして、ディープリンクするインテント内の AndroidManifest.xml ファイルに、以前のインテントに加える形で追加します。
  2. 新しいバージョンをストアにリリースします。新しいバージョンに更新したAndroidユーザーのみが、新しいテンプレートで構築されたOneLink URLをアクティブ化できます。

はい、ただし担当CSMまでご連絡いただくか、カスタマーエンゲージメントチームにhello@appsflyer.comまでご連絡ください。

注：削除されたテンプレートに基づく既存の OneLink URL がある場合、これらはユーザーをアプリストアに遷移させる動作も機能しません。このため、テンプレートを削除する前に、テンプレートを使用している OneLink URL がないことを最初に必ず確認することが重要です。または、既存のテンプレートの設定を削除するのではなく、既存のテンプレートの設定を変更して、必要な結果が得られるかどうかを検討してください。

はい。テンプレートに基づく既存のカスタムリンクがAppsFlyerに存在しない限り変更は可能です。

OneLink テンプレートに基づくカスタムリンクが AppsFlyer にすでに存在する場合、サブドメインは変更できません。この制限は、公開されているリンクのリダイレクト／ディープリンクの動作を壊さないように設計されています。

既存のカスタムリンクを含むテンプレートのサブドメインを変更する必要がある場合は、次のいずれかを実行してください。

• 新しいサブドメインを使用して新しい OneLink テンプレートを作成し、それに基づいてリンクを作成します。
• サブドメインを変更する必要があるテンプレートに基づいて、既存のカスタムリンクをすべて削除してください。テンプレートに基づくすべてのリンクが削除されると、サブドメインは編集可能になります。

いいえ。 特定のテンプレートとテンプレート ID に構成されたサブドメイン / ドメインを取得し、手動で別のテンプレート ID に連結すると、ユニバーサルリンクとアプリリンクの機能が中断され、セキュリティ上の脅威となります。

例：

• テンプレート 1ABC は、サブドメイン bank.onelink.me を使用して構成されます。
• テンプレート D123 は、サブドメイン game.onelink.me を使用して構成されます。
• リンク bank.onelink.me/1ABC/shorturl は、テンプレート 1ABC に基づいて作成され、動作します。
• リンク game.onelink.me/D123/exampleurl は、テンプレートD123に基づいて作成され、機能します。
• リンク game.onelink.me/1ABC/shorturl は、動作しません
• リンク bank.onelink.me/D123/exampleurl は動作しません

はい。ただし、サブドメインで個別のテンプレートを作成してください。サブドメインをテンプレート ID に手動で追加するだけではありません。

デスクトップユーザーは、メールキャンペーンなどを通じて OneLink カスタムリンクを利用することができます。ただし、デスクトップユーザーがこれらのリンクをクリックすると、モバイルサイト、アプリストア、またはアプリへリダイレクトできません。

では、デスクトップユーザーに優れたユーザーエクスペリエンスを提供し、モバイルユーザーに変換するにはどうしたらよいでしょうか。

OneLink URLまたはテンプレートでは、デスクトップユーザー（Windows または Mac）を別のURLにリダイレクトできます。このWeb URLは、リンクに af_web_dp パラメーターとして追加されます。注：リンクに af_web_dp が含まれる場合は、クリックがデスクトップから発生した場合、AppsFlyerはそのクリックを記録しません。

Chromebookのアプリは Androidアプリと見なされます。

Chromebookで、アプリをインストールしていない新規ユーザーを別のウェブ URL にリダイレクトするには：

1. OneLinkテンプレート設定で、リンクの動作 > 設定 > アプリがインストールされていない場合 > Android > 別のURLに変更 をクリックします。
   または、
   OneLinkリンク設定で ディープリンクとリダイレクト > リダイレクト > アプリがインストールされていない場合 > Android > Web URL を選択します。
2. URLを入力してください。リンク設定で追加すると、URLがパラメータ内のリンクに af_android_url パラメータの値として追加されます。

はい、ただし機能するのは一部の機能のみです。

モバイルウェブ訪問者をいち早くモバイルユーザーにしたく、AppsFlyer SDKをまだ実装できない場合は、その方法も可能です。

アプリにまだAppsFlyerのSDKが実装されていなくても、基本的なユーザーのリダイレクトとアプリ起動は機能します。スマートバナーはSDKを必要としないため、SDKなしでも正常に動作します。

ただし、SDK がないということは、次のことを意味します。

• クリックしたユーザーは、最初のアプリ起動以降はディープリンクすることはできません。
• 計測データは記録されません。
• アプリ内イベントは記録されません。

次の表は、OneLinkのカスタムリンクを作成する際に利用できるさまざまな方法を比較したものです。

はい、ただしユニバーサルリンクとアプリリンクは、クリックしたときにのみ機能することに注意してください（たとえば、Webページやメール上のリンクをクリックした場合など）。ブラウザのアドレスバーにリンクを貼り付けた場合、アプリにディープリンクされません。URL をクリックしてリンクをテストしてください。ブラウザのURLボックスに貼り付けるのではなく、URLをクリックします。

全ての設定が完璧であっても、場合によってはOneLink URLが意図したディープリンクにならないことがあります。この場合、アプリを起動したりアプリ内の特定のアクティビティにディープリンクする代わりに、ユーザーはアプリストアまたはエラーページにリダイレクトされます。

これにはいくつかの理由が考えられます。

• ホストアプリケーション：計測リンクを設置された各種アプリ（Whatsapp、Gmail、Wechatなど）は、独自のアプリ内ブラウザなど、クリックされたリンクをアクティブにするためのさまざまな方法を使用します。これらのいくつかは、すべての計測リンクをブロックすることが知られています。
• ブラウザ：一部のブラウザやOSプラットフォームでは、リンクの動作が異なります。一部のブラウザでは、例えばリンクを貼り付けても機能しません。リンクは実際にクリックされる必要があります。
• OSアップデート：新しいOSアップデート（iOSとAndroidの両方）により、ディープリンクを妨げる予期しない不具合が発生する可能性があります。
• デバイス：iOS、Android、Windows MobileなどのOSバージョンが異なるスマートフォン、タブレット、パソコン、その他のデバイスは、計測リンクの表示方法に大きく違いがあることがあります。
• 間違った設定： ディープリンクの値に 特殊文字 を使用すると、リンクが切れます。

ユーザー体験を向上させるための2つのソリューションは、フォールバックURLと強制的なディープリンクです。

フォールバックURL

フォールバックURLは、何らかの理由でアプリを開くことやディープリンクに失敗した場合に、ユーザーを特定のWebページに送ります。警告！アプリがインストールされていないユーザーも、正しいアプリストアではなくフォールバックURLに送信されます。そのため、このオプションは、すでにアプリがインストールされているユーザーをリターゲティングする場合にのみ使用するようにしてください。

フォールバックURLを実装するには、OneLinkのテンプレートまたはカスタムリンクの設定で、アプリがインストールされていないときのリンク動作を設定し、別のURLにリダイレクトしてください。

この設定を使用すると、フォールバックの送信先パラメーターとして af_ios_url と af_android_url が追加され、iOS ユーザーは af_ios_url で指定されたページに、Android ユーザーは af_android_url で指定されたページにリダイレクトされます。

https://go.onelink.ly/qwerty?pid=source&af_dp=greatapp%3A%2F%2F&af_ios_url=www.yoursite.com/ios-bonus
&af_android_url=www.yoursite.com/android-bonus

強制ディープリンク

強制ディープリンクを使用すると、アプリと起動しユーザーをディープリンクさせるためのフォールバックとしてURIスキームを使用できます。

このソリューションは、既にアプリをインストールしているほとんどのユーザーに対して機能します。ただし、iOSの場合、URIスキームを使ってアプリを起動するには制限があり、URIスキーム（af_dp パラメーター）で指定されたアクティビティに強制的にディープリンクするためには、af_force_deeplink=true をOneLink URLに追加する必要があります。詳細は、iOS向けのURIスキームフォールバックをご覧ください。

target 属性を含むHTML <a> タグを使用していないことを確認してください。OneLink URLが target="_blank" という属性を持つ <a> タグ内に配置されると、Chrome（iOSとAndroidの両方で）で空白ページが開き、ユーザーはApp StoreやGoogle Playにリダイレクトされません。

はい。ただし、Androidでは、ユーザーが Brave ブラウザで OneLink リンクをクリックすると、ディファードディープリンクは機能しません。また、iOSでは、ユーザーがクリックすると空白の画面が表示され、ディファードディープリンクは、空白の画面でスクロールやタップなど、何かを行った場合にのみ機能します。

いいえ。OneLinkカスタムリンクは、余分な処理や読み込み時間を加えることなく、適切に機能し、必要に応じてユーザーをリダイレクトします。他のAppsFlyerリンクと同様に高速に機能します。

CPI（インストール毎のコスト）（その他のパラメーターの下）をオンにすると、このリンク経由で発生した各インストールに特定のCPI値を適用することができます。

CPIとして適用するコストの通貨と数値のみの値（小数点以下4桁まで）を選択してください。これにより、af_cost_currency と af_cost_value というパラメーターがリンクに追加されます。

af_r、af_ios_url、af_android_url、af_web_dp は、計測リンクまたはOneLinkからパラメーターをリダイレクトされたページへ引き継ぎます。これを防ぐためには、計測リンクに af_param_forwarding=false を追加してください。

場合によっては、複数のPIDパラメータを持つ URLがあるケースがあります。 これは、AppsFlyerがリダイレクトURLに PID および C パラメーターを追加し、広告主が独自の PIDパラメーターを追加できるためです。
たとえば、広告主のウェブサイトのURLの 'product ID' が 'pid' である場合があります。

通常、計測リンクに af_param_forwarding=false パラメータが存在する場合、リダイレクト時にすべてのパラメータが削除されます。

ただし、デスクトップからリンクがクリックされた場合、広告主は重要なCRM関連のデータが保持されているパラメーターを残したい場合があります。 AppsFlyer PID パラメーターと C パラメーターのみを削除し、他のすべてのパラメーターを保持するには、計測リンクに af_base_params_forward=false パラメータを付与します。

OneLinkは、オウンドメディア向けのカスタム計測リンクを作成するためにサポートされている唯一の方法です。

以前は、OneLinkを使用せずに、単一プラットフォーム（アプリ固有）のカスタムリンクを作成することができました。この方法は廃止され、新しいカスタムリンクはOneLinkテンプレートに基づいてのみ作成できます。

ただし、従来の単一プラットフォームのカスタムリンクをお持ちの場合、それらは引き続き機能します。[OneLink カスタムリンク] ページの右上隅にある [従来のシングルプラットフォームリンクを表示 ] をクリックして、従来のリンクを表示および編集することもできます。

いいえ、ショートURLのIDは、リンク作成時にしか設定できません。

外部リンクの短縮やOneLinkカスタムリンクのラッピングは、ユニバーサルリンクやアプリリンクのアプリ起動機能を壊します。

ユニバーサルリンクやアプリリンクを有効にするためには、OSがアプリに関連するURLのドメイン (Assosicted Domain) を認識する必要があり、外部からのリダイレクトや短縮、ユーザー向けリンクへのリダイレクトなどを行うと、これが不可能になります。これには、bit.ly、AppsFlyerブランドのリンクでないもの、クリック計測が有効になっているEメールサービスプロバイダ (ESPs) も含まれます。

リダイレクトが正常に機能するようにリンクをラップまたは短縮するには： 

• OneLinkカスタムリンクを作成する際に、AppsFlyerで生成されたショートリンクを使用します（bit.lyのような外部の短縮ツールではなく）。
  ヒント：リンクに短いブランドドメインを作成することで、URLをさらに短くすることができます。また、AppsFlyerの管理画面でリンクを作成している場合は、URL IDを編集してできるだけ短くすることができます。
  例： https://brand.com/a1b2/a
  （ここで、 brand.com はお客様のブランドドメイン、 a1b2 は常に4文字で構成される変更不可のテンプレートID、 a は1文字に編集可能なURL IDです。）
  
  メリット：
  • この方法は、OneLinkテンプレートで設定されたOneLinkサブドメインを使用するため正常に機能します。
  • 計測URLを入稿してしまった後でも、ディープリンク設定を含む各種パラメーターを管理画面上で変更できます。
  • AppsFlyerの管理画面上で端末からの全クリックを計測するため、別のサービスを確認する必要もありません。
  • 短縮URLの最後の部分をカスタマイズして、ブランドリンクにすることも可能です。
• ユニバーサルリンクやアプリリンクが失敗したときにアプリを開くためのフォールバックとして、URIスキームを使用し、リンクに af_force_deeplink=true パラメータを追加します。
• ESPを使用するオプションを参照してください。

はい、ただし、メールサービスプロバイダー（ESP）と連携する場合は、特別な配慮が必要です。クリック数をカウントするために、ESPはメール内に貼られたすべてのリンクをラップします。これにより、URLをクリックしたユーザーのアプリ起動/ディープリンクの流れが崩れてしまいます。

これを防ぐには、以下のオプションのいずれかを使用してください。

• ESPの設定でクリックの記録を無効にしてください。
  （ヒント：これは一般的に最も簡単な解決策です。）
• af_esp=true というフラグを計測リンクに追加することで、af_dp パラメーターで指定されたURIスキームでアプリを強制的に開くことができます。この解決策は、既にアプリをインストールしているユーザーに対しては機能します。
• ユニバーサルリンクでのアプリ起動とディープリンクについてAppsFlyerのソリューションをサポートしているESPを使用してください。詳細はこちら。

OneLinkは、ユーザーのIPアドレスに基づいて、適切な地域のアプリストアにリダイレクトします。

AppsFlyerで「許可されたリンクドメイン」が有効になっているか確認してください。有効にしている場合は、目的のウェブURLのドメインまたはサブドメインが表示されている必要があります。 許可されたリンクドメインに関してはこちらをご覧ください。