เทคโนโลยี Privacy Sandbox บางอย่างกำลังจะเลิกใช้งาน

ดูข้อมูลอัปเดตเกี่ยวกับแผนสำหรับเทคโนโลยี Privacy Sandbox

สถานะฟีเจอร์ Privacy Sandbox ให้ข้อมูลเพิ่มเติมเกี่ยวกับสถานะของ API และฟีเจอร์แพลตฟอร์มแต่ละรายการ

คู่มือการใช้งาน Attribution Reporting API ข้ามเว็บและแอป

Attribution Reporting API ช่วยให้การระบุแหล่งที่มาข้ามแอปและเว็บสําหรับแหล่งที่มา และทริกเกอร์ที่เกิดขึ้นในอุปกรณ์เครื่องเดียวกัน เบราว์เซอร์ เช่น Chrome สามารถมอบสิทธิ์การลงทะเบียนทั้งแหล่งที่มาและทริกเกอร์ให้กับ Attribution Reporting API สำหรับ Android แทนที่จะจัดการการลงทะเบียนเหล่านั้นในเบราว์เซอร์ ซึ่งจะช่วยให้ Android จับคู่แหล่งที่มาและทริกเกอร์ในทั้งเว็บไซต์และแอปได้

คู่มือนี้จะสอนวิธีตั้งค่าการระบุแหล่งที่มาข้ามแอปและเว็บ

ขณะตั้งค่าการระบุแหล่งที่มาข้ามแอปและเว็บ เราขอแนะนําอย่างยิ่งให้คุณทําความคุ้นเคยกับโซลูชันการแก้ไขข้อบกพร่องที่มีอยู่เพื่อยืนยันว่าการตั้งค่าทํางานตามที่ต้องการ

ลงทะเบียนแหล่งที่มาและทริกเกอร์กับระบบปฏิบัติการ Android

การระบุแหล่งที่มาข้ามแอปและเว็บจะใช้ได้ก็ต่อเมื่อเปิดใช้ Attribution Reporting API ทั้งในเบราว์เซอร์และระบบปฏิบัติการ Android ในอุปกรณ์เดียวกัน ระบบจะส่งความพร้อมใช้งานของ Android Attribution Reporting API ผ่านส่วนหัว Attribution-Reporting-Support ส่วนหัวนี้จะแสดงผลเป็น os, web หรือทั้ง 2 อย่าง ขึ้นอยู่กับสิ่งที่พร้อมใช้งานในอุปกรณ์นั้น หากทั้ง 2 อย่างพร้อมใช้งาน ผู้ให้บริการเทคโนโลยีโฆษณาจะเลือกได้ว่าจะลงทะเบียนแหล่งที่มาบนเว็บและทริกเกอร์บนเว็บกับเบราว์เซอร์หรือระบบปฏิบัติการ

เทคโนโลยีโฆษณาต้องตัดสินใจว่าจะลงทะเบียนแหล่งที่มาของเว็บหรือทริกเกอร์ของเว็บ กับเบราว์เซอร์หรือระบบปฏิบัติการ

สําหรับแคมเปญบนเว็บเท่านั้น เทคโนโลยีโฆษณายังคงลงทะเบียนทั้งแหล่งที่มาและทริกเกอร์ได้ ด้วย Attribution Reporting API ของ Chrome หรือจะเลือกมอบสิทธิ์ทั้ง 2 รายการให้กับระบบปฏิบัติการก็ได้ สำหรับแคมเปญบนเว็บเท่านั้นซึ่งอาจมีแหล่งที่มาหรือทริกเกอร์ใน WebView เทคโนโลยีโฆษณาต้องมอบสิทธิ์การลงทะเบียนทั้งแหล่งที่มาและทริกเกอร์ให้กับระบบปฏิบัติการ ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับ WebView
เทคโนโลยีโฆษณาควรหลีกเลี่ยงการลงทะเบียนแหล่งที่มาและทริกเกอร์ด้วยทั้ง API ของ Chrome และ Android พร้อมกันเพื่อหลีกเลี่ยงการสร้างรายงานการระบุแหล่งที่มาที่ซ้ำกัน
การระบุแหล่งที่มาจะเกิดขึ้นแยกกันสำหรับเบราว์เซอร์และระบบปฏิบัติการ หากแหล่งที่มา ลงทะเบียนกับเบราว์เซอร์ แต่ทริกเกอร์ลงทะเบียนกับระบบปฏิบัติการ ระบบจะจับคู่ 2 รายการนี้ไม่ได้ และในทางกลับกัน
สําหรับแหล่งที่มาที่อาจทําให้เกิดทริกเกอร์แอปหรือเว็บ ขอแนะนําอย่างยิ่ง ให้เทคโนโลยีโฆษณามอบสิทธิ์การลงทะเบียนแหล่งที่มาและทริกเกอร์บนเว็บให้กับ Android Attribution Reporting API
สำหรับทริกเกอร์ที่อาจเกิดจากแหล่งที่มาในแอป เทคโนโลยีโฆษณาสามารถ เลือกมอบสิทธิ์การลงทะเบียนทริกเกอร์บนเว็บให้กับ Attribution Reporting API ของ Android ได้
สําหรับแคมเปญที่ทั้งแหล่งที่มาและทริกเกอร์เกิดขึ้นในแอป ทั้ง 2 อย่างจะต้องลงทะเบียนกับ Attribution Reporting API ของระบบปฏิบัติการ

