Trang này được dịch bởi Cloud Translation API.

Phân bổ ứng dụng tuân thủ quyền riêng tư

Tóm tắt

Người dùng API tận dụng tính năng Theo dõi lượt chuyển đổi trong ứng dụng và API Tiếp thị lại của Google Ads để trực tiếp chuyển đổi các lượt chuyển đổi trong ứng dụng phải làm theo hướng dẫn sau đây của Android & iOS. Điều này sẽ đảm bảo rằng số lượt nhấp của những người dùng chọn không sử dụng tính năng theo dõi quảng cáo hoặc cá nhân hóa quảng cáo chỉ được tính cho những quy trình tuân thủ quyền riêng tư. Vui lòng tham khảo Yêu cầu và amp; Thông số kỹ thuật của phản hồi Tổng quan để biết thêm thông tin về định nghĩa thông số và các giá trị dự kiến.

Ứng dụng Android

Phạm vi

&Cài đặt ứng dụng & AMP; Tương tác với ứng dụng thông qua tất cả các chiến dịch trên Google Ads

Thông tin khái quát

Hiện tại, người dùng Android đã chọn không cá nhân hóa quảng cáo sẽ không thể theo dõi bằng cách sử dụng Mã nhận dạng cho quảng cáo trên Android (theo chính sách của Google). Thay vào đó, Google sử dụng gclid, một tham số url nhấp chuột không tồn tại với thiết bị.

Cách thức

Người dùng API theo dõi lượt chuyển đổi và tiếp thị lại ứng dụng phải đảm bảo rằng gclid được lưu trữ và chuyển chính xác.

Các trường hợp được hỗ trợ

Trường hợp được hỗ trợ: Số lượt cài đặt (người dùng chưa cài đặt ứng dụng trước đó)

Khi lượt cài đặt ứng dụng được thúc đẩy bởi một đường liên kết sâu chuyển hướng đến cửa hàng Google Play và người dùng sẽ mở ứng dụng đó lần đầu tiên, hãy phân tích cú pháp giá trị gclid từ trường API Play Install Referrer install_referrer và lưu trữ giá trị đó trên thiết bị hoặc phía máy chủ được mã hoá bằng giá trị nhận dạng của bên thứ nhất. gclid này phải được lưu trữ trong 180 ngày hoặc cho đến khi có một Liên kết giới thiệu cài đặt khác gần đây hơn gclid thay thế. gclid có thể được chuyển qua market_referrer_gclid yêu cầu chuyển đổi

Có mã nhận dạng cho quảng cáo

Khi có mã nhận dạng cho quảng cáo trên Android, bạn phải gửi market_referrer_gclid cùng với sự kiện first_open tương ứng. Bạn có thể gửi market_referrer_gclid qua các phiên bản (ampstream) và sự kiện ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.).

Ví dụ: Mở lần đầu

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

Ví dụ: Sự kiện trong phiên và ứng dụng

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

Mã nhận dạng cho quảng cáo KHÔNG có sẵn

Khi KHÔNG có mã nhận dạng cho quảng cáo Android, bạn bắt buộc phải gửi market_referrer_gclid market_referrer_gclid với sự kiện first_open tương ứng và ALL phiên bản xuôi dòng và sự kiện ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.) cùng với trường/giá trị bổ sung gclid_only_request=1. Lưu ý: Giá trị rdid phải là tất cả số 0 (vì người dùng không đồng ý).

Ví dụ: Mở lần đầu

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

Ví dụ: Phiên & Sự kiện ứng dụng

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

Trường hợp được hỗ trợ: Tương tác với ứng dụng (người dùng đã cài đặt ứng dụng)

Khi một phiên hoạt động trong ứng dụng do đường liên kết sâu điều khiển, hãy phân tích cú pháp giá trị gclid và lưu trữ giá trị đó trên thiết bị hoặc khóa phía máy chủ bằng giá trị nhận dạng của bên thứ nhất.
gclid phải được lưu trữ trong 180 ngày hoặc cho đến khi có một gclid khác gần đây thay thế. Sau đó, giá trị này có thể được chuyển qua trường yêu cầu chuyển đổi gclid.

Có mã nhận dạng cho quảng cáo

Khi mã nhận dạng cho quảng cáo của Android hoạt động, bạn phải gửi gclid cùng với sự kiện session_start tương ứng. Bạn có thể gửi gclid cùng với các sự kiện trong ứng dụng (ví dụ: add_to_cart, in_app_purchase, v.v.). gclid sẽ KHÔNG được chuyển với các sự kiện session_start tiếp theo.

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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

Mã nhận dạng cho quảng cáo KHÔNG có sẵn

Khi ID quảng cáo trên Android KHÔNG có sẵn, bạn phải gửi gclid cùng với sự kiện session_start tương ứng và TẤT CẢ các phiên tiếp theo và sự kiện ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.). Lưu ý: Giá trị rdid phải bằng 0 (vì người dùng đã chọn không sử dụng tính năng cá nhân hóa quảng cáo).

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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

Tình huống được hỗ trợ: Lượt cài đặt + Lượt tương tác

