摘要
使用 Google Ads 應用程式轉換追蹤和再行銷 API 直接傳送應用程式轉換的 API 消費者,必須遵守下列 Android 和 iOS 指南。如此可確保使用者選擇退出廣告追蹤或廣告個人化後,只會根據符合隱私權法規的工作流程進行歸因。如要進一步瞭解參數定義和預期值,請參閱「要求與回應規格」總覽。
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_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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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_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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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_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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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) 的消費者必須確保所有點擊參數都正確傳遞,包括 gclid
和 gbraid
。
支援的情境
支援的情境:應用程式參與度 (使用者已安裝應用程式)
當應用程式工作階段受到深層連結驅動時,請剖析 gclid
和 gbraid
值,然後將值儲存至裝置或伺服器端 ID 指定的第一方 ID。這些值的儲存時間應為 180 天,或是替換成較新的值。系統隨後可透過 gclid
轉換要求欄位傳遞 gclid
值,接著即可透過 gbraid
轉換要求欄位傳遞 gbraid
值。
廣告識別碼可用
如果可使用廣告識別碼,則必須傳送 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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=BX3QojHp4mY5MrJtFM_d1u &app_open_source=organic
廣告識別碼不適用
如果 IDFA 不可用,gbraid
必須隨對應的 session_start
事件和其他欄位/值 app_open_source=ad_click
一起傳送。和所有下游應用程式事件 (例如 add_to_cart
、in_app_purchase
等)。注意:gclid
欄位應省略,rdid
值則應為零 (因為使用者尚未同意)。
gbraid
必須 ALSO 才能透過下游工作階段和相對應的應用程式事件傳送 (例如 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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=organic