ลงทะเบียนแหล่งที่มาของแอปและทริกเกอร์เว็บ

สําหรับบางแคมเปญ แหล่งที่มาอาจเกิดขึ้นในแอป ขณะที่ทริกเกอร์จะเกิดขึ้น ในเว็บไซต์ในเบราว์เซอร์บนอุปกรณ์เคลื่อนที่ในอุปกรณ์เดียวกัน

ตัวอย่าง

ผู้ใช้กำลังอ่านบทความในแอปข่าวที่ชื่นชอบ และเห็นโฆษณาเที่ยวบินราคาถูกไปปารีส จึงคลิกเพื่อจองด้วยความตื่นเต้น เทคโนโลยีโฆษณาที่แสดงโฆษณาในแอปข่าวจะลงทะเบียนแหล่งที่มาของการคลิกด้วย Android Attribution Reporting API ระบบจะนำผู้ใช้ไปยังหน้าเว็บของผู้ลงโฆษณาใน Chrome ซึ่งผู้ใช้จะทำ Conversion ได้ เทคโนโลยีโฆษณาในเว็บไซต์ของผู้ลงโฆษณาจะตรวจสอบว่า API ระดับระบบปฏิบัติการพร้อมใช้งานหรือไม่ และพร้อมใช้งาน เทคโนโลยีโฆษณาจะลงทะเบียนทริกเกอร์ Conversion โดย สั่งให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับระบบปฏิบัติการแทนที่จะลงทะเบียน โดยตรงด้วย Attribution Reporting API ของ Chrome จากนั้น Attribution Reporting API ระดับระบบปฏิบัติการจะจับคู่แหล่งที่มาของแอปและทริกเกอร์บนเว็บ และส่งรายงานที่เกี่ยวข้องได้

ขั้นตอนการระบุแหล่งที่มาระหว่างแอปกับเว็บ — ขั้นตอนการระบุแหล่งที่มาของแอปไปยังเว็บ

การลงทะเบียนแหล่งที่มาของแอป:

SDK เทคโนโลยีโฆษณาในแอป Daily News Android จะลงทะเบียนการคลิกโดยใช้ registerSource()
Attribution Reporting API ใน Android จะส่งคำขอไปยังเซิร์ฟเวอร์เทคโนโลยีโฆษณา URL ที่ระบุไว้ใน registerSource()
เซิร์ฟเวอร์เทคโนโลยีโฆษณาจะตอบกลับด้วยส่วนหัว Attribution-Reporting-Register-Source เพื่อให้การลงทะเบียนแหล่งที่มาเสร็จสมบูรณ์

การลงทะเบียนทริกเกอร์เว็บ

เทคโนโลยีโฆษณาจะลงทะเบียนทริกเกอร์และตรวจสอบความพร้อมใช้งานของระบบปฏิบัติการใน Attribution Reporting API
ARA บนเว็บจะแสดงข้อมูลเกี่ยวกับแพลตฟอร์มที่รองรับ
ส่วนหัว OS-Trigger จะบอกให้ Web ARA API เรียกใช้ฟังก์ชัน registerWebTrigger() ของ OS ARA API
การเรียกใช้ registerWebTrigger() จะเกิดขึ้นเบื้องหลังและนักพัฒนาซอฟต์แวร์ ไม่จำเป็นต้องเรียกใช้ registerWebTrigger() กับระบบปฏิบัติการโดยตรง
ARA ของระบบปฏิบัติการจะเข้าควบคุมและส่งคำขอไปยัง URL ของเซิร์ฟเวอร์เทคโนโลยีโฆษณาที่ระบุโดยส่วนหัว Attribution-Reporting-Register-OS-Trigger
เทคโนโลยีโฆษณาจะลงทะเบียนทริกเกอร์กับ API ของระบบปฏิบัติการให้เสร็จสมบูรณ์
ARA ของระบบปฏิบัติการจะทำการระบุแหล่งที่มาตามตรรกะเดียวกันที่ใช้กับการระบุแหล่งที่มาของแอป<>แอป และส่งรายงานเดียวกัน

ขั้นตอนการทำงาน

ขั้นตอนต่อไปนี้มีรายละเอียดเพิ่มเติมเกี่ยวกับวิธีทำงานให้เสร็จสมบูรณ์

