Một số công nghệ Hộp cát về quyền riêng tư đang được loại bỏ dần.

Xem Thông tin cập nhật về kế hoạch cho các công nghệ của Hộp cát về quyền riêng tư.

Trạng thái tính năng Hộp cát về quyền riêng tư cung cấp thêm thông tin về trạng thái của từng API và tính năng nền tảng.

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à trên 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ả hoạt động đăng ký nguồn và điều kiện kích hoạt cho Attribution Reporting API trên Android thay vì xử lý các hoạt động đă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 mô hình phân bổ trên nhiều ứng dụng và trang 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ó để xác minh rằng 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 hệ điều hành Android

Mô hình phân bổ trên nhiều ứng dụng và web sẽ chỉ hoạt động nếu Attribution Reporting API được bật 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 sẵn có của Attribution Reporting API trên Android được gửi qua tiêu đề Attribution-Reporting-Support. Tiêu đề này sẽ trả về os, web hoặc cả hai, tuỳ thuộc vào những gì có trên thiết bị đó. Nếu cả hai đều có sẵn, thì các công nghệ quảng cáo sẽ có lựa chọn đăng ký nguồn web và điều kiện kích hoạt web bằng 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ó nên đă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 chiến dịch chỉ dành cho web, các 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ác công nghệ quảng cáo phải uỷ quyền cả quy trình đă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 các nguồn và điều kiện kích hoạt bằng cả API Chrome và API Android để tránh tạo báo cáo phân bổ trùng lặp.
Hoạt động 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 điều kiện này không thể khớp với nhau và ngược lại.
Đối với những nguồn có thể dẫn đến trình kích hoạt ứng dụng hoặc web, công nghệ quảng cáo nên uỷ quyền đăng ký nguồn và trình kích hoạt web cho Attribution Reporting API của Android.
Đối với những điều kiện kích hoạt có thể được điều khiển bởi các nguồn dựa trên ứng dụng, 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 Attribution Reporting API 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 Attribution Reporting API 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ể 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 mà họ yêu thích. Họ thấy một quảng cáo về các chuyến bay giá rẻ đến Paris và háo hức 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 nhấp chuột bằng API Báo cáo phân bổ của Android. Người dùng sẽ được chuyển đế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 kiểm tra xem API cấp hệ điều hành có dùng được hay không. Công nghệ quảng cáo đă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 đă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à trình kích hoạt web, đồng thời gửi các báo cáo liên quan.

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

SDK công nghệ quảng cáo trong Ứng dụng Android Daily News đăng ký lượt nhấp bằng cách sử dụng registerSource()
Attribution Reporting API trên Android gửi một 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 quy trình đă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 trong Attribution Reporting API hay không
ARA trên web trả về thông tin về nền tảng được hỗ trợ
Tiêu đề OS-Trigger cho biết API ARA trên web sẽ gọi hàm API ARA của hệ điều hành registerWebTrigger()
Lệnh gọi đến registerWebTrigger() diễn ra ở chế độ nền và nhà phát triển không cần gọi registerWebTrigger() trực tiếp bằng hệ điều hành
ARA của hệ điều hành sẽ tiếp quản và gửi một 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 quy trình đă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 logic được áp dụng cho hoạt động phân bổ ứng dụng<>ứ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 bao gồm thông tin chi tiết hơn về cách hoàn thành nhiệm vụ:

