此页面由 Cloud Translation API 翻译。

符合隐私权的应用归因

摘要

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

Android 应用

范围

通过所有 Google Ads 广告系列促成的应用安装和应用互动

背景

根据 Google 的政策，目前无法使用 Android 广告 ID 跟踪已选择停用广告个性化功能的 Android 用户。不过，Google 会使用 gclid，这是一个不会随设备保留的点击跟踪网址参数。此外，在未征得用户级同意的其他情况下，Google 可能会使用 gbraid（一种聚合点击跟踪网址参数）。

指南

应用转化跟踪和再营销 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

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

如果深层链接促成了应用会话，请从引荐来源网址中解析 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 时，必须将 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
       &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 值，以及引荐来源网址中的 gclid 和 gbraid 值，并将它们存储在设备上或以第一方标识符键控的方式存储在服务器端。每个值应存储 180 天，或直到被另一个较新的值取代为止。然后，应通过 market_referrer_gclid 转化请求字段传递安装引荐来源网址 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 还是深层链接引荐网址获取，最新的 gbraid 值都应始终作为 gbraid 传递。

iOS 应用

范围

通过 Google Ads 搜索广告系列、购物广告系列、iOS 应用安装广告系列 (ACi) 和深层链接促成的应用互动

背景

根据 Apple 的 ATT 政策，无法使用广告标识符 (IDFA) 跟踪未选择启用应用跟踪功能的 iOS14.5 及以上版本的用户。不过，Google 会使用 gbraid，这是一个聚合点击跟踪网址参数。此外，在未征得用户级同意的其他情况下，Google 可能会使用 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
       &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 值应全部为零（因为用户未同意）。此外，还必须将 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
       &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

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

符合隐私权的应用归因 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

摘要

Android 应用

范围

背景

指南

支持的场景

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

有可用的广告 ID

示例：首次打开

示例：会话和应用事件

没有可用的广告 ID

示例：首次打开

示例：会话和应用事件

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

有可用的广告 ID

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

没有可用的广告 ID

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

支持的场景：安装 + 互动

有可用的广告 ID

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

没有可用的广告 ID

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

iOS 应用

范围

背景

指南

支持的场景

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

有可用的 IDFA

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

没有可用的 IDFA

示例：深层链接会话

示例：应用事件

示例：后续/自然会话

符合隐私权的应用归因