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à điều kiện 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ể uỷ quyền cả việc đăng ký nguồn và điều kiện kích hoạt cho Attribution Reporting API cho Android thay vì xử lý các lượt đă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ẽ hướng dẫn bạn cách thiết lập tính năng phân bổ trên nhiều ứng dụng và web.

Khi thiết lập tính năng 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 chế độ thiết lập của bạn đang hoạt động như dự kiến.

Đăng ký nguồn và điều kiện kích hoạt bằng Android OS

Mô hình phân bổ trên web và ứng dụng sẽ chỉ hoạt động nếu bạn bật Attribution Reporting API trong cả trình duyệt và hệ điều hành Android trên cùng một thiết bị. Trạng thái có sẵn của Attribution Reporting API cho Android được gửi 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ó cả hai, thì các công nghệ quảng cáo sẽ có thể chọn đăng ký nguồn web và điều kiện kích hoạt web 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 có đăng ký nguồn web hoặc điều kiện kích hoạt web với trình duyệt hay hệ điều hành hay không.

Đối với các 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 Attribution Reporting API của Chrome hoặc chọn uỷ quyền cả hai cho hệ điều hành. Đối với các chiến dịch chỉ dành cho web, trong đó nguồn hoặc điều kiện kích hoạt có thể xảy ra trong WebView, công nghệ quảng cáo phải uỷ quyền cả việc đă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ý đồng thời nguồn và điều kiện kích hoạt với cả API Chrome và Android để tránh tạo báo cáo phân bổ trùng lặp.
Việc phân bổ diễn ra riêng biệt cho trình duyệt và hệ điều hành. Nếu một nguồn được đă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, thì hai nguồn đó không thể so khớp với nhau và ngược lại.
Đối với các nguồn có thể dẫn đến một ứng dụng hoặc trình kích hoạt web, công nghệ quảng cáo nên uỷ quyền đăng ký nguồn web và trình kích hoạt cho API Báo cáo phân bổ của Android.
Đối với các đ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 API Báo cáo phân bổ của Android.
Đố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 đều cần được đăng ký bằng API Báo cáo phân bổ theo 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ể xảy ra 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 di động trên cùng một thiết bị.

Ví dụ:

Một người dùng đang đọc bài viết trong ứng dụng tin tức yêu thích của họ. Họ thấy một quảng cáo về chuyến bay giá rẻ đến Paris và hào hứng nhấp vào để đặt vé. Công nghệ quảng cáo phân phát quảng cáo trong ứng dụng tin tức sẽ đăng ký nguồn lượt nhấp bằng API Báo cáo phân bổ của Android. Người dùng được chuyển đến trang web của nhà quảng cáo trong Chrome để 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ó hoạt động hay không. Công nghệ quảng cáo sẽ đăng ký điều kiện kích hoạt lượt chuyển đổi bằng cách hướng dẫn Chrome uỷ quyền việc đăng ký cho hệ điều hành thay vì đăng ký trực tiếp bằng Attribution Reporting API của Chrome. Sau đó, Attribution Reporting API cấp hệ điều hành có thể so khớp nguồn ứng dụng và điều kiện kích hoạt web, đồng thời gửi các báo cáo có liên quan.

Quy trình phân bổ từ ứng dụng đến web — Quy trình phân bổ ứng dụng đến web

Đăng ký nguồn ứng dụng:

SDK công nghệ quảng cáo trong Ứng dụng Daily News dành cho Android đă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 URL máy chủ công nghệ quảng cáo được cung cấp cho registerSource()
Máy chủ công nghệ quảng cáo phản hồi bằng tiêu đề Attribution-Reporting-Register-Source để hoàn tất việc đăng ký nguồn

Đăng ký điều kiện kích hoạt trên web:

Công nghệ quảng cáo đăng ký một điều kiện kích hoạt và kiểm tra xem hệ điều hành có sẵn hay không 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 web gọi hàm registerWebTrigger() của API ARA OS
Lệnh gọi đến registerWebTrigger() diễn ra trong nền và nhà phát triển không cần gọi trực tiếp registerWebTrigger() bằng hệ điều hành
ARA của hệ điều hành sẽ tiếp quản và gửi yêu cầu đến URL máy chủ công nghệ quảng cáo do tiêu đề Attribution-Reporting-Register-OS-Trigger cung cấp
Công nghệ quảng cáo sẽ hoàn tất việc đăng ký điều kiện kích hoạt bằng API hệ điều hành
ARA của hệ điều hành sẽ thực hiện hoạt động phân bổ theo cùng một logic áp dụng cho hoạt động phân bổ ứng dụng<>ứng dụng và gửi các báo cáo tương tự