Công nghệ quảng cáo từ ứng dụng đăng ký một nguồn bằng Attribution Reporting API của Android với cá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 trên web (eTLD+1) thay vì một đích đến là ứ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 ở cả đí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ụ: một công cụ đo lường của bên thứ ba hoặc một 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ẽ 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 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ể khiến nhà cung cấp dịch vụ đo lường bên thứ ba tính số lượt đăng ký hai lần. Để ngăn chặn việc tính trùng 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ý Attribution Reporting API đến một URL thay thế nhưng có tính xác định.
- Để bật hành vi này, các 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 sau tiêu đề này sẽ có .well-known được thêm vào đầu đường dẫn URI chuyển hướng.
- Phần còn lại của quy trình đăng ký nguồn giống với quy trình đăng ký nguồn tiêu chuẩn từ ứng dụng đến ứng dụng.
Lưu ý: Nếu bạn hoặc ứng dụng xuất bản đang sử dụng webview để hiển thị quảng cáo trong một ứ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 đă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 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ể dùng yêu cầu pixel hoặc fetch() để đưa ra yêu cầu đăng ký một điều kiện kích hoạt
  2. Tiêu đề yêu cầu Attribution-Reporting-Support được 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. Tiêu đề này:
  1. Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
  2. Chrome uỷ quyền việc đăng ký cho hệ điều hành bằng cách gọi hàm OS API registerWebTrigger()
    - Lệnh gọi đến registerWebTrigger() diễn ra một cách không rõ ràng, 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 một 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 thêm tiêu đề Attribution-Reporting-Info. Khoá là preferred-platform 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ó sẵn và sẽ quay lại nền tảng web khi hệ điều hành không hoạt động.
Lưu ý: 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 đều phải được trả về khi chỉ định một nền tảng ưu tiên để xác minh rằng quá trình đăng ký nền tảng diễn ra chính xác. Bạn phải cung cấp cả thông tin đăng ký hệ điều hành và thông tin đăng ký web để 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 quy 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 API Báo cáo phân bổ của 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 đă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 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ọ thấy quảng cáo về một chiếc á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 quy trình đăng ký cho Attribution Reporting API trên Android thay vì sử dụng Attribution Reporting API 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 Android Attribution Reporting API. Attribution Reporting API ở cấp hệ điều hành có thể so khớp nguồn trê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 liên quan.

