此页面由 Cloud Translation API 翻译。

符合隐私权的应用归因政策

总结

使用 Google Ads 的应用转化跟踪和再营销 API 直接传递应用转化数据的 API 使用方应遵循以下 Android 和 iOS 指南。这样可以确保选择停用广告跟踪或广告个性化功能的用户获得的点击仅能通过符合隐私权的工作流程进行归因。如需详细了解参数定义和预期值，请参阅请求与响应规范概览。

Android 应用

范围

通过所有 Google Ads 广告系列实现应用安装与应用互动

背景

目前，无法使用 Android 广告 ID 跟踪已选择停用广告个性化功能的 Android 用户（根据 Google 的政策）。不过，Google 会使用 gclid（一个不会随设备保留的点击网址参数）。

指南

应用转化跟踪和再营销 API 使用方必须确保正确存储和传递 gclid。

支持的场景

支持的场景：安装（用户之前未安装应用）

当应用安装由重定向到 Google Play 商店的深层链接驱动时，当用户首次打开应用时，从 Play Install Referrer API install_referrer 字段中解析 gclid 值，并将其存储在由第一方标识符键控的设备或服务器端。此 gclid 应存储 180 天，或者直到另一个较新的 Play 安装引荐来源网址 gclid 取代它为止。此 gclid 可通过 market_referrer_gclid 转化请求字段传递。

有广告 ID

当 Android 广告 ID 可用时，必须将 market_referrer_gclid 与相应的 first_open 事件一起发送。可通过下游会话和应用事件（即 session_start、add_to_cart、in_app_purchase 等）发送 market_referrer_gclid。

示例：首次打开

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 不可用时，必须随相应的 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 等）一起发送。gclid 不应与下游 session_start 事件一起传递。

示例：深层链接会话

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 不可用时，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 &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 Refererr API gclid 和深层链接 gclid 值，并将其存储在由第一方标识符键控的设备或服务器端。这些 gclid 值应存储 180 天，或直到另一个最近的深层链接 gclid 替换现有的深层链接 gclid 或 Play Install Referrer API gclid 替换现有的 Play Install Referrer API gclid。Play InstallReferrer 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

重要提示：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 为止。

iOS 应用

范围

通过 Google Ads 搜索广告、购物广告和 iOS 应用安装量 + 深层链接实现应用互动

背景

iOS 14.5 及更高版本的用户无法使用 IDFA 进行跟踪（根据 Apple 的 ATT 政策）。而是会使用聚合点击网址参数 gbraid。

指南

应用转化跟踪和再营销 API 使用方必须确保正确传递所有点击参数，包括 gclid 和 gbraid。

支持的场景

支持的场景：应用互动（用户已经安装应用）

当应用会话由深层链接驱动时，请解析 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 &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 不可用时，必须随相应的 session_start 事件以及其他字段/值 app_open_source=ad_click 一起发送。和所有下游应用事件（即 add_to_cart、in_app_purchase 等）。注意：gclid 字段应省略，且 rdid 值必须为全零（因为用户未同意）。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=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

注意：gbraid 不能在安装场景中使用，因为用户首先会被重定向到 iTunes。