プライバシーに配慮したアプリ アトリビューション

概要

Google 広告の App Conversion Tracking and Remarketing API を使ってアプリ コンバージョンの直接受け渡しを行っている API 利用者の方は、以下の Android および iOS 向けガイダンスに従ってください。これにより、広告トラッキングや広告のパーソナライズからオプトアウトしているユーザーのクリックに対しては、アトリビューションをプライバシー対応のワークフローでのみ行うようにすることができます。パラメータの定義と想定される値について詳しくは、リクエストとレスポンスの仕様の概要をご覧ください。

Android アプリ

範囲

Google 広告のキャンペーン（全種類）を介したアプリ インストールおよびアプリ エンゲージメント

背景

広告のパーソナライズからオプトアウトしている Android ユーザーは、現在（Google のポリシーにより）Android の広告 ID を使ってトラッキングすることができません。Google は代わりに、持続的なデバイス識別情報とはならないクリック URL パラメータである gclid を利用します。また、ユーザー単位の同意が得られていない他のシナリオでも、Google は集約型のクリック URL パラメータである gbraid を使用することがあります。

ガイダンス

App Conversion Tracking and Remarketing API をご利用の場合は、gclid と gbraid の保存と受け渡しを確実に正しく行う必要があります。

サポートされているシナリオ

サポートされるシナリオ: インストール（ユーザーがまだアプリをインストールしていない）

Google Play ストアへのリダイレクトを行うディープリンクによるインストール後、ユーザーがアプリを初めて起動した際に、Play Install Referrer API の install_referrer フィールドの gclid 値をパースし、ファーストパーティ識別子によるキーを付けて、デバイスまたはサーバーサイドに保存します。各値は、180 日経過するか、別の（より新しい）値によって置換されるまで保存する必要があります。gclid 値は market_referrer_gclid コンバージョン リクエスト フィールドを介して受け渡す必要があります。

広告 ID が利用できる場合

Android の広告 ID が利用できる場合、market_referrer_gclid を、対応する first_open イベントとすべてのダウンストリーム セッションおよびアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに送信する必要があります。

例: 初回起動

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

例: セッションとアプリイベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

広告 ID が利用できない場合

Android の広告 ID が利用できない場合、market_referrer_gclid を、対応する first_open イベントとすべてのダウンストリーム セッションおよびアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに、追加のフィールド/値 gclid_only_request=1 と合わせて送信することが必須となります。注: rdid の値はすべてゼロにする必要があります（ユーザーが同意していないため）。

例: 初回起動

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

例: セッションとアプリイベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

サポートされるシナリオ: アプリ エンゲージメント（ユーザーがアプリをインストール済み）

ディープリンクによるアプリ セッションが発生した際に、リファラー URL から gclid および gbraid の値をパースし、ファーストパーティ識別子によるキーを付けて、デバイスまたはサーバーサイドに保存します。各値は、180 日経過するか、別の（より新しい）値によって置換されるまで保存する必要があります。ディープリンクの gclid 値は gclid コンバージョン リクエスト フィールドを介して、ディープリンクの gbraid 値は gbraid コンバージョン リクエスト フィールドを介して受け渡す必要があります。

広告 ID が利用できる場合

Android の広告 ID が利用できる場合、gclid と gbraid を、対応する session_start イベントとすべてのダウンストリーム セッションおよびアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに送信する必要があります。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: アプリ内イベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

広告 ID が利用できない場合

Android の広告 ID が利用できない場合、対応する session_start イベントとすべてのダウンストリーム セッションおよびアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに gclid を送信することが必須となります。注: rdid の値はすべてゼロにする必要があります（ユーザーが広告のパーソナライズからオプトアウトしているため）。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: アプリ内イベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

サポートされるシナリオ: インストール + エンゲージメント

Google Play ストアへのディープリンクによるインストール後、ディープリンクによるアプリ セッションが発生した際に、Play Install Referrer API の install_referrer フィールドの gclid 値と、リファラー URL の gclid および gbraid の両方の値をパースし、ファーストパーティ識別子によるキーを付けて、デバイスまたはサーバーサイドに保存します。各値は、180 日経過するか、別の（より新しい）値によって置換されるまで保存する必要があります。インストール リファラーの gclid 値は market_referrer_gclid コンバージョン リクエスト フィールドを介して、ディープリンクの gclid 値は gclid コンバージョン リクエスト フィールドを介して、ディープリンクの gbraid 値は gbraid コンバージョン リクエスト フィールドを介して受け渡す必要があります。