เทคโนโลยีโฆษณาจากแอปจะลงทะเบียนแหล่งที่มากับ Attribution Reporting API ของ Android โดยมีการปรับเปลี่ยนดังนี้
- หากต้องการลงทะเบียนแหล่งที่มาของแอปที่คาดว่าจะทํา Conversion ในเว็บไซต์ Attribution-Reporting-Register-Source ส่วนหัวการตอบกลับควรมีปลายทางเว็บ (eTLD+1) แทนปลายทางแอป
```
Attribution-Reporting-Register-Source: {
    "web_destination": "https://advertiser.example",
    ...
}
```
หมายเหตุ: สำหรับแคมเปญที่อาจทํา Conversion ในปลายทางที่เป็นเว็บ หรือแอป โปรดดูส่วนปลายทางคู่
- ผู้ลงโฆษณาบางรายอาจใช้ผู้ให้บริการวัดผลหลายราย (เช่น เครื่องมือวัดผลของบุคคลที่สามหรือเครื่องมือวิเคราะห์) โดยใช้เชนการเปลี่ยนเส้นทาง 302 ในบางกรณี Attribution Reporting API จะติดตามเส้นทางการเปลี่ยนเส้นทาง ที่ระบุไว้ในส่วนหัว Attribution-Reporting-Redirect ในเบื้องหลัง และในขณะเดียวกันเส้นทางการเปลี่ยนเส้นทาง 302 จะทำงานในเบื้องหน้าสำหรับคำขอการนำทางที่มีอยู่ คำขอเหล่านี้จะส่งไปยัง URL เดียวกันและอาจส่งผลให้ ผู้ให้บริการวัดผลโดยบุคคลที่สามนับการลงทะเบียนซ้ำ เพื่อป้องกันการนับการลงทะเบียนซ้ำ เทคโนโลยีโฆษณาสามารถแก้ไขลักษณะการทำงานของการเปลี่ยนเส้นทาง เพื่อส่งการลงทะเบียน Attribution Reporting API ไปยัง URL ทางเลือกที่ยังคง กำหนดได้
- หากต้องการเปิดใช้ลักษณะการทำงานนี้ เทคโนโลยีโฆษณาต้องใส่ส่วนหัว HTTP ใหม่เมื่อ ตอบกลับคำขอลงทะเบียน
  - ส่วนหัวคือ Attribution-Reporting-Redirect-Config
  - ค่าของส่วนหัวควรเป็น redirect-302-to-well-known
```
Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
```
  หมายเหตุ: การเปลี่ยนเส้นทางทั้งหมดหลังจากส่วนหัวนี้ จะมี .well-known ต่อท้ายที่จุดเริ่มต้นของเส้นทาง URI การเปลี่ยนเส้นทาง
- ส่วนขั้นตอนการลงทะเบียนแหล่งที่มาที่เหลือจะเหมือนกับการลงทะเบียนแหล่งที่มาแบบแอปต่อแอปมาตรฐาน
หมายเหตุ: หากคุณหรือแอปที่เผยแพร่ใช้ WebView เพื่อแสดงโฆษณาในแอป Android โปรดดูส่วนเกี่ยวกับ WebView
เทคโนโลยีโฆษณาในเว็บไซต์ของผู้ลงโฆษณาจะลงทะเบียนทริกเกอร์โดยขอให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับ Android Attribution Reporting API ดังนี้
- เมื่อผู้ใช้ทำ Conversion ในเว็บไซต์เสร็จแล้ว เทคโนโลยีโฆษณาจะส่งคำขอเพื่อลงทะเบียนทริกเกอร์กับ Chrome
  1. ใช้คำขอพิกเซลหรือคำขอ fetch() เพื่อส่งคำขอลงทะเบียนทริกเกอร์ได้
  2. Chrome จะส่งคืนAttribution-Reporting-Supportส่วนหัวของคำขอ ไปยังเทคโนโลยีโฆษณา หากเปิดใช้ API ทั้งในเบราว์เซอร์ Chrome และ อุปกรณ์ Android ส่วนหัวจะส่งคืน os, web
```
Attribution-Reporting-Support: os, web
```
- จากนั้นเทคโนโลยีโฆษณาควรบอกให้ Chrome มอบสิทธิ์ให้ระบบปฏิบัติการโดยใช้ส่วนหัว Attribution-Reporting-Register-OS-Trigger ซึ่งมีลักษณะดังนี้
  1. บอกให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับระบบปฏิบัติการ
  2. Chrome จะมอบสิทธิ์การลงทะเบียนให้กับระบบปฏิบัติการโดยการเรียกฟังก์ชัน API ของระบบปฏิบัติการ registerWebTrigger()
    - การเรียกใช้ registerWebTrigger() จะเกิดขึ้นในเบื้องหลัง เทคโนโลยีโฆษณา ไม่จำเป็นต้องเรียกใช้ registerWebTrigger() โดยตรง
  3. API ของระบบปฏิบัติการจะเริ่มต้นการเรียก API รองไปยัง URI ของเทคโนโลยีโฆษณาที่ส่งต่อ จากเบราว์เซอร์