Luồng công việc

Các bước sau đây bao gồm thông tin chi tiết khác về cách hoàn tất nhiệm vụ:

Công nghệ quảng cáo của ứng dụng đăng ký một nguồn với API Báo cáo phân bổ của Android bằng các mức đ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 đích đến web (eTLD+1) thay vì đích đến ứ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 trong đích đến là trang web HOẶC ứ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ẽ tuân theo đường dẫn chuyển hướng được chỉ định trong tiêu đề Attribution-Reporting-Redirect ở chế độ nền và đồng thời đường dẫn chuyển hướng 302 sẽ thực thi ở chế độ nền trước cho các yêu cầu điều hướng hiện có. Các yêu cầu này sẽ chuyển đến cùng một URL và có thể dẫn đến việc nhà cung cấp dịch vụ đo lường bên thứ ba tính hai lần lượt đăng ký. Để ngăn việc tính hai lần lượt đăng ký, các công nghệ quảng cáo có thể sửa đổi hành vi chuyển hướng để gửi lượt đăng ký API Báo cáo phân bổ đến một URL thay thế nhưng có thể xác định.
- Để bật 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ệnh chuyển hướng tiếp theo theo tiêu đề này sẽ có .well-known được thêm vào đầu đườ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 đăng ký nguồn tiêu chuẩn giữa các ứng dụng.
Lưu ý: Nếu bạn hoặc ứng dụng phát hành đang sử dụng webview để hiển thị quảng cáo trong ứng dụng Android, hãy tham khảo phần về webview
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 việc đăng ký cho API Báo cáo phân bổ 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 sẽ đưa ra 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ý trình kích hoạt
  2. Tiêu đề yêu cầu Attribution-Reporting-Support do Chrome trả về 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, thì tiêu đề sẽ trả về os, web
```
Attribution-Reporting-Support: os, web
```
- Sau đó, công nghệ quảng cáo sẽ 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 việc đă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 trong nền, công nghệ quảng cáo không cần gọi trực tiếp 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 truyền 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 nền tảng ưu tiên để xử lý việc đăng ký điều kiện kích hoạt bằng cách đưa tiêu đề Attribution-Reporting-Info vào. Khoá là nền tảng ưu tiên và các giá trị được cho phép là os và web. Trình duyệt sẽ sử dụng nền tảng ưu tiên khi có và sẽ quay lại nền tảng web khi không có hệ điều hành.
Lưu ý: Bạn phải trả về cả tiêu đề 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 khi chỉ định một nền tảng ưu tiên để đảm bảo có thể đăng ký nền tảng chính xác. Bạn phải cung cấp cả thông tin đăng ký trên web và hệ điều hành để nếu không có nền tảng ưu tiên, thì thông tin cần thiết cho phương thức dự phòng sẽ xuất hiện.
```
Attribution-Reporting-Info: preferred-platform=os
```
- Để hoàn tất việc đă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 API Báo cáo phân bổ Android bằ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 quy trình đăng ký điều kiện kích hoạt vẫn giữ nguyên.

Đăng ký nguồn web và đ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 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 xem một trang web trong trình duyệt Chrome trên điện thoại Android. Họ nhìn thấy một quảng cáo về áo len của một trong những cửa hàng mà họ yêu thích. Họ nhấp vào quảng cáo và được chuyển đế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 lượt nhấp bằng cách hướng dẫn Chrome uỷ quyền việc đăng ký cho API Báo cáo phân bổ Android thay vì sử dụng API Báo cáo phân bổ trên Chrome. Người dùng mua áo len trong ứ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 lượt chuyển đổi bằng API Báo cáo phân bổ của Android. API Báo cáo phân bổ cấp hệ điều hành có thể so khớp nguồn web và điều kiện kích hoạt ứng dụng, đồng thời 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ý một nguồn và kiểm tra xem hệ điều hành có sẵn hay không 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 web gọi hàm registerWebSource() của API ARA OS
Lệnh gọi đến registerWebSource() diễn ra trong nền và nhà phát triển không cần gọi trực tiếp registerWebSource() bằng hệ điều hành
ARA của hệ điều hành sẽ tiếp quản và gửi yêu cầu đến URL máy chủ công nghệ quảng cáo do tiêu đề Attribution-Reporting-Register-OS-Source cung cấp
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 Cửa hàng quần áo dành cho Android sẽ đăng ký điều kiện kích hoạt với ARA của hệ điều hành
Attribution Reporting API trên Android gửi yêu cầu đến URL máy chủ công nghệ quảng cáo được cung cấp cho registerTrigger()
Máy chủ công nghệ quảng cáo phản hồi bằng tiêu đề Attribution-Reporting-Register-Trigger để hoàn tất quá trình đăng ký điều kiện kích hoạt
ARA của hệ điều hành sẽ thực hiện hoạt động phân bổ theo cùng một logic áp dụng cho hoạt động phân bổ ứng dụng<>ứng dụng và gửi các báo cáo tương tự

