遵循隱私權應用程式歸因

摘要

使用 Google Ads 應用程式轉換追蹤和再行銷 API 直接傳送應用程式轉換的 API 消費者,必須遵守下列 AndroidiOS 指南。如此可確保使用者選擇退出廣告追蹤或廣告個人化後,只會根據符合隱私權法規的工作流程進行歸因。如要進一步瞭解參數定義和預期值,請參閱「要求與回應規格」總覽

Android 應用程式

範圍

應用程式安裝 (含所有 Google Ads 廣告活動的應用程式參與)

背景資訊

根據 Google 政策規定,目前停用廣告個人化設定的 Android 使用者無法使用 Android 廣告 ID 進行追蹤。而是使用 gclid,這是不會與裝置保留的點擊網址參數。

指南

App Conversion Tracking and Remarketing API 消費者必須正確儲存及傳遞 gclid

支援的情境

支援的情境:安裝 (使用者先前並未安裝應用程式)

如果應用程式安裝是由重新導向到 Google Play 商店的深層連結產生,而使用者初次開啟應用程式,請從 Play Install Referrer APIinstall_referrer 欄位剖析 gclid 值,然後儲存在裝置或第一方金鑰的伺服器端 ID 上。此 gclid 的存放區應儲存 180 天,或直到最近才存在的 Play 安裝參照網址 gclid 替換成其他 gclid。您可以透過 market_referrer_gclid 轉換要求欄位傳遞這個 gclid

有可用的廣告 ID

如果可使用 Android 廣告 ID,就必須傳送 market_referrer_gclid 和對應的 first_open 事件。market_referrer_gclid 可以隨著下游工作階段和應用程式事件傳送 (例如 session_startadd_to_cartin_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_startadd_to_cartin_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 值,並將值儲存在裝置或伺服器端 ID 的第一方 ID 中。
gclid 應儲存 180 天,或是等到另一個最近的gclid取代。然後透過 gclid 轉換要求欄位傳遞這個值。

有可用的廣告 ID

如果可使用 Android 廣告 ID,就必須傳送 gclid 和對應的 session_start 事件。gclid 可以隨著應用程式事件(例如 add_to_cartin_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_startadd_to_cartin_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 Referrer API gclid 和深層連結 gclid 值,並將這些值儲存在第一方 ID 對應的裝置或伺服器端上。這些 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_gclidgclid 都必須傳送對應的 session_start 事件和應用程式事件 (例如 add_to_cartin_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_gclidgclid 都必須傳送對應的 session_start 事件,以及所有下游工作階段和應用程式事件 (例如 session_startadd_to_cartin_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 Ads 搜尋、購物和深層連結參與應用程式參與度

背景資訊

凡是未選擇採用應用程式追蹤的 iOS14.5 以上版本使用者,均無法透過 Apple 的 ATT 政策追蹤。而是採用 gbraid (匯總點擊網址參數)。

指南

App Conversion Tracking and Remarketing API (消費者轉換追蹤和再行銷 API) 的消費者必須確保所有點擊參數都正確傳遞,包括 gclidgbraid

支援的情境

支援的情境:應用程式參與度 (使用者已安裝應用程式)

當應用程式工作階段受到深層連結驅動時,請剖析 gclidgbraid 值,然後將值儲存至裝置或伺服器端 ID 指定的第一方 ID。這些值的儲存時間應為 180 天,或是替換成較新的值。系統隨後可透過 gclid 轉換要求欄位傳遞 gclid 值,接著即可透過 gbraid 轉換要求欄位傳遞 gbraid 值。

廣告識別碼可用

如果可使用廣告識別碼,則必須傳送 gclidgbraid 這兩種,連同對應的 session_start 事件和其他欄位/值 app_open_source=ad_clickgclidgbraid 可以隨著下游工作階段 &應用程式事件傳送 (例如 session_startadd_to_cartin_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 不可用gbraid 必須隨對應的 session_start 事件和其他欄位/值 app_open_source=ad_click 一起傳送。和所有下游應用程式事件 (例如 add_to_cartin_app_purchase 等)。注意gclid 欄位應省略,rdid 值則應為零 (因為使用者尚未同意)。 gbraid必須 ALSO 才能透過下游工作階段和相對應的應用程式事件傳送 (例如 session_startadd_to_cartin_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