```
Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
"https://other-adtech.example/register-trigger"
```
- ในบางกรณี Attribution-Reporting-Support ส่วนหัวอาจไม่พร้อมใช้งานและ ส่งไม่ได้ ในกรณีนี้ เทคโนโลยีโฆษณายังคงตั้งค่าแพลตฟอร์มที่ต้องการเพื่อจัดการการลงทะเบียนทริกเกอร์ได้โดยรวมส่วนหัว Attribution-Reporting-Info คีย์คือ preferred-platform และค่าที่อนุญาตคือ os และ web เบราว์เซอร์จะใช้แพลตฟอร์มที่ต้องการ เมื่อพร้อมใช้งาน และจะกลับไปใช้แพลตฟอร์มเว็บเมื่อระบบปฏิบัติการ ไม่พร้อมใช้งาน
หมายเหตุ: ทั้งส่วนหัว Attribution-Reporting-Register-Trigger ที่มีข้อมูลการลงทะเบียนเว็บและส่วนหัว Attribution-Reporting-Register-OS-Trigger ที่มีข้อมูลการลงทะเบียน OS ควรแสดงเมื่อระบุแพลตฟอร์มที่ต้องการเพื่อยืนยันว่าการลงทะเบียนแพลตฟอร์มที่ถูกต้องเกิดขึ้นได้ คุณต้องระบุการลงทะเบียนทั้งในระบบปฏิบัติการและเว็บ เพื่อให้มีข้อมูลที่จำเป็นสำหรับวิธีการสำรองในกรณีที่แพลตฟอร์มที่ต้องการไม่พร้อมใช้งาน
```
Attribution-Reporting-Info: preferred-platform=os
```
- หากต้องการลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์ ปลายทางของเทคโนโลยีโฆษณาควรตอบกลับ คำขอ Attribution Reporting API ของ Android โดยใช้ส่วนหัวการตอบกลับ
```
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"]}
    ],
    ...
}
```
- ส่วนที่เหลือของการลงทะเบียนทริกเกอร์จะยังคงเหมือนเดิม

ลงทะเบียนแหล่งที่มาบนเว็บและทริกเกอร์แอป

สําหรับบางแคมเปญ แหล่งที่มาอาจเกิดขึ้นในเว็บไซต์ในเบราว์เซอร์บนอุปกรณ์เคลื่อนที่ ขณะที่ทริกเกอร์เกิดขึ้นในแอปบนอุปกรณ์เดียวกัน

ตัวอย่าง

ผู้ใช้กำลังท่องเว็บไซต์ในเบราว์เซอร์ Chrome บนโทรศัพท์ Android ลูกค้าเห็นโฆษณาเสื้อกันหนาวจากร้านค้าโปรดร้านหนึ่ง ผู้ใช้คลิกโฆษณาและระบบจะนำไปยังแอปที่ผู้ใช้ดาวน์โหลดไว้แล้ว เทคโนโลยีโฆษณาใน เว็บไซต์ที่แสดงโฆษณาจะลงทะเบียนแหล่งที่มาของการคลิกโดยสั่งให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับ Android Attribution Reporting API แทน การใช้ Attribution Reporting API ใน Chrome ผู้ใช้ซื้อเสื้อสเวตเตอร์ในแอปช็อปปิ้ง จากนั้นเทคโนโลยีโฆษณาในแอปของผู้ลงโฆษณาจะลงทะเบียนทริกเกอร์ Conversion ด้วย Android Attribution Reporting API Attribution Reporting API ระดับระบบปฏิบัติการสามารถจับคู่แหล่งที่มาบนเว็บและทริกเกอร์ของแอป รวมถึงส่งรายงานที่เกี่ยวข้องได้

การลงทะเบียนแหล่งข้อมูลบนเว็บ

เทคโนโลยีโฆษณาจะลงทะเบียนแหล่งที่มาและตรวจสอบความพร้อมใช้งานของระบบปฏิบัติการใน Attribution Reporting API
ARA บนเว็บจะแสดงข้อมูลเกี่ยวกับแพลตฟอร์มที่รองรับ
ส่วนหัว OS-Source จะบอกให้ Web ARA API เรียกใช้ฟังก์ชัน registerWebSource() ของ OS ARA API
การเรียกใช้ registerWebSource() จะเกิดขึ้นเบื้องหลังและนักพัฒนาแอปไม่จำเป็นต้องเรียกใช้ registerWebSource() กับระบบปฏิบัติการโดยตรง
ARA ของระบบปฏิบัติการจะเข้าควบคุมและส่งคำขอไปยัง URL ของเซิร์ฟเวอร์เทคโนโลยีโฆษณาที่ระบุโดยส่วนหัว Attribution-Reporting-Register-OS-Source
เทคโนโลยีโฆษณาจะลงทะเบียนแหล่งที่มากับ OS API ให้เสร็จสมบูรณ์

