กรองแหล่งที่มาก่อนการระบุแหล่งที่มาโดยใช้ขอบเขตการระบุแหล่งที่มา

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

ขอบเขตการระบุแหล่งที่มาช่วยให้ผู้เรียก API ระบุรายการสตริงระหว่างการลงทะเบียนแหล่งที่มาและทริกเกอร์ได้ ซึ่งสามารถใช้สําหรับการกรองก่อนที่จะมีการระบุแหล่งที่มา ซึ่งช่วยให้กรองข้อมูลได้ละเอียดยิ่งขึ้นเพื่อเพิ่มประสิทธิภาพของ API และเพิ่มความยืดหยุ่น เช่น ช่วยให้ติดตามผู้ลงโฆษณาแยกกันในเว็บไซต์เดียวกันได้อย่างชัดเจน และยังช่วยให้ติดตามแคมเปญหรือผลิตภัณฑ์หลายรายการภายในแบนเนอร์โฆษณาเดียวได้อีกด้วย

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

ระหว่างการลงทะเบียนแหล่งที่มา

ระบบจะเพิ่มพารามิเตอร์ที่ไม่บังคับ attribution_scopes ลงในส่วนหัว Attribution-Reporting-Register-Source ซึ่งมีพารามิเตอร์ที่จําเป็น 2 รายการ ได้แก่ values และ limit และพารามิเตอร์ที่ไม่บังคับ 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 จะได้รับรายงานการระบุแหล่งที่มาซึ่งระบุการลงทะเบียนทริกเกอร์เป็นการลงทะเบียนแหล่งที่มาแรก

ขอบเขตการระบุแหล่งที่มาเทียบกับตัวกรอง

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

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

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />

ก่อนการระบุแหล่งที่มา

• แหล่งที่มา #1 ถูกกรองออกเนื่องจากขอบเขตการระบุแหล่งที่มาไม่ตรงกับขอบเขตของทริกเกอร์ casualwear การมีลําดับความสําคัญสูงสุดในแหล่งที่มาทั้งหมดที่มีอยู่ไม่ได้ป้องกันไม่ให้ระบบกรองออกเนื่องจากการกรองก่อนการระบุแหล่งที่มาเกิดขึ้นก่อนการตรวจสอบลําดับความสําคัญ
• แหล่งที่มา #2 ยังถูกกรองออกด้วยเนื่องจากไม่มีขอบเขตเดียวกับทริกเกอร์ แหล่งที่มานี้ยังมีตัวกรองเดียวกับทริกเกอร์ด้วย แต่ระบบจะไม่ใช้ตัวกรองระดับสูงจนกว่าจะทำการระบุแหล่งที่มา

ในระหว่างการระบุแหล่งที่มา

• ระบบไม่ได้เลือกแหล่งที่มา #3 สำหรับการระบุแหล่งที่มาเนื่องจากมีลําดับความสําคัญต่ำกว่าแหล่งที่มา #4
• ระบบเลือกแหล่งที่มา #4 เนื่องจากมีขอบเขตการระบุแหล่งที่มาที่ตรงกับทริกเกอร์และมีลําดับความสําคัญสูงสุด ระบบจะใช้ตัวกรองระดับสูงหลังการระบุแหล่งที่มา ดังนั้นตัวกรองดังกล่าวจึงไม่มีการพิจารณาในระหว่างกระบวนการระบุแหล่งที่มา

การระบุแหล่งที่มาของโพสต์

