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

Hướng dẫn triển khai Attribution Reporting API trên web và ứng dụng

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.

Đă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àm registerWebTrigger()
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 cho registerWebTrigger() bằng hệ điều hành
Hệ đ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",
    ...
}
```
Lưu ý: Đối với những chiến dịch có thể chuyển đổi trên web HOẶC đích đến của ứng dụng, hãy xem phần về đích đến kép
- 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
```
  Lưu ý: Tất cả các lượt chuyển hướng tiếp theo đều theo sau tiêu đề này sẽ có .well-known được thêm vào phần đầu của đường dẫn của URI chuyển hướng.
- 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.
Lưu ý: Nếu bạn hoặc ứng dụng xuất bản đang dùng chế độ xem web để hiển thị quảng cáo gốc trong một ứng dụng Android, hãy tham khảo phần chế độ xem web
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
  1. 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ạt
  2. 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
```
- 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:
  1. Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
  2. 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 cho registerWebTrigger()
  3. 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.
Lưu ý: Cả Attribution-Reporting-Register-Trigger chứa thông tin đăng ký web và Tiêu đề Attribution-Reporting-Register-OS-Trigger chứa thông tin đăng ký hệ điều hành thông tin cần được trả về khi chỉ định nền tảng ưu tiên để đảm bảo có thể đăng ký nền tảng. Cả đăng ký hệ điều hành và web đều phải để nếu không có nền tảng ưu tiên, thông tin bắt buộc đối với phương thức dự phòng.
```
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.

Đă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àm registerWebSource()
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 cho registerWebSource() bằng hệ điều hành
Hệ đ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ạt
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 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">
```
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
```
Lưu ý: Bạn phải bật Attribution Reporting API trên hệ điều hành Android để đo lường thành công trên ứng dụng và 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:
1. Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
2. 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()
3. 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 cho registerWebSource()
4. 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.
Lưu ý: Cả Attribution-Reporting-Register-Source chứa thông tin đăng ký web và Tiêu đề Attribution-Reporting-Register-OS-Source chứa thông tin đăng ký hệ điều hành cần được trả về khi chỉ định nền tảng ưu tiên để đảm bảo có thể đăng ký nền tảng. Cả đăng ký hệ điều hành và web đều phải để nếu không có nền tảng ưu tiên, thông tin bắt buộc đối với phương thức dự phò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.

Lưu ý: Để phân bổ trên Chrome và WebView, đăng ký nguồn và điều kiện kích hoạt trong Chrome sẽ cần được ủy quyền cho hệ điều hành vì chỉ hỗ trợ mô hình phân bổ dựa trên hệ điều hành cho WebView.
Khi uỷ quyền cho hệ điều hành, WebView có thể dùng registerSource hoặc registerWebSource và registerTrigger hoặc registerWebTrigger. 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ới registerSource, ứng dụng sẽ được ghi lại nhà xuất bản; ví dụ về thời điểm sử dụng registerSource 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ằng registerWebSource 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ụng registerWebSource: 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ụng registerSource hoặc registerWebSource, và registerTrigger hoặc registerWebTrigger.

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ặc registerWebTrigger() thay vì registerSource() hoặc registerTrigger().
- 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.

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ọi registerSource() hoặc registerWebSource() 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ọi registerTrigger() hoặc registerWebTrigger() 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.