การลงทะเบียนทริกเกอร์แอป:

SDK เทคโนโลยีโฆษณาในแอป Android ของร้านเสื้อผ้าจะลงทะเบียนทริกเกอร์กับ ARA ของระบบปฏิบัติการ
Attribution Reporting API ใน Android จะส่งคำขอไปยังเซิร์ฟเวอร์เทคโนโลยีโฆษณา URL ที่ระบุไว้ใน registerTrigger()
เซิร์ฟเวอร์เทคโนโลยีโฆษณาจะตอบกลับด้วยAttribution-Reporting-Register-Trigger ส่วนหัวเพื่อลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์
ARA ของระบบปฏิบัติการจะทำการระบุแหล่งที่มาตามตรรกะเดียวกันที่ใช้กับการระบุแหล่งที่มาของแอป<>แอป และส่งรายงานเดียวกัน

ขั้นตอนการทำงาน

เทคโนโลยีโฆษณาในเว็บไซต์ของผู้เผยแพร่โฆษณาจะลงทะเบียนแหล่งที่มาโดยสั่งให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับ Android Attribution Reporting API ดังนี้
- สําหรับกรณีการใช้งานจากเว็บไปยังแอป เมื่อลงทะเบียนแหล่งที่มา คุณต้องระบุพารามิเตอร์แหล่งที่มาของการระบุแหล่งที่มาโดยตรง ไม่ว่าจะโดยใช้แท็ก attributionsrc หรือโดยใช้การลงทะเบียน JavaScript
- ตัวอย่างต่อไปนี้ใช้แท็ก attributionsrc เพื่อระบุ พารามิเตอร์แหล่งที่มา
```
<img src="https://adtech.example/conversionpixel"
attributionsrc="https://adtech.example/register-source?purchase=12">
```
Chrome จะส่งคืนส่วนหัวของคำขอ Attribution-Reporting-Support ไปยังเทคโนโลยีโฆษณา หากเปิดใช้ API ทั้งในเบราว์เซอร์ Chrome และอุปกรณ์ Android ส่วนหัวจะส่งคืน os, web
```
Attribution-Reporting-Support: os, web
```
หมายเหตุ: ต้องเปิดใช้ Attribution Reporting API ในระบบปฏิบัติการ Android เพื่อวัดผลในแอปและเว็บได้สําเร็จ
เทคโนโลยีโฆษณาควรบอกให้ Chrome มอบสิทธิ์ไปยัง API ระดับระบบปฏิบัติการโดยใช้ส่วนหัว Attribution-Reporting-Register-OS-Source ซึ่งมีลักษณะดังนี้
1. บอกให้ Chrome มอบสิทธิ์การลงทะเบียนให้กับระบบปฏิบัติการ
2. Chrome จะมอบสิทธิ์การลงทะเบียนให้กับระบบปฏิบัติการโดยการเรียกฟังก์ชัน API ของระบบปฏิบัติการ registerWebSource()
3. การเรียกใช้ registerWebSource() จะเกิดขึ้นเบื้องหลัง โดยเทคโนโลยีโฆษณาไม่จำเป็นต้องเรียกใช้ registerWebSource() โดยตรง
4. API ของระบบปฏิบัติการจะเริ่มต้นการเรียก API รองไปยัง URI ของเทคโนโลยีโฆษณาที่ส่งต่อจาก เบราว์เซอร์
```
Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
```
- ในบางกรณี Attribution-Reporting-Support ส่วนหัวอาจไม่พร้อมใช้งาน ในกรณีนี้ เทคโนโลยีโฆษณายังคงตั้งค่าแพลตฟอร์มที่ต้องการเพื่อจัดการ การลงทะเบียนแหล่งที่มาได้โดยใส่ส่วนหัว Attribution-Reporting-Info คีย์คือ preferred-platform และค่าที่อนุญาตคือ os และ web เบราว์เซอร์จะใช้แพลตฟอร์มที่ต้องการเมื่อพร้อมใช้งาน และจะกลับไปใช้ แพลตฟอร์มเว็บเมื่อระบบปฏิบัติการไม่พร้อมใช้งาน
หมายเหตุ: ทั้งส่วนหัว Attribution-Reporting-Register-Source ที่มีข้อมูลการลงทะเบียนเว็บและส่วนหัว Attribution-Reporting-Register-OS-Source ที่มีข้อมูลการลงทะเบียน OS ควรแสดงเมื่อระบุแพลตฟอร์มที่ต้องการเพื่อยืนยันว่าการลงทะเบียนแพลตฟอร์มที่ถูกต้องเกิดขึ้นได้ คุณต้องระบุการลงทะเบียนทั้งในระบบปฏิบัติการและเว็บ เพื่อให้มีข้อมูลที่จำเป็นสำหรับวิธีการสำรองในกรณีที่แพลตฟอร์มที่ต้องการไม่พร้อมใช้งาน
```
Attribution-Reporting-Info: preferred-platform=os
```
- หากต้องการลงทะเบียนแหล่งที่มาให้เสร็จสมบูรณ์ ปลายทางของเทคโนโลยีโฆษณาควรตอบกลับ คำขอ Attribution Reporting API ของ Android ด้วยส่วนหัวของการตอบกลับ Attribution-Reporting-Register-Source การตอบกลับควรระบุ ปลายทางของแอปในช่องปลายทางด้วย
```
Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    ...
}
```
- Chrome จะทำตามการเปลี่ยนเส้นทางและเรียกใช้ API บริบทเว็บสำหรับการเปลี่ยนเส้นทางแต่ละครั้งเพื่อรองรับการเปลี่ยนเส้นทางสำหรับการลงทะเบียนแหล่งที่มา
- ส่วนที่เหลือของการจดทะเบียนแหล่งข้อมูลจะยังคงเหมือนเดิม
เทคโนโลยีโฆษณาในแอปของผู้ลงโฆษณาจะลงทะเบียนทริกเกอร์ด้วย Attribution Reporting API ของ Android ดังนี้
- สำหรับทริกเกอร์ที่เกิดขึ้นในแอป แอปจะลงทะเบียนทริกเกอร์กับ Android Attribution Reporting API ตามปกติ