• ระบบจะไม่สร้างรายงานเนื่องจากตัวกรองระดับสูงของแหล่งที่มาที่เลือก (แหล่งที่มา #4) กับทริกเกอร์ไม่ตรงกัน

ตัวอย่างก่อนหน้านี้จะไม่สร้างรายงาน อย่างไรก็ตาม หากนําแหล่งที่มาที่ 4 ออกทั้งหมด ระบบจะดำเนินการดังนี้

ในระหว่างการระบุแหล่งที่มา

• ระบบเลือกแหล่งที่มา #3 เนื่องจากมีขอบเขตการระบุแหล่งที่มาที่ตัดกับทริกเกอร์

การระบุแหล่งที่มาของโพสต์

• แหล่งที่มา #3 ไม่ถูกปฏิเสธเนื่องจากตัวกรองของแหล่งที่มานี้ตัดกับตัวกรองในทริกเกอร์ จากนั้นการระบุแหล่งที่มาจะเข้าสู่การตรวจสอบหลังการระบุแหล่งที่มาที่เหลือ ซึ่งจะสิ้นสุดด้วยการสร้างรายงานหากผ่านการตรวจสอบทั้งหมด

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

ตำแหน่งของขอบเขตการระบุแหล่งที่มาในขั้นตอนการระบุแหล่งที่มา

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

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="รูปภาพที่แสดงขั้นตอนของการระบุแหล่งที่มาเวอร์ชันที่เข้าใจง่าย โดยแต่ละขั้นตอนแสดงเป็นสี่เหลี่ยมจัตุรัสที่ลิงก์กับขั้นตอนถัดไปด้วยลูกศร ขั้นตอนตามลําดับคือ " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />

การดำเนินการในขั้นตอนการระบุแหล่งที่มา

ต่อไปนี้เป็นสรุปการดำเนินการต่างๆ ที่เกิดขึ้นระหว่างขั้นตอนการระบุแหล่งที่มา

• การลงทะเบียนแหล่งที่มา: ระบบจะบันทึกเหตุการณ์แหล่งที่มาเมื่อผู้ใช้โต้ตอบกับโฆษณาในเว็บไซต์ของผู้ลงโฆษณา จากนั้นอุปกรณ์จะส่งคําขอไปยังปลายทางของแหล่งที่มาของการรายงาน ซึ่งจะตอบกลับด้วยส่วนหัวที่มีข้อมูลเหตุการณ์ของแหล่งที่มา
• การบันทึกทริกเกอร์: ระบบจะบันทึกเหตุการณ์ทริกเกอร์เมื่อเกิด Conversion บนเว็บไซต์ของผู้ลงโฆษณา อุปกรณ์จะส่งคําขออีกรายการไปยังต้นทางการรายงาน ซึ่งจะตอบกลับด้วยส่วนหัวที่มีข้อมูลเหตุการณ์ทริกเกอร์
• การจับคู่แหล่งที่มา: อุปกรณ์จะจับคู่แหล่งที่มาและเหตุการณ์ทริกเกอร์ตามเกณฑ์ เช่น เว็บไซต์ปลายทาง แหล่งที่มาของการรายงาน และการหมดอายุ
• การตรวจสอบขอบเขตการระบุแหล่งที่มา: ระบบจะกรองแหล่งที่มาตามส่วนที่ตัดกันระหว่างค่าแหล่งที่มาและค่า attribution_scopes ของทริกเกอร์
• การระบุแหล่งที่มา: อุปกรณ์จะเลือกแหล่งที่มาที่มีลําดับความสําคัญสูงสุดสําหรับการระบุแหล่งที่มาหากมีแหล่งที่มาหลายแหล่งที่ตรงกัน หากลําดับความสําคัญเท่ากัน ระบบจะเลือกรายการล่าสุด
• การตรวจสอบตัวกรอง: อุปกรณ์จะเปรียบเทียบตัวกรองแหล่งที่มาและตัวกรองทริกเกอร์เพื่อดูว่าตรงกันหรือไม่ หากตัวกรองไม่ตรงกัน ระบบจะไม่ระบุแหล่งที่มา
• การปิดใช้งานแหล่งที่มาอื่นๆ: หากตัวกรองของแหล่งที่มาที่เลือกตรงกัน อุปกรณ์จะปิดใช้งานแหล่งที่มาที่ตรงกันในระยะการจับคู่แหล่งที่มา แหล่งที่มาที่ปิดใช้งานจะรวมถึงแหล่งที่มาที่มีขอบเขตการระบุแหล่งที่มาไม่ตรงกับขอบเขตทริกเกอร์
• การตรวจสอบหลังการระบุแหล่งที่มา: อุปกรณ์จะดำเนินการตรวจสอบเพิ่มเติมเกี่ยวกับการระบุแหล่งที่มาที่เลือก เช่น ตรวจสอบว่าแหล่งที่มามีรายงานปลอมหรือไม่ ตรวจสอบการระบุแหล่งที่มาที่ซ้ำกันโดยใช้คีย์การกรองข้อมูลที่ซ้ำกันออก ตรวจสอบว่าทริกเกอร์อยู่ภายในกรอบเวลารายงานของแหล่งที่มาหรือไม่ และตรวจสอบขีดจํากัดอัตรา
• การสร้างรายงาน: หากการตรวจสอบทั้งหมดผ่าน อุปกรณ์จะสร้างและกําหนดเวลารายงานการระบุแหล่งที่มาเพื่อส่งไปยังปลายทางของแหล่งที่มาของการรายงาน

ขั้นตอนถัดไป

• อ่านข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตการระบุแหล่งที่มาในคำอธิบายการกรองก่อนการระบุแหล่งที่มาใน GitHub
• อ่านเพิ่มเติมเกี่ยวกับตัวกรองในหัวข้อกําหนดกฎลูกค้าโดยใช้ตัวกรอง