Attribution Reporting API cho phép phân bổ trên nhiều ứng dụng và web cho các nguồn và kích hoạt xảy ra trên cùng một thiết bị. Các trình duyệt, chẳng hạn như Chrome, có thể ủy quyền đăng ký cả nguồn và điều kiện kích hoạt cho Báo cáo phân bổ API dành cho Android thay vì xử lý các đăng ký đó trong trình duyệt. Điều này cho phép Android so khớp các nguồn và điều kiện kích hoạt trên cả trang web và ứng dụng.
Hướng dẫn này sẽ chỉ cho bạn cách thiết lập mô hình phân bổ trên nhiều ứng dụng và web.
Khi thiết lập mô hình phân bổ trên nhiều ứng dụng và web, bạn cũng nên làm quen với các giải pháp gỡ lỗi hiện có để đảm bảo Quá trình thiết lập có hoạt động như dự kiến không.
Đăng ký nguồn và điều kiện kích hoạt bằng hệ điều hành Android
Bạn sẽ chỉ có thể sử dụng mô hình phân bổ trên nhiều ứng dụng và web nếu Attribution API Báo cáo được bật trong cả trình duyệt và hệ điều hành Android trên cùng một trình duyệt thiết bị. Thông báo về trạng thái sẵn sàng của Attribution Reporting API trên Android thông qua tiêu đề Attribution-Reporting-Support. Tiêu đề này sẽ trả về hệ điều hành, web hoặc cả hai, tuỳ thuộc vào nội dung có trên thiết bị đó. Nếu cả hai đều như vậy sẵn có, các công nghệ quảng cáo sau đó sẽ có lựa chọn đăng ký các nguồn web và trang web kích hoạt với trình duyệt hoặc hệ điều hành.
Công nghệ quảng cáo cần quyết định xem nên đăng ký nguồn web hay điều kiện kích hoạt web với trình duyệt hoặc hệ điều hành.
- Đối với chiến dịch chỉ dành cho web, công nghệ quảng cáo vẫn có thể đăng ký cả nguồn và điều kiện kích hoạt bằng API Báo cáo phân bổ của Chrome hoặc chọn uỷ quyền cả hai cho hệ điều hành. Đối với những chiến dịch chỉ dành cho web nơi nguồn hoặc điều kiện kích hoạt có thể xảy ra trong một WebView, các công nghệ quảng cáo phải uỷ quyền cả hoạt động đăng ký nguồn và điều kiện kích hoạt cho hệ điều hành. Hãy xem phần về WebView để biết thêm thông tin.
- Công nghệ quảng cáo nên tránh đăng ký nguồn và điều kiện kích hoạt bằng cả Chrome và API Android cùng một lúc để tránh tạo thuộc tính trùng lặp .
- Hoạt động phân bổ diễn ra riêng biệt theo trình duyệt và hệ điều hành. Nếu một nguồn là đã đăng ký với trình duyệt, nhưng điều kiện kích hoạt được đăng ký với hệ điều hành, hai điều kiện kích hoạt đó không thể so khớp và ngược lại.
- Đối với các nguồn có thể dẫn đến trình kích hoạt ứng dụng hoặc web, nên dùng để công nghệ quảng cáo uỷ quyền lượt đăng ký nguồn web và điều kiện kích hoạt cho Attribution Reporting API của Android.
- Đối với những điều kiện kích hoạt có thể do các nguồn dựa trên ứng dụng thúc đẩy, công nghệ quảng cáo có thể chọn uỷ quyền đăng ký điều kiện kích hoạt web cho Android Attribution Reporting API.
- Đối với những chiến dịch mà cả nguồn và điều kiện kích hoạt đều xảy ra trong một ứng dụng, cả hai nguồn đều sẽ bạn cần đăng ký với API Báo cáo phân bổ của hệ điều hành.
Đăng ký nguồn ứng dụng và điều kiện kích hoạt web
Đối với một số chiến dịch, nguồn có thể xuất hiện trong một ứng dụng trong khi điều kiện kích hoạt sẽ xảy ra trên một trang web trong trình duyệt dành cho thiết bị di động trên cùng một thiết bị.
Ví dụ:
Một người dùng đang đọc các bài viết trong ứng dụng tin tức mà họ yêu thích. Họ thấy quảng cáo giá rẻ chuyến bay đến Paris và háo hức nhấp để đặt vé. Công nghệ quảng cáo phân phát quảng cáo trong ứng dụng tin tức đăng ký nguồn lượt nhấp bằng Attribution Reporting API của Android. Người dùng được đưa đến trang web của nhà quảng cáo trong Chrome nơi họ có thể chuyển đổi. Công nghệ quảng cáo trên trang web của nhà quảng cáo sẽ kiểm tra xem API cấp hệ điều hành có có sẵn và nó luôn sẵn có. Công nghệ quảng cáo đăng ký điều kiện kích hoạt chuyển đổi bằng cách hướng dẫn Chrome uỷ quyền đăng ký cho hệ điều hành thay vì đăng ký trực tiếp thông qua Attribution Reporting API của Chrome. Mô hình phân bổ cấp hệ điều hành Sau đó, API báo cáo có thể so khớp nguồn ứng dụng với điều kiện kích hoạt web rồi gửi đi báo cáo có liên quan.
![Quy trình phân bổ từ ứng dụng đến web](https://developers.google.cn/static/privacy-sandbox/private-advertising/attribution-reporting/cross-web-app/a2w_diagram.png?hl=vi)
Đăng ký nguồn ứng dụng:
SDK công nghệ quảng cáo trong Ứng dụng Android hằng ngày đăng ký lượt nhấp bằng cách sử dụng
registerSource()
Attribution Reporting API trên Android gửi yêu cầu đến máy chủ công nghệ quảng cáo Đã cung cấp URL cho
registerSource()
Máy chủ công nghệ quảng cáo phản hồi bằng thuộc tính Phân bổ-Báo cáo-Đăng ký để hoàn tất quá trình đăng ký nguồn
Đăng ký điều kiện kích hoạt web:
Công nghệ quảng cáo đăng ký một điều kiện kích hoạt và kiểm tra khả năng sử dụng hệ điều hành trong API Báo cáo phân bổ
ARA trên web trả về thông tin về nền tảng được hỗ trợ
Tiêu đề
OS-Trigger
yêu cầu API ARA trên web gọi API OS ARA HàmregisterWebTrigger()
Lệnh gọi đến
registerWebTrigger()
diễn ra nâng cao và nhà phát triển không cần gọi trực tiếp choregisterWebTrigger()
bằng hệ điều hànhHệ điều hành ARA sẽ tiếp quản và gửi yêu cầu tới URL máy chủ công nghệ quảng cáo do tiêu đề
Attribution-Reporting-Register-OS-Trigger
Công nghệ quảng cáo sẽ hoàn tất quá trình đăng ký điều kiện kích hoạt bằng API hệ điều hành
Hệ điều hành ARA sẽ thực hiện hoạt động phân bổ theo cùng một logic được áp dụng cho app<>thuộc tính ứng dụng và gửi cùng các báo cáo
Luồng công việc
Các bước sau đây cung cấp thêm thông tin về cách hoàn tất việc này:
Công nghệ quảng cáo của ứng dụng đăng ký nguồn bằng Attribution của Android API Báo cáo với những nội dung điều chỉnh sau:
- Để đăng ký một nguồn ứng dụng dự kiến sẽ chuyển đổi trên một trang web,
Tiêu đề phản hồi
Attribution-Reporting-Register-Source
phải bao gồm một đường liên kết web (eTLD+1) thay vì đích đến của ứng dụng.
Attribution-Reporting-Register-Source: { "web_destination": "https://advertiser.example", ... }
- Một số nhà quảng cáo có thể đang sử dụng nhiều nhà cung cấp dịch vụ đo lường (ví dụ: công cụ đo lường của bên thứ ba hoặc công cụ phân tích) bằng cách sử dụng chuỗi chuyển hướng 302. Trong một số trường hợp, Attribution Reporting API sẽ đi theo đường dẫn chuyển hướng được chỉ định trong tiêu đề Attribution-Reporting- Redirect ở chế độ nền và tại đồng thời đường dẫn chuyển hướng 302 thực thi trong nền trước đối với yêu cầu điều hướng. Các yêu cầu này sẽ chuyển đến cùng một URL và có thể dẫn đến kết quả trong các lượt đăng ký tính hai lần của nhà cung cấp dịch vụ đo lường bên thứ ba. Người nhận ngăn chặn việc đăng ký tính hai lần, công nghệ quảng cáo có thể sửa đổi hành vi chuyển hướng để gửi đăng ký API Báo cáo phân bổ đến một giải pháp thay thế URL tất định.
Để cho phép hành vi này, công nghệ quảng cáo cần thêm một tiêu đề HTTP mới khi phản hồi yêu cầu đăng ký:
- Tiêu đề là
Attribution-Reporting-Redirect-Config
- Giá trị của tiêu đề phải là Redirect-302-to-well-known
"Attribution-Reporting-Redirect-Config": "redirect-302-to-well-known"
- Tiêu đề là
Phần còn lại của quy trình đăng ký nguồn giống như quy trình chuẩn đăng ký nguồn ứng dụng với ứng dụng.
- Để đăng ký một nguồn ứng dụng dự kiến sẽ chuyển đổi trên một trang web,
Tiêu đề phản hồi
Công nghệ quảng cáo trên trang web của nhà quảng cáo đăng ký điều kiện kích hoạt bằng cách yêu cầu Chrome để uỷ quyền đăng ký cho Attribution Reporting API của Android:
Sau khi người dùng hoàn tất một lượt chuyển đổi trên trang web, công nghệ quảng cáo này sẽ tạo yêu cầu đăng ký điều kiện kích hoạt với Chrome
Bạn có thể sử dụng yêu cầu pixel hoặc
fetch()
để tạo yêu cầu đăng ký điều kiện kích hoạtChrome trả về tiêu đề của yêu cầu
Attribution-Reporting-Support
cho công nghệ quảng cáo. Nếu API được bật trên cả trình duyệt Chrome và Thiết bị Android, tiêu đề sẽ trả vềos, web
"Attribution-Reporting-Support": "os, web"
Sau đó, công nghệ quảng cáo phải yêu cầu Chrome uỷ quyền cho hệ điều hành bằng cách sử dụng Tiêu đề
Attribution-Reporting-Register-OS-Trigger
:Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
Chrome uỷ quyền đăng ký cho hệ điều hành bằng cách gọi hàm API hệ điều hành
registerWebTrigger()
- Lệnh gọi đến
registerWebTrigger()
diễn ra nâng cao, là công nghệ quảng cáo không cần gọi trực tiếp choregisterWebTrigger()
- Lệnh gọi đến
API hệ điều hành bắt đầu lệnh gọi API phụ đến URI công nghệ quảng cáo được chuyển vào từ trình duyệt
"Attribution-Reporting-Register-OS-Trigger": "https://adtech.example/register-trigger", "https://other-adtech.example/register-trigger"
Trong một số trường hợp, tiêu đề
Attribution-Reporting-Support
không có sẵn và Không thể gửi. Khi điều này xảy ra, công nghệ quảng cáo vẫn có thể đặt một lựa chọn ưu tiên để xử lý đăng ký kích hoạt bằng cách bao gồm Tiêu đềAttribution-Reporting-Info
. Khoá là nền tảng ưu tiên và các giá trị được phép làos
vàweb
. Trình duyệt sẽ sử dụng nền tảng ưu tiên và sẽ quay lại nền tảng web khi hệ điều hành không có sẵn.
Attribution-Reporting-Info: preferred-platform=os
- Để hoàn tất quá trình đăng ký điều kiện kích hoạt, điểm cuối của công nghệ quảng cáo phải phản hồi vào yêu cầu Attribution Reporting API của Android bằng cách sử dụng tiêu đề phản hồi.
Attribution-Reporting-Register-Trigger { "event_trigger_data": [{"trigger_data":"1"}], "aggregatable_trigger_data": [ {"key_piece":"0x400","source_keys":["campaignCounts"]}, {"key_piece":"0xA80","source_keys":["geoValue"]} ], ... }
- Phần còn lại của quá trình đăng ký điều kiện kích hoạt vẫn giữ nguyên.
Đăng ký một nguồn web và một điều kiện kích hoạt ứng dụng
Đối với một số chiến dịch, nguồn có thể xảy ra trên một trang web trong trình duyệt dành cho thiết bị di động trong khi điều kiện kích hoạt xảy ra trong một ứng dụng trên cùng một thiết bị.
Ví dụ:
Một người dùng đang duyệt web trên một trang web bằng trình duyệt Chrome trên điện thoại Android. Người này nhìn thấy quảng cáo về áo len của một trong những cửa hàng họ yêu thích. Họ nhấp vào quảng cáo và được đưa đến ứng dụng mà họ đã tải xuống. Công nghệ quảng cáo trên trang web nơi quảng cáo được phân phát sẽ đăng ký nguồn nhấp chuột bằng cách hướng dẫn Chrome để uỷ quyền đăng ký cho API Báo cáo phân bổ của Android thay vì bằng cách sử dụng Attribution Reporting API trên Chrome. Người dùng mua áo len ứng dụng mua sắm. Sau đó, công nghệ quảng cáo trong ứng dụng của nhà quảng cáo sẽ đăng ký điều kiện kích hoạt chuyển đổi thông qua Attribution Reporting API của Android. Cấp hệ điều hành Attribution Reporting API có thể so khớp nguồn web với điều kiện kích hoạt ứng dụng và gửi các báo cáo có liên quan.
![Quy trình phân bổ từ web đến ứng dụng](https://developers.google.cn/static/privacy-sandbox/private-advertising/attribution-reporting/cross-web-app/w2a_diagram.png?hl=vi)
Đăng ký nguồn web:
Công nghệ quảng cáo đăng ký nguồn và kiểm tra khả năng cung cấp hệ điều hành trong API Báo cáo phân bổ
ARA trên web trả về thông tin về nền tảng được hỗ trợ
Tiêu đề
OS-Source
yêu cầu API ARA trên web gọi API OS ARA HàmregisterWebSource()
Lệnh gọi đến
registerWebSource()
diễn ra ngầm và nhà phát triển có không cần gọi trực tiếp choregisterWebSource()
bằng hệ điều hànhHệ điều hành ARA sẽ tiếp quản và gửi yêu cầu tới URL máy chủ công nghệ quảng cáo được cung cấp theo tiêu đề
Attribution-Reporting-Register-OS-Source
Công nghệ quảng cáo sẽ hoàn tất việc đăng ký nguồn bằng API hệ điều hành
Đăng ký điều kiện kích hoạt ứng dụng:
SDK công nghệ quảng cáo trong ứng dụng Android trên Cửa hàng quần áo đăng ký điều kiện kích hoạt bằng hệ điều hành ARA
Attribution Reporting API trên Android gửi yêu cầu đến máy chủ công nghệ quảng cáo Đã cung cấp URL cho
registerTrigger()
Máy chủ công nghệ quảng cáo phản hồi bằng
Attribution-Reporting-Register-Trigger
để hoàn tất quá trình đăng ký điều kiện kích hoạtHệ điều hành ARA sẽ thực hiện hoạt động phân bổ theo cùng một logic được áp dụng cho app<>thuộc tính ứng dụng và gửi cùng các báo cáo
Luồng công việc
Các bước sau đây cung cấp thêm thông tin về cách hoàn tất việc này:
Công nghệ quảng cáo trên trang web của nhà xuất bản đăng ký nguồn bằng cách hướng dẫn Chrome để uỷ quyền đăng ký cho Attribution Reporting API của Android:
- Đối với trường hợp sử dụng từ web đến ứng dụng, khi đăng ký nguồn, thuộc tính
thông số nguồn phải được chỉ định trực tiếp, bằng cách sử dụng
Thẻ
attributionsrc
hoặc bằng cách sử dụng hoạt động đăng ký JavaScript - Ví dụ sau đây sử dụng thẻ
attributionsrc
để chỉ định tham số nguồn:
<img src="https://adtech.example/conversionpixel" attributionsrc="https://adtech.example/register-source?purchase=12">
- Đối với trường hợp sử dụng từ web đến ứng dụng, khi đăng ký nguồn, thuộc tính
thông số nguồn phải được chỉ định trực tiếp, bằng cách sử dụng
Thẻ
Chrome trả về tiêu đề của yêu cầu
Attribution-Reporting-Support
cho công nghệ quảng cáo. Nếu API được bật trên cả trình duyệt Chrome và thiết bị Android, tiêu đề sẽ trả vềos, web
."Attribution-Reporting-Support": "os, web"
Công nghệ quảng cáo phải yêu cầu Chrome uỷ quyền cho API cấp hệ điều hành bằng cách sử dụng Tiêu đề
Attribution-Reporting-Register-OS-Source
:- Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
- Chrome uỷ quyền đăng ký cho hệ điều hành bằng cách gọi hàm API hệ điều hành
registerWebSource()
- Lệnh gọi đến
registerWebSource()
diễn ra theo cách ẩn giấu, công nghệ quảng cáo sẽ không cần gọi trực tiếp choregisterWebSource()
- API hệ điều hành bắt đầu lệnh gọi API phụ đến URI công nghệ quảng cáo được chuyển từ trình duyệt
"Attribution-Reporting-Register-OS-Source": "https://adtech.example/register-source"
- Trong một số trường hợp, bạn sẽ không thấy tiêu đề
Attribution-Reporting-Support
. Khi điều này xảy ra, công nghệ quảng cáo vẫn có thể thiết lập một nền tảng ưu tiên để xử lý đăng ký nguồn bằng cách thêm tiêu đềAttribution-Reporting-Info
. Khoá này là nền tảng ưu tiên và các giá trị được phép làos
vàweb
. Chiến lược phát hành đĩa đơn trình duyệt sẽ sử dụng nền tảng ưu tiên (nếu có) và sẽ dự phòng để nền tảng web khi hệ điều hành không khả dụng.
Attribution-Reporting-Info: preferred-platform=os
- Để hoàn tất quá trình đăng ký nguồn, điểm cuối của công nghệ quảng cáo phải phản hồi
vào yêu cầu Attribution Reporting API của Android có tiêu đề phản hồi
Attribution-Reporting-Register-Source
. Phản hồi cũng phải chỉ định đích đến của ứng dụng trong trường đích đến.
Attribution-Reporting-Register-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
- Để hỗ trợ lệnh chuyển hướng cho lượt đăng ký nguồn, Chrome sẽ tuân theo chuyển hướng và gọi API ngữ cảnh web cho mỗi bước chuyển hướng.
- Phần còn lại của quá trình đăng ký nguồn vẫn giữ nguyên.
Công nghệ quảng cáo trong ứng dụng của nhà quảng cáo đăng ký điều kiện kích hoạt với Android API Báo cáo phân bổ:
- Đối với điều kiện kích hoạt xảy ra trong ứng dụng, ứng dụng đăng ký điều kiện kích hoạt bằng Attribution Reporting API của Android như bình thường.
Chiến dịch có cả đích đến tiềm năng trên ứng dụng và web
Thiết lập đích đến kép
- Một số chiến dịch có thể được thiết lập để chuyển đổi trong ứng dụng của nhà quảng cáo hoặc trên trang web của nhà quảng cáo, tuỳ thuộc vào nhiều yếu tố khác nhau, chẳng hạn như đã cài đặt ứng dụng.
- Trong những trường hợp này, bạn nên uỷ quyền việc đăng ký nguồn cho Hệ điều hành nếu có để có thể phân bổ nguồn chính xác bất kể vị trí kích hoạt xảy ra. Khi đăng ký nguồn với hệ điều hành, cả hai ứng dụng và đích đến trên web có thể được chỉ định trong các tham số tương ứng.
- Đích đến của ứng dụng phải nằm trong trường
destination
- Trang web đích phải nằm trong trường
web_destination
- Nhà phát triển Chrome nên lưu ý rằng trường
destination
dành cho hệ điều hành Attribution Reporting API phải là một gói ứng dụng chứ không phải là một URL.
Attribution-Reporting-Register-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", "web_destination": "https://example.advertiser" ... }
- Phần tiếp theo về báo cáo tổng thể sẽ giải thích việc sử dụng đích đến kép có thể ảnh hưởng đến độ nhiễu trong báo cáo.
Sử dụng báo cáo thô để giảm bớt dữ liệu gây nhiễu trong các báo cáo cấp sự kiện cho dữ liệu kép nguồn đích:
- Nếu cả hệ điều hành (ứng dụng) và đích đến của Web đã được chỉ định trong nguồn các báo cáo ở cấp sự kiện sẽ xác định liệu điều kiện kích hoạt có xảy ra hay không theo mặc định ở đích đến trên web hoặc đích đến của ứng dụng. Tuy nhiên, để duy trì giới hạn quyền riêng tư, độ nhiễu bổ sung sẽ được thêm vào các báo cáo này.
- Công nghệ quảng cáo có thể sử dụng trường
coarse_event_report_destinations
trong Tiêu đềAttribution-Reporting-Register-Source
để bật báo cáo tổng thể và giảm tiếng ồn. Nếu một nguồn cócoarse_event_report_destinations
trường được chỉ định giành chiến thắng phân bổ, báo cáo kết quả sẽ bao gồm cả ứng dụng và đích đến web mà không phân biệt vị trí thực sự kích hoạt nhưng ít nhiễu hơn so với các báo cáo có ứng dụng hoặc đích đến trên web được chỉ định. - Các báo cáo tổng hợp vẫn không thay đổi.
Đối với các ứng dụng sử dụng Thẻ tuỳ chỉnh của Chrome
Một số ứng dụng có thể sử dụng Thẻ tuỳ chỉnh để hiển thị nội dung trên web. Các thẻ tuỳ chỉnh hoạt động tương tự như một trang web thông thường khi đo lường trên các ứng dụng và trang web dành cho thiết bị di động.
- Đăng ký nguồn ứng dụng và điều kiện kích hoạt Thẻ tuỳ chỉnh:
- Làm theo hướng dẫn để đăng ký nguồn ứng dụng và điều kiện kích hoạt web.
- Đăng ký nguồn Thẻ tuỳ chỉnh và điều kiện kích hoạt ứng dụng:
- Làm theo hướng dẫn để đăng ký nguồn web và điều kiện kích hoạt ứng dụng.
- Đăng ký nguồn CCT và điều kiện kích hoạt CCT
- Việc này được xử lý giống như mọi thuộc tính web từ trang web này đến trang web khác trong Chrome.
Đối với ứng dụng sử dụng WebView
Một số ứng dụng có thể dùng WebView để hiện nội dung. Có nhiều trường hợp sử dụng cho WebView, chẳng hạn như hiển thị quảng cáo, lưu trữ nội dung web hoặc ứng dụng tuỳ chỉnh các tính năng phù hợp hơn với một định dạng web.
Chỉ có thể sử dụng mô hình phân bổ ở cấp hệ điều hành trong WebView. Chiến lược phát hành đĩa đơn Tiêu đề Attribution-Reporting-Support sẽ chỉ trả về hệ điều hành và chỉ khi Bạn có thể sử dụng Attribution Reporting API dành cho Android.
Khi uỷ quyền cho hệ điều hành, WebView có thể dùng
registerSource
hoặcregisterWebSource
vàregisterTrigger
hoặcregisterWebTrigger
. Phương thức nào mà WebView sử dụng được thiết lập bởi ứng dụng hiển thị WebView và được xác định trên trên cơ sở WebView.- Sự khác biệt giữa
registerSource
vàregisterWebSource
là nguồn được ghi lại làm nhà xuất bản. VớiregisterSource
, ứng dụng sẽ được ghi lại nhà xuất bản; ví dụ về thời điểm sử dụngregisterSource
là ứng dụng của nhà xuất bản cho thấy một quảng cáo hiển thị bằng WebView. BằngregisterWebSource
thì trang web lưu trữ trong WebView được ghi lại là nhà xuất bản; ví dụ về thời điểm sử dụngregisterWebSource
: một ứng dụng lưu trữ WebView và trang web đang được WebView hiển thị đang hiển thị quảng cáo.registerTrigger
vàregisterWebTrigger
hoạt động tương tự nhau. Chiến lược phát hành đĩa đơn biểu đồ trong mục số 3 trình bày chi tiết các tình huống khi một nhà phát triển ứng dụng hoặc SDK muốn định cấu hình API để sử dụngregisterSource
hoặcregisterWebSource
, vàregisterTrigger
hoặcregisterWebTrigger
.
- Sự khác biệt giữa
Theo mặc định, WebView sẽ dùng
registerSource
vàregisterWebTrigger
khi bằng cách gọi Attribution Reporting API của Android. Chế độ này liên kết các nguồn với ứng dụng và kích hoạt bằng nguồn gốc cấp cao nhất của URL trong WebView khi điều kiện kích hoạt xảy ra.- Nếu một ứng dụng yêu cầu hành vi khác, ứng dụng đó sẽ phải dùng một phương thức mới
setAttributionRegistrationBehavior trên androidx.webkit.WebViewSettingsCompat
. Phương thức này sẽ chỉ định xem WebView có nên gọi
registerWebSource()
hay không hoặcregisterWebTrigger()
thay vìregisterSource()
hoặcregisterTrigger()
.- Bạn cần đặt hành vi này cho từng WebView được khởi tạo.
- Nếu SDK công nghệ quảng cáo đang khởi động WebView, thì SDK này cần phải đặt hành vi mặc định này.
- Đối với ứng dụng muốn sử dụng
registerWebSource()
để liên kết nguồn lượt đăng ký bằng trang web trong WebView thay vì ứng dụng, thì họ phải tham gia danh sách cho phép của WebApp. Hoàn tất biểu mẫu này để tham gia danh sách cho phép. Chiến lược phát hành đĩa đơn mục đích của danh sách cho phép là giảm thiểu các cân nhắc về quyền riêng tư xung quanh thiết lập niềm tin cho ngữ cảnh web.
- Các lựa chọn cho setAttributionRegistrationBehavior
Giá trị Nội dung mô tả Ví dụ về trường hợp sử dụng APP_SOURCE_AND_WEB_TRIGGER (mặc định) Cho phép ứng dụng đăng ký nguồn ứng dụng (những nguồn có liên kết với tên gói ứng dụng) và điều kiện kích hoạt web (những điều kiện kích hoạt có liên kết với eTLD+1) qua WebView. Ứng dụng dùng WebView để phân phát quảng cáo thay vì bật tính năng duyệt web WEB_SOURCE_AND_WEB_TRIGGER Cho phép ứng dụng đăng ký nguồn web và điều kiện kích hoạt web qua WebView. Ứng dụng trình duyệt dựa trên WebView, trong đó cả lượt hiển thị quảng cáo và lượt chuyển đổi đều có thể xảy ra ở các trang web trong WebView. APP_SOURCE_AND_APP_TRIGGER Cho phép ứng dụng đăng ký nguồn ứng dụng và điều kiện kích hoạt ứng dụng qua WebView. Ứng dụng dựa trên WebView nơi lượt hiển thị quảng cáo và lượt chuyển đổi phải luôn được liên kết với ứng dụng thay vì với eTLD+1 của WebView. ĐÃ TẮT Tắt tính năng đăng ký nguồn và điều kiện kích hoạt qua WebView. - Nếu một ứng dụng yêu cầu hành vi khác, ứng dụng đó sẽ phải dùng một phương thức mới
setAttributionRegistrationBehavior trên androidx.webkit.WebViewSettingsCompat
. Phương thức này sẽ chỉ định xem WebView có nên gọi
Nguồn và lượt đăng ký điều kiện kích hoạt qua WebView
Công nghệ quảng cáo phải phản hồi các lượt đăng ký nguồn bằng cách sử dụng Tiêu đề
Attribution-Reporting-Register-OS-Source
. Dựa trên hành vi đã đặt đối với WebView, thao tác này sẽ gọiregisterSource()
hoặcregisterWebSource()
với hệ điều hành và bắt đầu lệnh gọi API phụ từ Android Attribution API báo cáo cho URI công nghệ quảng cáo.- Để hoàn tất quá trình đăng ký nguồn, điểm cuối của công nghệ quảng cáo phải phản hồi yêu cầu Attribution Reporting API của Android bằng tiêu đề phản hồi.
Attribution-Reporting-Register-OS-Source { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
Phần còn lại của quá trình đăng ký nguồn vẫn giữ nguyên.
Công nghệ quảng cáo nên phản hồi các lượt đăng ký kích hoạt bằng cách sử dụng Tiêu đề
Attribution-Reporting-Register-OS-Trigger
. Dựa trên hành vi đã đặt đối với WebView, thao tác này sẽ gọiregisterTrigger()
hoặcregisterWebTrigger()
với hệ điều hành và bắt đầu lệnh gọi API phụ từ Rb đến URI công nghệ quảng cáo.- Để hoàn tất quá trình đăng ký điều kiện kích hoạt, điểm cuối của công nghệ quảng cáo phải phản hồi yêu cầu Attribution Reporting API của Android kèm theo phản hồi .
Attribution-Reporting-Register-OS-Trigger { "event_trigger_data": [{"trigger_data":"1"}], "aggregatable_trigger_data": [ {"key_piece":"0x400","source_keys":["campaignCounts"]}, {"key_piece":"0xA80","source_keys":["geoValue"]} ], ... }
- Phần còn lại của quy trình đăng ký điều kiện kích hoạt vẫn giữ nguyên.
Gỡ lỗi
Khi thiết lập quy trình triển khai ứng dụng cho web, bạn nên thiết lập gỡ lỗi để xác minh xem các nguồn và điều kiện kích hoạt có được đăng ký đúng cách hay không cũng như chưa được đăng ký để nhận thông tin về lý do.
Để biết các bước gỡ lỗi chung trong Báo cáo phân bổ, hãy tham khảo sổ tay gỡ lỗi.