Đăng ký nguồn trê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 trong Attribution Reporting API hay không
ARA trên web trả về thông tin về nền tảng được hỗ trợ
Tiêu đề OS-Source cho biết API ARA trên web sẽ gọi hàm API ARA của hệ điều hành registerWebSource()
Lệnh gọi đến registerWebSource() diễn ra theo cách không rõ ràng và nhà phát triển không cần gọi registerWebSource() trực tiếp bằng hệ điều hành
ARA của hệ điều hành sẽ tiếp quản và gửi một 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 quy trình đă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 của Cửa hàng quần áo 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 một 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 quy 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 logic được áp dụng cho hoạt động phân bổ ứng dụng<>ứ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 bao gồm thông tin chi tiết hơn 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 đă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ý một nguồn, bạn phải chỉ định trực tiếp thông số nguồn phân bổ, bằng cách sử dụng thẻ attributionsrc hoặc bằng cách sử dụng quy trình đă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">
```
Tiện ích công nghệ quảng cáo sẽ nhận được tiêu đề yêu cầu Attribution-Reporting-Support do Chrome trả về. 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 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 nên 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. Tiêu đề này:
1. Yêu cầu Chrome uỷ quyền đăng ký cho hệ điều hành
2. Chrome uỷ quyền việc đăng ký cho hệ điều hành bằng cách gọi hàm OS API registerWebSource()
3. Lệnh gọi đến registerWebSource() diễn ra một cách không rõ ràng, 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 một 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 sẽ không xuất hiệ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 thêm tiêu đề Attribution-Reporting-Info. Khoá là preferred-platform 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ó sẵn và sẽ chuyển sang nền tảng web khi hệ điều hành không có sẵn.
Lưu ý: 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 đều phải được trả về khi chỉ định một nền tảng ưu tiên để xác minh rằng quá trình đăng ký nền tảng diễn ra chính xác. Bạn phải cung cấp cả thông tin đăng ký hệ điều hành và thông tin đăng ký web để 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 quy 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-Source. Phản hồi cũng phải chỉ định một đí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ợ các lệnh chuyển hướng cho lượt đăng ký nguồn, Chrome sẽ tuân 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 Attribution Reporting API của Android:
- Đối với các điều kiện kích hoạt xảy ra trong ứng dụng, các ứng dụng sẽ đăng ký điều kiện kích hoạt bằng Android Attribution Reporting API như bình thường.

Những chiến dịch có cả đích đến tiềm năng là ứng dụng và trang 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ố, chẳng hạn như việc 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ó) để nguồn có thể được phân bổ chính xác bất kể vị trí xảy ra điều kiện kích hoạt. Khi đăng ký nguồn với hệ điều hành, cả đích đến của ứng dụng và web đều 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
- Vị trí xuất hiện trên web phải nằm trong trường web_destination
- Nhà phát triển Chrome nên lưu ý rằng trường destination cho Attribution Reporting API của 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 ước chừng sẽ giải thích cách việc sử dụng hai đích đến có thể ảnh hưởng đến nhiễu trong báo cáo của bạn.
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 có hai đích đến:
- Nếu cả đích đến là hệ điều hành (ứng dụng) và đích đến là web đều được chỉ định 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 ở đích đến là web hay đích đến là ứng dụng. Tuy nhiên, để duy trì các giới hạn về 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 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 ít nhiễu hơn so với các báo cáo có chỉ định đích đến ứng dụng hoặc web.
- 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ẻ Chrome tuỳ chỉnh

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 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
- Điều này được xử lý giống như mọi phân bổ trên web từ trang web này sang trang web khác trong Chrome.

Đối với các ứ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 trên web hoặc các tính năng tuỳ chỉnh của ứng dụng phù hợp hơn với định dạng web.

Để cho phép WebView sử dụng Attribution Reporting API, bạn cần định cấu hình ứng dụng nhúng với các quyền phù hợp.
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ề os và chỉ khi Attribution Reporting API của Android dùng được.

Lưu ý: Để thực hiện hoạt động phân bổ trên Chrome và WebView, bạn cần uỷ quyền đăng ký nguồn và điều kiện kích hoạt trong Chrome cho hệ điều hành vì chỉ có hoạt động phân bổ dựa trên hệ điều hành mới được hỗ trợ 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 mà WebView sử dụng do ứng dụng kết xuất WebView đặt 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 nhận là nhà xuất bản; ví dụ về thời điểm sử dụng registerSource là ứng dụng nhà xuất bản hiển thị quảng cáo được hiển thị 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ị sẽ hiển thị quảng cáo. registerTrigger và registerWebTrigger hoạt động tương tự nhau. Biểu đồ ở mục 3 trình bày chi tiết các trường hợp khác nhau khi 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 gọi Attribution Reporting API 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 đòi hỏi hành vi khác, ứng dụng đó sẽ phải 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 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 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 dùng registerWebSource() để liên kết các lượt đăng ký nguồn với trang web trong WebView thay vì với ứng dụng, 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 đă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 từ 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ừ Android Attribution Reporting API đến URI công nghệ quảng cáo.
- Để hoàn tất quy 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 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 quy trình đăng ký lệnh 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 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 một chế độ triển khai từ ứng dụng đế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à điều kiện 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 về Attribution Reporting, hãy tham khảo sổ tay gỡ lỗi.

Hướng dẫn triển khai Attribution Reporting API trên web và ứng dụng Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Đăng ký nguồn ứng dụng và điều kiện kích hoạt web

Ví dụ:

Luồng công việc

Đăng ký một nguồn web và một điều kiện kích hoạt ứng dụng

Ví dụ:

Luồng công việc

Những chiến dịch có cả đích đến tiềm năng là ứng dụng và trang web

Đối với các ứng dụng sử dụng Thẻ Chrome tuỳ chỉnh

Đối với các ứng dụng sử dụng WebView

Gỡ lỗi

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