แคมเปญที่มีทั้งแอปและเว็บเป็นปลายทางที่มีศักยภาพ

ตั้งค่าปลายทางคู่
- บางแคมเปญอาจได้รับการตั้งค่าให้ทํา Conversion ในแอปของผู้ลงโฆษณาหรือในหน้าเว็บของผู้ลงโฆษณา โดยขึ้นอยู่กับปัจจัยต่างๆ เช่น ผู้ใช้ได้ติดตั้งแอปหรือไม่
- ในกรณีเหล่านี้ เราขอแนะนำให้มอบสิทธิ์การลงทะเบียนแหล่งที่มาให้กับ OS หากมี เพื่อให้ระบุแหล่งที่มาได้อย่างถูกต้องไม่ว่าทริกเกอร์จะเกิดขึ้นที่ใด ก็ตาม เมื่อลงทะเบียนแหล่งที่มากับระบบปฏิบัติการ คุณจะระบุได้ทั้ง แอปและปลายทางเว็บในพารามิเตอร์ที่เกี่ยวข้อง
- ปลายทางของแอปควรอยู่ในช่อง destination
- ปลายทางบนเว็บควรอยู่ในช่อง web_destination
- นักพัฒนาซอฟต์แวร์ Chrome ควรทราบว่าฟิลด์ destination สำหรับ Attribution Reporting API ของระบบปฏิบัติการ ควรเป็นแพ็กเกจแอป ไม่ใช่ URL
```
Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    "web_destination": "https://example.advertiser"
    ...
}
```
- ส่วนถัดไปเกี่ยวกับการรายงานแบบคร่าวๆ จะอธิบายว่าการใช้ปลายทางคู่ อาจส่งผลต่อสัญญาณรบกวนในรายงานอย่างไร
ใช้การรายงานแบบคร่าวๆ เพื่อลดสัญญาณรบกวนในรายงานระดับเหตุการณ์สําหรับแหล่งที่มาแบบปลายทางคู่
- หากมีการระบุทั้งปลายทางของระบบปฏิบัติการ (แอป) และเว็บในการลงทะเบียนแหล่งที่มา รายงานระดับเหตุการณ์จะระบุว่าทริกเกอร์เกิดขึ้นในปลายทางเว็บหรือปลายทางแอปโดยค่าเริ่มต้น อย่างไรก็ตาม ระบบจะเพิ่มสัญญาณรบกวนลงในรายงานเหล่านี้เพื่อรักษาขีดจำกัดความเป็นส่วนตัว
- เทคโนโลยีโฆษณาสามารถใช้ฟิลด์ coarse_event_report_destinations ภายใต้ส่วนหัว Attribution-Reporting-Register-Source เพื่อเปิดการรายงานแบบคร่าวๆ และลดสัญญาณรบกวน หากแหล่งที่มาที่มีการระบุฟิลด์ coarse_event_report_destinations ชนะการระบุแหล่งที่มา รายงานที่ได้จะมีทั้งปลายทางของแอป และเว็บโดยไม่มีการแยกความแตกต่างว่าทริกเกอร์จริง เกิดขึ้นที่ใด แต่มีสัญญาณรบกวนน้อยกว่ารายงานที่มีการระบุปลายทางของแอปหรือเว็บ
- รายงานรวมจะไม่มีการเปลี่ยนแปลง

สำหรับแอปที่ใช้ Chrome Custom Tabs

บางแอปอาจใช้แท็บที่กำหนดเองเพื่อแสดงเนื้อหาเว็บ แท็บที่กำหนดเองจะทำงาน คล้ายกับหน้าเว็บปกติเมื่อวัดผลในแอปและเว็บไซต์บนอุปกรณ์เคลื่อนที่