Luồng công việc

Các bước sau đây bao gồm thông tin chi tiết khác về cách hoàn tất nhiệm vụ:

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 việc đăng ký cho API Báo cáo phân bổ của Android:
- Đối với trường hợp sử dụng web đến ứng dụng, khi đăng ký nguồn, bạn phải chỉ định trực tiếp tham số nguồn phân bổ bằng cách sử dụng thẻ attributionsrc hoặc bằng cách sử dụng tính năng đăng ký JavaScript
- Ví dụ sau 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">
```
Tiêu đề yêu cầu Attribution-Reporting-Support do Chrome trả về 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, thì 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 Android OS để đ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 việc đă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 trong nền, công nghệ quảng cáo không cần gọi trực tiếp 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 truyền từ trình duyệt
```
Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
```
- Trong một số trường hợp, tiêu đề Attribution-Reporting-Support không có sẵn. Khi điều này xảy ra, công nghệ quảng cáo vẫn có thể đặt một nền tảng ưu tiên để xử lý việc đăng ký nguồn bằng cách đưa tiêu đề Attribution-Reporting-Info vào. 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 khi có và sẽ chuyển sang nền tảng web khi không có hệ điều hành.
Lưu ý: Bạn phải trả về cả tiêu đề 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 khi chỉ định một nền tảng ưu tiên để đảm bảo có thể đăng ký nền tảng chính xác. Bạn phải cung cấp cả thông tin đăng ký trên web và hệ điều hành để nếu không có nền tảng ưu tiên, thì thông tin cần thiết cho phương thức dự phòng sẽ xuất hiện.
```
Attribution-Reporting-Info: preferred-platform=os
```
- Để hoàn tất việc đă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 API Báo cáo phân bổ Android bằng 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ẽ làm theo các lệnh 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 quy 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ý một điều kiện kích hoạt bằng API Báo cáo phân bổ của Android:
- Đối với các điều kiện kích hoạt xảy ra trong ứng dụng, ứng dụng sẽ đăng ký điều kiện kích hoạt bằng API Báo cáo phân bổ của Android như bình thường.

Những chiến dịch có cả đích đến tiềm năng là ứ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ố như liệu người dùng đã cài đặt ứng dụng hay chưa.
- Trong những trường hợp này, bạn nên uỷ quyền đăng ký nguồn cho hệ điều hành (nếu có) để có thể phân bổ chính xác nguồn bất kể điều kiện kích hoạt xảy ra ở đâu. Khi đăng ký nguồn với hệ điều hành, bạn có thể chỉ định cả đích đến của ứng dụng và đích đến của web trong các tham số tương ứng.
- Đích đến của ứng dụng phải nằm trong trường destination
- Đích đến trên web phải nằm trong trường web_destination
- Nhà phát triển Chrome cần lưu ý rằng trường destination cho API Báo cáo phân bổ hệ điều hành phải là một gói ứng dụng chứ không phải 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 thô sẽ giải thích cách 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 độ nhiễu trong báo cáo cấp sự kiện cho các nguồn đích kép:
- Nếu bạn chỉ định cả hệ điều hành (ứng dụng) và đích đến web trong quá trình đăng ký nguồn, thì theo mặc định, báo cáo ở cấp sự kiện sẽ chỉ định xem điều kiện kích hoạt xảy ra trong đích đến web hay đích đến ứng dụng. Tuy nhiên, để duy trì các giới hạn về quyền riêng tư, chúng tôi sẽ thêm nhiễu 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 tính năng báo cáo thô và giảm bớt âm thanh. Nếu một nguồn được chỉ định trường coarse_event_report_destinations giành được lượt phân bổ, báo cáo thu được sẽ bao gồm cả đích đến ứng dụng và đích đến web, mà không có sự phân biệt về vị trí thực sự xuất hiện điều kiện kích hoạt, nhưng có ít dữ liệu nhiễu hơn so với báo cáo chỉ định đích đến ứng dụng hoặc đích đến web.
- Các báo cáo tổng hợp vẫn giữ nguyên.

Đố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 web. 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
- Phương thức này được xử lý giống như mọi mô hình phân bổ 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ể sử dụng WebView để hiển thị 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 các tính năng ứng dụng tuỳ chỉnh phù hợp hơn với định dạng web.

Để cho phép WebView sử dụng API Báo cáo phân bổ, bạn cần định cấu hình ứng dụng nhúng bằng quyền chính xác.
Chỉ có mô hình phân bổ ở cấp hệ điều hành trong WebView. Tiêu đề Attribution-Reporting-Support sẽ chỉ trả về hệ điều hành và chỉ khi có Attribution Reporting API của Android.

Lưu ý: Để phân bổ trên Chrome và WebView, bạn cần uỷ quyền cho hệ điều hành đăng ký nguồn và trình kích hoạt trong Chrome vì WebView chỉ hỗ trợ tính năng phân bổ dựa trên hệ điều hành.

Khi uỷ quyền cho hệ điều hành, WebView có thể sử dụng registerSource hoặc registerWebSource và registerTrigger hoặc registerWebTrigger. WebView sử dụng phương thức nào là do ứng dụng hiển thị WebView thiết lập và được xác định trên cơ sở từng WebView.

Sự khác biệt giữa registerSource và registerWebSource là nguồn nào được ghi lại dưới dạng nhà xuất bản. Với registerSource, ứng dụng được ghi lại dưới dạng nhà xuất bản; ví dụ về thời điểm sử dụng registerSource là một ứng dụng nhà xuất bản hiển thị quảng cáo được kết xuất bằng WebView. Với registerWebSource, trang web được lưu trữ trong WebView sẽ được ghi lại dưới dạng nhà xuất bản; ví dụ về thời điểm sử dụng registerWebSource là một ứng dụng lưu trữ WebView và trang web đang được WebView hiển thị quảng cáo. registerTrigger và registerWebTrigger hoạt động tương tự nhau. Biểu đồ trong mục #3 trình bày chi tiết các trường hợp khác nhau mà 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ẽ sử dụng registerSource và registerWebTrigger khi gọi API Báo cáo phân bổ của Android. Phương thức này liên kết các nguồn với ứng dụng và các điều kiện kích hoạt với 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, thì ứng dụng đó sẽ phải sử dụng một phương thức mới setAttributionRegistrationBehavior trên lớp androidx.webkit.WebViewSettingsCompat. Phương thức này sẽ chỉ định xem WebView nên gọi registerWebSource() hay registerWebTrigger() thay vì gọi registerSource() hay registerTrigger().
Bạn sẽ cần thiết lập hành vi này cho mỗi WebView được khởi tạo.
Nếu SDK công nghệ quảng cáo đang khởi tạo WebView, thì SDK sẽ cần đặt hành vi mặc định này.
Đối với những ứng dụng muốn sử dụng registerWebSource() để liên kết các lượt đăng ký nguồn với trang web trong WebView thay vì ứng dụng, thì các ứng dụng đó phải tham gia danh sách cho phép WebApp. Hoàn tất biểu mẫu này để tham gia danh sách cho phép. 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ư liên quan đến việc thiết lập niềm tin cho ngữ cảnh web.

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.

Đăng ký nguồn và đ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 cho WebView, thao tác này sẽ gọi registerSource() hoặc registerWebSource() bằng hệ điều hành và bắt đầu lệnh gọi API phụ từ API Báo cáo phân bổ Android đến URI công nghệ quảng cáo.
- Để hoàn tất việc đă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 API Báo cáo phân bổ 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 quy trình đăng ký nguồn vẫn giữ nguyên.
Công nghệ quảng cáo phải phản hồi các lượt đăng ký điều kiện 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 cho WebView, thao tác này sẽ gọi registerTrigger() hoặc registerWebTrigger() bằng 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 việc đă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 API Báo cáo phân bổ của Android bằng tiêu đề 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 ứng dụng để triển khai trên web, bạn nên thiết lập báo cáo gỡ lỗi để xác minh xem các nguồn và trình kích hoạt có được đăng ký chính xác hay không. Nếu không được đăng ký, bạn sẽ nhận được 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 cẩm nang gỡ lỗi.