Khi lượt cài đặt ứng dụng do một đường liên kết sâu đến cửa hàng Google Play thúc đẩy, sau đó là một phiên ứng dụng do đường liên kết sâu đưa đến ứng dụng, hãy phân tích cú pháp cả giá trị API Play Install Referrer gclid và đường liên kết sâu gclid rồi lưu trữ trên thiết bị hoặc phía máy chủ bằng khoá nhận dạng của bên thứ nhất. Các giá trị gclid này nên được lưu trữ trong 180 ngày hoặc cho đến khi một đường liên kết sâu khác gần đây gclid thay thế đường liên kết sâu hiện có gclid, hoặc một API Play Install Referrer gclid thay thế cho Play Install Referrer API gclid. Bạn nên chuyển API giới thiệu Play Install gclid qua market_referrer_gclid field, VÀ đường liên kết sâu gclid sẽ được chuyển qua trường gclid.

Có mã nhận dạng cho quảng cáo

Khi mã nhận dạng cho quảng cáo của Android có sẵn, cả market_referrer_gclid và gclid đều phải được gửi cùng với sự kiện session_start và sự kiện ứng dụng tương ứng (tức là add_to_cart, in_app_purchase, v.v.). Đối với các sự kiện session_start xuôi dòng, hãy truyền market_referrer_gclid, nhưng (đường liên kết sâu) gclid sẽ không được truyền.

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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

Mã nhận dạng cho quảng cáo KHÔNG có sẵn

Khi KHÔNG có mã nhận dạng cho quảng cáo trên Android, cả market_referrer_gclid và gclid đều phải được gửi theo sự kiện session_start tương ứng, cũng như TẤT CẢ sự kiện tiếp theo và sự kiện ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.). Lưu ý: Giá trị rdid phải bằng 0 (vì người dùng đã chọn không sử dụng tính năng cá nhân hóa quảng cáo).

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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

Lưu ý quan trọng: API Play Install Referrer gclid (được chuyển dưới dạng market_referrer_gclid) và đường liên kết sâu gclid (được chuyển dưới dạng gclid) là hai nguồn riêng biệt cho gclid và không nên dùng thay thế cho nhau. Xin lưu ý rằng các giá trị gclid này nên được lưu trữ trong 180 ngày hoặc cho đến khi một đường liên kết sâu khác gần đây hơn gclid thay thế đường liên kết sâu hiện có gclid, hoặc một API Play Install Referrer gclid hiện có sẽ thay thế API Install Referrer hiện có gclid.

Ứng dụng iOS

Phạm vi

Mức độ tương tác với ứng dụng thông qua Google Ads trên mạng Tìm kiếm, Google Mua sắm và & iOS ACi + Liên kết sâu

Thông tin khái quát

Người dùng iOS 14.5 trở lên chưa chọn theo dõi ứng dụng không thể được theo dõi bằng IDFA (theo chính sách ATT của Apple). Thay vào đó, Google sử dụng gbraid, một tham số url nhấp chuột tổng hợp.

Cách thức

API theo dõi lượt chuyển đổi và tiếp thị lại ứng dụng người tiêu dùng phải đảm bảo rằng tất cả các thông số lượt nhấp đều được chuyển chính xác, bao gồm gclid và gbraid.

Các trường hợp được hỗ trợ

Trường hợp được hỗ trợ: Tương tác với ứng dụng (người dùng đã cài đặt ứng dụng)

Khi một phiên hoạt động trong ứng dụng do một đường liên kết sâu thúc đẩy, hãy phân tích cú pháp các giá trị gclid và gbraid rồi lưu trữ các giá trị đó trên thiết bị hoặc khóa phía máy chủ bằng giá trị nhận dạng của bên thứ nhất. Những giá trị này phải được lưu trữ trong 180 ngày hoặc cho đến khi được thay thế bằng một giá trị mới hơn. Sau đó, giá trị gclid có thể được chuyển qua trường yêu cầu chuyển đổi gclid và giá trị gbraid sau đó có thể được chuyển qua trường yêu cầu chuyển đổi gbraid.

Có thể sử dụng IDFA

Khi IDFA có sẵn, cả gclid VÀ gbraid đều phải được gửi cùng với sự kiện session_start tương ứng, cùng với trường/giá trị bổ sung, app_open_source=ad_click. Bạn có thể gửi gclid và gbraid với các phiên thấp hơn và amp; sự kiện ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.). Đối với các phiên tiếp theo, hãy thêm trường/giá trị bổ sung, app_open_source=organic.

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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 KHÔNG có sẵn

Khi IDFA không có sẵn, gbraid bắt buộc phải được gửi cùng với sự kiện session_start tương ứng cùng với trường/giá trị bổ sung, app_open_source=ad_click. và TẤT CẢ các sự kiện sau này của ứng dụng (ví dụ: add_to_cart, in_app_purchase, v.v.). Lưu ý: Trường gclid phải được bỏ qua và giá trị rdid phải bằng 0 (vì người dùng không đồng ý). gbraid là ALSO bắt buộc phải được gửi cùng với các phiên thấp hơn và amp; sự kiện tương ứng trong ứng dụng (ví dụ: session_start, add_to_cart, in_app_purchase, v.v.). Đối với các phiên xuôi dòng tiếp theo, hãy thêm trường/giá trị bổ sung app_open_source=organic.

Ví dụ: Phiên liên kết sâu

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

Ví dụ: Sự kiện ứng dụng

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

Ví dụ: Phiên tiếp theo/Không phải trả tiền

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

Lưu ý: Bạn không thể tận dụng gbraid trong các trường hợp Cài đặt vì người dùng được chuyển hướng sang iTunes lần đầu tiên.