ลงทะเบียนแหล่งที่มาของแอปและทริกเกอร์แท็บที่กำหนดเอง
- ทำตามวิธีการเพื่อลงทะเบียนแหล่งที่มาของแอปและทริกเกอร์เว็บ
ลงทะเบียนแหล่งที่มาของแท็บที่กำหนดเองและทริกเกอร์แอป
- ทำตามวิธีการเพื่อลงทะเบียนแหล่งที่มาบนเว็บและทริกเกอร์แอป
ลงทะเบียนแหล่งที่มาของ CCT และทริกเกอร์ CCT
- ระบบจะถือว่าการดำเนินการนี้เหมือนกับการระบุแหล่งที่มาบนเว็บแบบข้ามเว็บไซต์ใน Chrome

สำหรับแอปที่ใช้ WebView

แอปบางแอปอาจใช้ WebView เพื่อแสดงเนื้อหา WebView มี Use Case ที่หลากหลาย เช่น การแสดงโฆษณา การโฮสต์เนื้อหาเว็บ หรือฟีเจอร์แอปที่กำหนดเอง ซึ่งเหมาะกับรูปแบบเว็บมากกว่า

หากต้องการอนุญาตให้ WebView ใช้ Attribution Reporting API คุณต้องกำหนดค่าแอปที่ฝังด้วยสิทธิ์ที่ถูกต้อง
การระบุแหล่งที่มาที่ระดับระบบปฏิบัติการเท่านั้นที่ใช้ได้ใน WebView ส่วนหัว Attribution-Reporting-Support จะแสดงผลเฉพาะระบบปฏิบัติการ และจะแสดงผลก็ต่อเมื่อ Attribution Reporting API ของ Android พร้อมใช้งานเท่านั้น

หมายเหตุ: หากต้องการทําการระบุแหล่งที่มาใน Chrome และ WebView คุณจะต้องมอบสิทธิ์การลงทะเบียนแหล่งที่มาและทริกเกอร์ใน Chrome ให้กับระบบปฏิบัติการ เนื่องจาก WebView รองรับเฉพาะการระบุแหล่งที่มาตามระบบปฏิบัติการเท่านั้น

เมื่อมอบสิทธิ์ให้ระบบปฏิบัติการ WebView อาจใช้ registerSource หรือ registerWebSource และ registerTrigger หรือ registerWebTrigger แอปที่แสดงผล WebView จะเป็นตัวกำหนดว่า WebView ใช้เมธอดใด และจะกำหนดตาม WebView แต่ละรายการ

ความแตกต่างระหว่าง registerSource กับ registerWebSource คือแหล่งที่มา ที่ระบบบันทึกเป็นผู้เผยแพร่โฆษณา เมื่อใช้ registerSource ระบบจะบันทึกแอปเป็นผู้เผยแพร่โฆษณา ตัวอย่างกรณีที่ควรใช้ registerSource คือ แอปของผู้เผยแพร่โฆษณาที่แสดงโฆษณาซึ่งแสดงผลโดยใช้ WebView เมื่อใช้ registerWebSource ระบบจะบันทึกเว็บไซต์ที่โฮสต์ใน WebView เป็น ผู้เผยแพร่โฆษณา ตัวอย่างกรณีที่ควรใช้ registerWebSource คือแอปที่ โฮสต์ WebView และเว็บไซต์ที่ WebView แสดงผล แสดงโฆษณา registerTrigger และ registerWebTrigger มีลักษณะการทำงานคล้ายกัน แผนภูมิในข้อ #3 แสดงรายละเอียดสถานการณ์ต่างๆ เมื่อนักพัฒนาแอปหรือ SDK ต้องการกำหนดค่า API ให้ใช้ registerSource หรือ registerWebSource และ registerTrigger หรือ registerWebTrigger

โดยค่าเริ่มต้น WebView จะใช้ registerSource และ registerWebTrigger เมื่อเรียกใช้ Android Attribution Reporting API ซึ่งจะเชื่อมโยงแหล่งที่มากับ แอปและทริกเกอร์กับต้นทางระดับบนสุดของ URL ใน WebView เมื่อ เกิดทริกเกอร์

หากแอปต้องการลักษณะการทำงานที่แตกต่างออกไป จะต้องใช้วิธีการใหม่ setAttributionRegistrationBehavior ในคลาส androidx.webkit.WebViewSettingsCompat เมธอดนี้จะระบุว่า WebView ควรเรียกใช้ registerWebSource() หรือ registerWebTrigger() แทน registerSource() หรือ registerTrigger()
คุณจะต้องตั้งค่าลักษณะการทำงานนี้สำหรับ WebView แต่ละรายการที่เริ่มต้น
หาก SDK เทคโนโลยีโฆษณาเริ่มต้น WebView SDK จะต้องตั้งค่าลักษณะการทำงานเริ่มต้นนี้
สำหรับแอปที่ต้องการใช้ registerWebSource() เพื่อเชื่อมโยงการลงทะเบียนแหล่งที่มากับเว็บไซต์ใน WebView แทนแอป จะต้องเข้าร่วมรายการที่อนุญาตของ WebApp กรอกแบบฟอร์มนี้เพื่อเข้าร่วมรายการที่อนุญาต จุดประสงค์ของรายการที่อนุญาตคือเพื่อลดข้อควรพิจารณาด้านความเป็นส่วนตัวเกี่ยวกับ การสร้างความน่าเชื่อถือสำหรับบริบทของเว็บ