広告 ID が利用できる場合

Android の広告 ID が利用できる場合、market_referrer_gclid と gclid の両方を、対応する session_start イベントおよびアプリイベント（add_to_cart、in_app_purchase など）とともに送信する必要があります。ダウンストリームの session_start イベントについては、market_referrer_gclid は受け渡し、かつ（ディープリンクの）gclid は受け渡さないようにする必要があります。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: アプリ内イベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       <&gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

広告 ID が利用できない場合

Android の広告 ID が利用できない場合、market_referrer_gclid と gclid の両方を、対応する session_start イベントとすべてのダウンストリーム セッションおよびアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに送信する必要があります。注: rdid の値はすべてゼロにする必要があります（ユーザーが広告のパーソナライズからオプトアウトしているため）。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: アプリ内イベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

重要: Play Install Referrer API の gclid（market_referrer_gclid として受け渡し）とディープリンクの gclid（gclid として受け渡し）は、gclid 値のソースとして別個のものであり、混同するべきではありません。なお前述のとおり、これらの gclid 値は、180 日経過するか、ディープリンクの gclid が別の（より新しい）ディープリンク gclid 値によって置換されるか、Play Install Referrer API 由来の gclid が別の Play Install Referrer API 由来の gclid 値によって置換されるまで、保存する必要があります。逆に、Play Install Referrer API またはディープリンク リファラー URL を使用して取得されたかどうかにかかわらず、最新の gbraid 値は常に gbraid として渡す必要があります。

iOS アプリ

範囲

Google 広告の検索キャンペーン、ショッピング キャンペーン、iOS 向け ACi キャンペーン + ディープリンクを介したアプリ エンゲージメント

背景

アプリ トラッキングにオプトインしていない iOS 14.5 以上のユーザーは、（Apple の ATT ポリシーにより）IDFA を使ってトラッキングすることができません。Google は代わりに、集約型のクリック URL パラメータである gbraid を利用します。また、ユーザー単位の同意が得られていない他のシナリオでも gbraid が使用されることがあります。

ガイダンス

App Conversion Tracking and Remarketing API をご利用の場合は、すべてのクリック パラメータ（gclid、gbraid などを含む）の受け渡しを確実に正しく行う必要があります。

サポートされているシナリオ

サポートされるシナリオ: アプリ エンゲージメント（ユーザーがアプリをインストール済み）

ディープリンクによるアプリ セッションが発生した際に、リファラー URL から gclid および gbraid の値をパースし、ファーストパーティ識別子によるキーを付けて、デバイスまたはサーバーサイドに保存します。各値は、180 日経過するか、別の（より新しい）値によって置換されるまで保存する必要があります。gclid 値は gclid コンバージョン リクエスト フィールドを介して、gbraid 値は gbraid コンバージョン リクエスト フィールドを介して受け渡す必要があります。

IDFA が利用できる場合

IDFA が利用できる場合、gclid と gbraid の両方を、対応する session_start イベントとともに、追加のフィールド/値 app_open_source=ad_click と合わせて送信する必要があります。gclid と gbraid は、ダウンストリームのセッションやアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに送信することも必須となります。後続のダウンストリーム セッションでは、追加のフィールド/値 app_open_source=organic と合わせて送信します。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
       

例: アプリイベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
       

IDFA が利用できない場合

IDFA が利用できない場合、gbraid を、対応する session_start イベントとともに、追加のフィールド/値 app_open_source=ad_click と合わせて送信することが必須となります。すべてのダウンストリーム アプリイベント（add_to_cart、in_app_purchase など）。注: gclid フィールドは省略し、rdid の値はすべてゼロにする必要があります（ユーザーが同意していないため）。ダウンストリームのセッションおよび対応するアプリイベント（session_start、add_to_cart、in_app_purchase など）とともに gbraid を送信することも必須となります。後続のダウンストリーム セッションでは、追加のフィールド/値 app_open_source=organic と合わせて送信します。

例: ディープリンク セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click

例: アプリイベント

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       

例: 後続のセッション/オーガニック セッション

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
       

注: インストール型のシナリオにおいては、ユーザーはまず iTunes にリダイレクトされるため、gbraid を活用できません。