ขอบเขตการระบุแหล่งที่มาช่วยให้ผู้เรียก API ระบุรายการสตริงในระหว่างการลงทะเบียนแหล่งที่มาและทริกเกอร์ได้ ซึ่งใช้ในการกรองก่อนที่จะมีการระบุแหล่งที่มา ซึ่งจะช่วยให้การกรองมีความละเอียดมากขึ้นเพื่อเพิ่มประสิทธิภาพ API และมอบความยืดหยุ่นมากขึ้น เช่น ช่วยให้ติดตามผู้ลงโฆษณาที่แยกต่างหากในเว็บไซต์เดียวกันได้อย่างชัดเจน นอกจากนี้ ยังช่วยให้ติดตามแคมเปญหรือผลิตภัณฑ์หลายรายการภายในแบนเนอร์โฆษณาเดียวได้อีกด้วย
ขอบเขตการระบุแหล่งที่มาเป็นช่องที่ไม่บังคับซึ่งตั้งค่าได้ในระหว่างการลงทะเบียนแหล่งที่มาและทริกเกอร์ ในระหว่างการระบุแหล่งที่มา ระบบจะพิจารณาเฉพาะแหล่งที่มาซึ่งค่าขอบเขตการระบุแหล่งที่มามีค่าขอบเขตการระบุแหล่งที่มาของทริกเกอร์อย่างน้อย 1 ค่าสำหรับการระบุแหล่งที่มา หากไม่ได้ระบุขอบเขตในทริกเกอร์ ระบบจะพิจารณาแหล่งที่มาทั้งหมด ก่อนดำเนินการต่อ คุณควรทำความคุ้นเคยกับ Attribution Reporting API และตัวกรองระดับสูง
ระหว่างการลงทะเบียนแหล่งข้อมูล
ระบบจะเพิ่มพารามิเตอร์ที่ไม่บังคับ attribution_scopes ลงในส่วนหัว Attribution-Reporting-Register-Source ซึ่งมีพารามิเตอร์ที่จำเป็น 2 รายการ ได้แก่ ค่าและขีดจํากัด และพารามิเตอร์ที่ไม่บังคับ 1 รายการ ได้แก่ max_event_states
- limit: แสดงจำนวนขอบเขตที่ไม่ซ้ำกันทั้งหมดที่อนุญาตต่อปลายทางสำหรับแหล่งที่มาของการรายงาน ระบบจะลบแหล่งที่มาที่ลงทะเบียนไว้แล้วซึ่งมีต้นทางและปลายทางการรายงานเดียวกัน แต่มีขีดจํากัดน้อยกว่า
- values: แสดงรายการขอบเขตการระบุแหล่งที่มาสำหรับแหล่งที่มาหนึ่งๆ ค่าเหล่านี้ต้องเป็นสตริงที่มีความยาวสูงสุด 50
- max_event_states (ไม่บังคับ): แสดงจํานวนสถานะเหตุการณ์สูงสุดที่ผู้เรียก API วางแผนที่จะใช้ในการลงทะเบียนแหล่งที่มาของเหตุการณ์ในอนาคตทั้งหมด โปรดทราบว่าระบบจะลบแหล่งที่มาที่ลงทะเบียนไว้แล้วซึ่งมีต้นทางและปลายทางการรายงานเดียวกัน แต่มี
max_event_states valueต่างกัน ค่าเริ่มต้นสำหรับฟิลด์ที่ไม่บังคับนี้คือ 3
ตัวอย่างการลงทะเบียนแหล่งที่มา
Attribution-Reporting-Register-source: {
//optional
"attribution_scopes":{
"limit": <int>,
"values": <list of strings>,
// optional
"max_event_states": <int>
},
...
}
ระหว่างการลงทะเบียนทริกเกอร์
ระบบจะเพิ่มพารามิเตอร์ที่ไม่บังคับ attribution_scopes ลงในส่วนหัว Attribution-Reporting-Register-Trigger ระหว่างการลงทะเบียนทริกเกอร์ ตรวจสอบว่าค่าพารามิเตอร์เป็นรายการสตริงที่แสดงขอบเขตของทริกเกอร์ ทริกเกอร์จะจับคู่เฉพาะแหล่งที่มาซึ่งพารามิเตอร์ค่า attribution_scopes มี attribution_scopes ของทริกเกอร์อย่างน้อย 1 รายการ หากมีการระบุ
ตัวอย่างการลงทะเบียนทริกเกอร์
Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}
ตัวอย่างขอบเขตการระบุแหล่งที่มา
ตัวอย่างต่อไปนี้แสดงกรณีที่ทริกเกอร์ได้รับการระบุแหล่งที่มาเป็นแหล่งที่มาขณะใช้ขอบเขตการระบุแหล่งที่มา
การลงทะเบียนแหล่งที่มา #1
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser1"],
"max_event_states": 3
},
...
}
การลงทะเบียนแหล่งที่มา #2
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser2"],
"max_event_states": 3
},
...
}
การลงทะเบียนทริกเกอร์
Attribution-Reporting-Register-Trigger: {
"attribution_scopes": ["advertiser1"],
...
}
เมื่อมีการลงทะเบียนทริกเกอร์ API จะเลือกแหล่งที่มาที่จะนำมาพิจารณาสำหรับการระบุแหล่งที่มาซึ่งมีค่า attribution_scopes ที่ตัดกับค่าในการลงทะเบียนทริกเกอร์ การลงทะเบียนแหล่งที่มาที่ตรงกันจะดำเนินการต่อในขั้นตอนการระบุแหล่งที่มาที่เหลือ ในตัวอย่างนี้ ผู้เรียก API จะได้รับรายงานการระบุแหล่งที่มาซึ่งระบุการลงทะเบียนทริกเกอร์เป็นการลงทะเบียนแหล่งที่มาครั้งแรก
ขอบเขตการระบุแหล่งที่มาเทียบกับตัวกรอง
แม้ว่าฟังก์ชันการทำงานของขอบเขตการระบุแหล่งที่มาและตัวกรองอาจดูคล้ายกัน แต่ปัจจัยที่แตกต่างกันคือตำแหน่งที่ใช้ในขั้นตอนการลงทะเบียนทริกเกอร์ การกรองขอบเขตการระบุแหล่งที่มาจะเกิดขึ้นก่อนการระบุแหล่งที่มา ซึ่งหมายความว่าระบบจะลดกลุ่มแหล่งที่มาที่เป็นผู้สมัครรับเลือกตั้งที่ยังไม่หมดอายุซึ่งมีเว็บไซต์ปลายทางและต้นทางการรายงานเดียวกัน โดยอิงตามแหล่งที่มาที่มีขอบเขตที่ทับซ้อนกับขอบเขตที่พบในทริกเกอร์ อย่างไรก็ตาม ระบบจะใช้ตัวกรองระดับบนสุดหลังจากที่ระบุแหล่งที่มาของทริกเกอร์เป็นแหล่งที่มาเดียว หากตัวกรองแหล่งที่มาและทริกเกอร์ไม่ตัดกัน ระบบจะไม่สร้างรายงาน
รูปภาพต่อไปนี้แสดงกลุ่มแหล่งที่มาและทริกเกอร์ที่มีเว็บไซต์ปลายทางและแหล่งที่มาของการรายงานเดียวกัน และยังไม่หมดอายุ เราจะพูดถึงวิธีใช้ขอบเขตการระบุแหล่งที่มาและตัวกรองโดยย่อ รวมถึงดูว่าระบบจะสร้างรายงานตามแหล่งที่มาและทริกเกอร์ที่มีอยู่หรือไม่
ก่อนการระบุแหล่งที่มา
- ระบบจะกรองแหล่งที่มา #1 ออกเนื่องจากขอบเขตการระบุแหล่งที่มาไม่ตรงกับขอบเขตของทริกเกอร์ของ
casualwearการมีลำดับความสำคัญสูงสุดในบรรดาแหล่งที่มาทั้งหมดที่มีอยู่ไม่ได้ป้องกันไม่ให้ระบบกรองออก เนื่องจากระบบจะกรองก่อนการระบุแหล่งที่มาก่อนที่จะตรวจสอบลำดับความสำคัญ - ระบบจะกรองแหล่งที่มา #2 ออกด้วยเนื่องจากไม่มีขอบเขตเดียวกันกับทริกเกอร์ แหล่งที่มานี้ยังมีตัวกรองเดียวกันกับทริกเกอร์ด้วย แต่ระบบจะไม่ใช้ตัวกรองระดับสูงจนกว่าจะมีการระบุแหล่งที่มา
ระหว่างการระบุแหล่งที่มา
- ระบบไม่ได้เลือกแหล่งที่มา #3 สำหรับการระบุแหล่งที่มาเนื่องจากมีลำดับความสำคัญต่ำกว่าแหล่งที่มา #4
- ระบบเลือกแหล่งที่มา #4 เนื่องจากมีขอบเขตการระบุแหล่งที่มาที่ตรงกับทริกเกอร์และมีลำดับความสำคัญสูงสุด ตัวกรองระดับสูงจะใช้หลังการระบุแหล่งที่มา จึงไม่นำมาพิจารณาในกระบวนการระบุแหล่งที่มา
การระบุแหล่งที่มาของโพสต์
- ระบบจะไม่สร้างรายงานเนื่องจากตัวกรองระดับสูงสำหรับแหล่งที่มาที่เลือก (แหล่งที่มา #4) และทริกเกอร์ไม่ตัดกัน
ตัวอย่างก่อนหน้าไม่ได้ทำให้ระบบสร้างรายงาน แต่หากนำแหล่งที่มาที่ 4 ออกทั้งหมด
ระหว่างการระบุแหล่งที่มา
- ระบบเลือกแหล่งที่มา #3 เนื่องจากมีขอบเขตการระบุแหล่งที่มาที่ทับซ้อนกับทริกเกอร์
การระบุแหล่งที่มาของโพสต์
- ระบบจะไม่ปฏิเสธแหล่งที่มา #3 เนื่องจากตัวกรองของแหล่งที่มาดังกล่าวตัดกับตัวกรองในทริกเกอร์ จากนั้นการระบุแหล่งที่มาจะผ่านการตรวจสอบการระบุแหล่งที่มาหลังการแปลงส่วนที่เหลือ โดยจะสิ้นสุดด้วยการสร้างรายงานหากผ่านการตรวจสอบทั้งหมด
ขอบเขตการระบุแหล่งที่มาจะลดจำนวนแหล่งที่มาที่พิจารณาสำหรับการระบุแหล่งที่มา จากนั้นระบบจะใช้ขั้นตอนการระบุแหล่งที่มาที่เหลือกับกลุ่มแหล่งที่มาที่เล็กลงนี้ ซึ่งอาจส่งผลให้เกิดรายงาน
ตำแหน่งของขอบเขตการระบุแหล่งที่มาในขั้นตอนการระบุแหล่งที่มา
ระบบจะใช้ขอบเขตการระบุแหล่งที่มาก่อนที่จะเลือกแหล่งที่มาสำหรับการระบุแหล่งที่มา นอกจากนี้ ยังมีลำดับความสำคัญสูงกว่าตัวกรองระดับบนสุดและการกรองหน้าต่างรายงานที่กำหนดเองด้วย แผนภาพต่อไปนี้แสดงโฟลว์การระบุแหล่งที่มาโดยรวมเวอร์ชันที่ง่ายขึ้น โดยมีขอบเขตการระบุแหล่งที่มาก่อนการระบุแหล่งที่มาและการตรวจสอบการระบุแหล่งที่มาอื่นๆ
การดำเนินการโฟลว์การระบุแหล่งที่มา
ต่อไปนี้คือสรุปการดำเนินการต่างๆ ที่ทำในระหว่างขั้นตอนการระบุแหล่งที่มา
- การลงทะเบียนแหล่งที่มา: เมื่อผู้ใช้โต้ตอบกับโฆษณาในเว็บไซต์ของผู้ลงโฆษณา ระบบจะลงทะเบียนเหตุการณ์แหล่งที่มา จากนั้นอุปกรณ์จะส่งคำขอไปยังปลายทางของต้นทางการรายงาน ซึ่งจะตอบกลับด้วยส่วนหัวที่มีข้อมูลเหตุการณ์ต้นทาง
- การลงทะเบียนทริกเกอร์: เมื่อเกิด Conversion บนเว็บไซต์ของผู้ลงโฆษณา ระบบจะลงทะเบียนเหตุการณ์ทริกเกอร์ อุปกรณ์จะส่งคำขออีกรายการไปยังต้นทางของการรายงาน ซึ่งจะตอบกลับด้วยส่วนหัวที่มีข้อมูลเหตุการณ์ทริกเกอร์
- การจับคู่แหล่งที่มา: อุปกรณ์จะจับคู่แหล่งที่มาและเหตุการณ์ทริกเกอร์ตามเกณฑ์ต่างๆ เช่น เว็บไซต์ปลายทาง ต้นทางการรายงาน และการหมดอายุ
- การตรวจสอบขอบเขตการระบุแหล่งที่มา: ระบบจะกรองแหล่งที่มาตามจุดตัดระหว่างค่า source และ trigger attribution_scopes
- การระบุแหล่งที่มา: อุปกรณ์จะเลือกแหล่งที่มาที่มีลำดับความสำคัญสูงสุดสำหรับการระบุแหล่งที่มา หากมีแหล่งที่มาหลายรายการที่ตรงกัน หากลำดับความสำคัญเท่ากัน ระบบจะเลือกรายการล่าสุด
- การตรวจสอบตัวกรอง: อุปกรณ์จะเปรียบเทียบตัวกรองแหล่งที่มาและทริกเกอร์เพื่อพิจารณาว่าตรงกันหรือไม่ หากตัวกรองไม่ตรงกัน ระบบจะทิ้งการระบุแหล่งที่มา
- การปิดใช้งานแหล่งที่มาอื่นๆ: หากตัวกรองของแหล่งที่มาที่เลือกตรงกัน อุปกรณ์จะปิดใช้งานแหล่งที่มาที่ตรงกันในระหว่างขั้นตอนการจับคู่แหล่งที่มา แหล่งที่มาที่ปิดใช้งานจะรวมแหล่งที่มาที่มีขอบเขตการระบุแหล่งที่มาไม่ตรงกับขอบเขตทริกเกอร์
- การตรวจสอบหลังการระบุแหล่งที่มา: อุปกรณ์จะทำการตรวจสอบเพิ่มเติมเกี่ยวกับการระบุแหล่งที่มาที่เลือก เช่น ตรวจสอบว่าแหล่งที่มามีรายงานปลอมหรือไม่ ตรวจสอบการระบุแหล่งที่มาที่ซ้ำกันโดยใช้คีย์การขจัดข้อมูลที่ซ้ำกัน ตรวจสอบว่าทริกเกอร์อยู่ภายในหน้าต่างรายงานของแหล่งที่มาหรือไม่ และตรวจสอบขีดจํากัดอัตรา
- การสร้างรายงาน: หากการตรวจสอบทั้งหมดผ่าน อุปกรณ์จะสร้างและกำหนดเวลารายงานการระบุแหล่งที่มาเพื่อส่งไปยังปลายทางของต้นทางการรายงาน
ขั้นตอนถัดไป
- อ่านเพิ่มเติมเกี่ยวกับขอบเขตการระบุแหล่งที่มาในคำอธิบาย GitHub เกี่ยวกับการกรองก่อนการระบุแหล่งที่มา
- อ่านเพิ่มเติมเกี่ยวกับตัวกรองได้ในกําหนดกฎลูกค้าโดยใช้ตัวกรอง