ค่า	คำอธิบาย	ตัวอย่าง Use Case
APP_SOURCE_AND_WEB_TRIGGER (ค่าเริ่มต้น)	อนุญาตให้แอปจดทะเบียนแหล่งที่มาของแอป (แหล่งที่มาที่เชื่อมโยงกับชื่อแพ็กเกจของแอป) และทริกเกอร์เว็บ (ทริกเกอร์ที่เชื่อมโยงกับ eTLD+1) จาก WebView	แอปที่ใช้ WebView เพื่อแสดงโฆษณาแทนที่จะเปิดใช้การท่องเว็บ
WEB_SOURCE_AND_WEB_TRIGGER	อนุญาตให้แอปจดทะเบียนแหล่งข้อมูลบนเว็บและทริกเกอร์บนเว็บจาก WebView	แอปเบราว์เซอร์ที่ใช้ WebView ซึ่งการแสดงโฆษณาและ Conversion อาจเกิดขึ้นทั้งในเว็บไซต์ใน WebView
APP_SOURCE_AND_APP_TRIGGER	อนุญาตให้แอปจดทะเบียนแหล่งที่มาของแอปและทริกเกอร์ของแอปจาก WebView	แอปที่ใช้ WebView ซึ่งการแสดงโฆษณาและ Conversion ควรเชื่อมโยงกับแอปเสมอ ไม่ใช่ eTLD+1 ของ WebView
ปิดใช้อยู่	ปิดใช้การลงทะเบียนแหล่งที่มาและทริกเกอร์จาก WebView

ลงทะเบียนแหล่งที่มาและทริกเกอร์จาก WebView
เทคโนโลยีโฆษณาควรตอบกลับการลงทะเบียนแหล่งที่มาโดยใช้ส่วนหัว Attribution-Reporting-Register-OS-Source ตามลักษณะการทำงานที่ตั้งไว้ สำหรับ WebView การดำเนินการนี้จะเรียก registerSource() หรือ registerWebSource() ด้วยระบบปฏิบัติการ และเริ่มการเรียก API รองจาก Attribution Reporting API ของ Android ไปยัง URI ของเทคโนโลยีโฆษณา
- หากต้องการลงทะเบียนแหล่งที่มาให้เสร็จสมบูรณ์ ปลายทางของเทคโนโลยีโฆษณาควร ตอบสนองต่อคำขอ Android Attribution Reporting API ด้วย ส่วนหัวของการตอบสนอง
```
 Attribution-Reporting-Register-OS-Source: {
  "source_event_id":"123001",
  "destination":"android-app://com.example.advertiser",
  ...
}
```
ส่วนที่เหลือของการจดทะเบียนแหล่งข้อมูลจะยังคงเหมือนเดิม
เทคโนโลยีโฆษณาควรตอบสนองต่อการลงทะเบียนทริกเกอร์โดยใช้ส่วนหัว Attribution-Reporting-Register-OS-Trigger ตามลักษณะการทำงานที่ตั้งไว้สำหรับ WebView การดำเนินการนี้จะเรียกใช้ registerTrigger() หรือ registerWebTrigger() ด้วยระบบปฏิบัติการ และเริ่มการเรียก API รองจาก Rb ไปยัง URI ของเทคโนโลยีโฆษณา
หากต้องการลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์ ปลายทางของเทคโนโลยีโฆษณาควร ตอบสนองต่อคำขอ Android Attribution Reporting API ด้วยส่วนหัว การตอบสนอง

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"]}
    ],
    ...
}

ส่วนที่เหลือของกระบวนการการลงทะเบียนทริกเกอร์จะยังคงเหมือนเดิม

แก้ไขข้อบกพร่อง

เมื่อตั้งค่าการติดตั้งใช้งานแอปกับเว็บ ขอแนะนำให้ตั้งค่ารายงานข้อบกพร่องเพื่อยืนยันว่าระบบลงทะเบียนแหล่งที่มาและทริกเกอร์อย่างถูกต้องหรือไม่ และหากไม่ได้ลงทะเบียน ให้รับข้อมูลเกี่ยวกับสาเหตุ

ดูขั้นตอนการแก้ไขข้อบกพร่องของการรายงานการระบุแหล่งที่มาทั่วไปได้ที่คู่มือการแก้ไขข้อบกพร่อง