遵循隱私權應用程式歸因功能

摘要

如果 API 消費者使用 Google Ads 的應用程式轉換追蹤和再行銷 API 直接傳遞應用程式轉換，請按照下列 Android 和 iOS 指南操作。這樣一來，系統只會使用符合隱私權規定的工作流程，將選擇停用廣告追蹤或廣告個人化的使用者點擊歸因。如需參數定義和預期值的相關資訊，請參閱「要求與回應規格」總覽。

Android 應用程式

範圍

透過所有 Google Ads 廣告活動宣傳應用程式安裝次數和參與度

背景

根據 Google 政策，如果 Android 使用者停用廣告個人化功能，就無法使用 Android 廣告 ID 追蹤。Google 會改用 gclid，這個點擊網址參數不會保留在裝置上。此外，如果未徵得使用者層級同意聲明，Google 也可能會在其他情況下使用 gbraid (匯總點擊網址參數)。

指引

應用程式轉換追蹤和再行銷 API 消費者必須確保正確儲存及傳遞 gclid 和 gbraid。

支援的情境

支援情境：安裝 (使用者先前未安裝過應用程式)

如果應用程式安裝是透過重新導向至 Google Play 商店的深層連結促成，且使用者首次開啟應用程式，請從 Play Install Referrer API 的 install_referrer 欄位剖析 gclid 值，並以第一方 ID 為鍵，將該值儲存在裝置或伺服器端。每個值應儲存 180 天，或直到被較新的值取代為止。gclid 值應透過 market_referrer_gclid 轉換要求欄位傳遞。

廣告 ID 可用

如果可以使用 Android 廣告 ID，則必須在傳送相應的 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
       &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 值，並以第一方 ID 為鍵，將這些值儲存在裝置或伺服器端。每個值應儲存 180 天，或直到被較新的值取代為止。深層連結 gclid 值應透過 gclid 轉換要求欄位傳遞，深層連結 gbraid 值應透過 gbraid 轉換要求欄位傳遞。

廣告 ID 可用

如果可以使用 Android 廣告 ID，則必須在相應的 session_start 事件和所有下游工作階段與應用程式事件 (即 session_start、add_to_cart、in_app_purchase 等) 中，一併傳送 gclid 和 gbraid。

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 安裝參照網址 API install_referrer 欄位中的 gclid 值，以及參照網址中的 gclid 和 gbraid 值，然後以第一方 ID 為鍵，將這些值儲存在裝置或伺服器端。每個值應儲存 180 天，或直到被較新的值取代為止。然後，安裝推薦連結 gclid 值應透過 market_referrer_gclid 轉換要求欄位傳遞，深層連結 gclid 值應透過 gclid 轉換要求欄位傳遞，深層連結 gbraid 值應透過 gbraid 轉換要求欄位傳遞。

廣告 ID 可用

如果可以使用 Android 廣告 ID，則必須在傳送相應的 session_start 事件和應用程式事件 (即 add_to_cart、in_app_purchase 等) 時，一併傳送 market_referrer_gclid 和 gclid。如果是下游 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 無法使用時，必須在傳送相應的 session_start 事件時，一併傳送 market_referrer_gclid 和 gclid，且所有下游工作階段和應用程式事件 (即 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

iOS 應用程式

範圍

透過 Google Ads 搜尋、購物和 iOS 應用程式安裝廣告活動 + 深層連結，提高應用程式參與度

背景

根據 Apple 的應用程式追蹤透明度 (ATT) 政策，如果 iOS 14.5 以上版本的使用者未選擇啟用應用程式追蹤，就無法使用廣告識別碼追蹤他們。Google 會改用 gbraid，這是匯總點擊網址參數。此外，如果未徵得使用者層級同意聲明，Google 也可能在其他情況下使用 gbraid。

指引

應用程式轉換追蹤和再行銷 API 消費者必須確保所有點擊參數都已正確傳遞，包括 gclid 和 gbraid。

支援的情境

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

如果應用程式工作階段是由深層連結啟動，請從參照網址剖析 gclid 和 gbraid 值，並以第一方 ID 為鍵，將這些值儲存在裝置或伺服器端。每個值應儲存 180 天，或直到被較新的值取代為止。gclid 值應透過 gclid 轉換要求欄位傳遞，gbraid 值應透過 gbraid 轉換要求欄位傳遞。

廣告識別碼可用

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
廣告識別碼無法使用

無法使用廣告識別碼時，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