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

まとめ

Google 広告のアプリ コンバージョン トラッキングと Remarketing API を使用してアプリ コンバージョンを直接渡す API コンシューマは、Android および iOS 向けのガイダンスに従ってください。これにより、広告トラッキングや広告のパーソナライズを無効にしているユーザーのクリックは、プライバシーに配慮したワークフローでのみ関連付けられます。パラメータ定義と期待値に関する追加情報については、リクエストとレスポンスの仕様の概要をご覧ください。

Android アプリ

範囲

アプリのインストール数（すべての Google 広告キャンペーンを通じたアプリ エンゲージメント）

背景

現時点では、広告のパーソナライズを無効にしている Android ユーザーは、Google のポリシーに基づき Android 広告 ID を使用してトラッキングすることはできません。代わりに、gclid を利用します。これは、デバイスに保持されないクリック URL パラメータです。

ガイダンス

アプリ コンバージョン トラッキングと Remarketing API のコンシューマは、gclid が正しく保存され、渡されていることを確認する必要があります。

サポートされるシナリオ

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

アプリのインストールが、Google Play ストアにリダイレクトするディープリンクによって促進され、ユーザーが最初にそのアプリを開いた場合は、Play Install Referrer API install_referrer フィールドの gclid 値を解析し、デバイスまたはサーバー側の識別子（ファーストパーティ識別子）に保存します。この gclid は 180 日間保存するか、別の新しい Play インストール リファラー gclid に置き換わるまで保存する必要があります。この gclid は、market_referrer_gclid コンバージョン リクエスト フィールドを介して渡すことができます。

広告 ID を利用できます

Android 広告 ID が利用可能な場合、対応する first_open イベントで market_referrer_gclid を送信する必要があります。market_referrer_gclid は、ダウンストリーム セッションとアプリイベント（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
       &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
       &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
       &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
       &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

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

アプリ セッションがディープリンクによって駆動される場合は、gclid 値を解析し、その値をデバイス識別子またはサーバーサイド識別子のいずれかで保存します。
gclid は 180 日間保存するか、直近に別の gclid に置き換えるまで保存する必要があります。この値は gclid コンバージョン リクエスト フィールドを介して渡すことができます。

広告 ID を利用できます

Android 広告 ID が利用可能な場合、gclid を対応する session_start イベントとともに送信する必要があります。gclid は、アプリイベント（add_to_cart、in_app_purchase など）と一緒に送信できます。ダウンストリームの session_start イベントで 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

例: アプリイベント

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

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

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

広告 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
       &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

例: アプリイベント

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
       &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

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

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
       &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

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

アプリ インストールが Google Play ストアへのディープリンクで促進され、続いてアプリ セッションがアプリへのディープリンクによって駆動されると、Play Install Referrer API gclid とディープリンク gclid の両方の値を解析し、ファーストパーティ識別子によってデバイスまたはサーバー側でキーに格納されます。これらの gclid 値は 180 日間保存するか、別のディープリンク gclid が既存のディープリンク gclid を置き換えるか、Play Install Referrer API gclid が既存の Play Install Referrer API gclid を置き換えるまで保管する必要があります。Play Install Referrer API gclid は market_referrer_gclid field を介して渡され、かつディープリンク gclid は gclid フィールドを介して渡される必要があります。

広告 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
       &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

例: アプリイベント

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
       &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

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

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
       &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

広告 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
       &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

例: アプリイベント

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
       &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

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

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
       &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

iOS アプリ

範囲

Google 広告の検索、ショッピング、および iOS ACi + ディープリンク経由のアプリ エンゲージメント

背景

アプリ トラッキングを有効にしていない iOS 14.5 以降のユーザーは、IDFA を使用してトラッキングすることはできません（Apple の ATT ポリシーに基づく）。代わりに、Google ではクリック URL パラメータの集計である gbraid を利用しています。

ガイダンス

アプリ コンバージョン トラッキングと Remarketing API のコンシューマは、gclid と gbraid を含むすべてのクリック パラメータが正しく渡されることを確認する必要があります。

サポートされるシナリオ

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

アプリ セッションがディープリンクによって駆動される場合は、gclid と gbraid の値を解析して、その値をデバイスまたはサーバー側のキー（ファーストパーティ識別子）に格納します。これらの値は 180 日間保存するか、最新の値に置き換えるまで保存する必要があります。gclid 値は gclid コンバージョン リクエスト フィールドを介して渡され、gbraid 値は gbraid コンバージョン リクエスト フィールドを介して渡されます。

IDFA 利用可能

IDFA が利用可能な場合は、gclid と gbraid の両方を、追加の session/start イベント app_open_source=ad_click とともに、対応する session_start イベントとともに送信する必要があります。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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

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

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M

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

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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=organic