فلترة المصادر قبل تحديد المصدر باستخدام نطاقات تحديد المصدر

تسمح نطاقات تحديد المصدر لمستدعي واجهة برمجة التطبيقات بتحديد قائمة من السلاسل أثناء تسجيل المصدر والمشغّل، ويمكن استخدامها في الفلترة قبل تحديد المصدر. يتيح ذلك إجراء فلترة أكثر دقة لزيادة كفاءة واجهة برمجة التطبيقات وتوفير المزيد من المرونة. على سبيل المثال، تتيح هذه الميزة تتبُّع المعلِنين المنفصلين على الموقع الإلكتروني نفسه بشكل مميّز. ويسهّل أيضًا تتبُّع حملات أو منتجات متعدّدة ضمن بانر إعلاني واحد.

نطاقات تحديد المصدر هي حقول اختيارية يمكن ضبطها أثناء تسجيل المصدر والمشغّل. أثناء تحديد المصدر، لن يتم أخذ سوى المصادر التي تحتوي قيم نطاق تحديد المصدر فيها على قيمة واحدة على الأقل من قيم نطاق تحديد المصدر الخاصة بمشغّل الإحالة. في حال عدم تحديد نطاق في المشغّل، سيتم أخذ جميع المصادر في الاعتبار. قبل المتابعة، يجب أن تكون على دراية بواجهة برمجة التطبيقات لإعداد تقارير تحديد المصدر والفلاتر العالية المستوى.

أثناء تسجيل المستند المصدر

تتم إضافة مَعلمة اختيارية attribution_scopes إلى العنوان Attribution-Reporting-Register-Source الذي يحتوي على مَعلمتَين مطلوبتَين: القيم والحدّ، ومَعلمة اختيارية واحدة: max_event_states.

• limit: يمثّل إجمالي عدد النطاقات المميّزة المسموح بها لكل وجهة لمصدر إعداد التقارير. سيتم حذف أي مصادر مسجّلة حالية لها المصدر والوجهة نفسها لإعداد التقارير، ولكن بحدّ أصغر.
• القيم: تمثّل قائمة بنطاقات تحديد المصدر لمصدر معيّن. يجب أن تكون هذه القيم سلاسل يبلغ الحد الأقصى لطولها 50 حرفًا.
• max_event_states (اختياري): يمثّل الحدّ الأقصى لعدد حالات الأحداث التي يخطّط طالب بيانات من واجهة برمجة التطبيقات لاستخدامها في جميع عمليات تسجيل مصادر الأحداث اللاحقة. يُرجى العِلم أنّه سيتم حذف أي مصادر مسجّلة حالية لها مصدر تقارير ووجهة متطابقان ولكن 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 الخاصة بالمشغّل، إذا تم تحديدها.

نموذج تسجيل المشغّل

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

عند تسجيل عامل التشغيل، تختار واجهة برمجة التطبيقات مصادر يجب أخذها في الاعتبار لتحديد المصدر، وتتضمّن هذه المصادر قيمًا في attribution_scopes تتقاطع مع القيم في عملية تسجيل عامل التشغيل. ستستمر عمليات تسجيل المصدر المطابق مع بقية مسار تحديد المصدر. في هذا المثال، سيتلقّى طالب البيانات من واجهة برمجة التطبيقات تقرير تحديد مصدر ينسب تسجيل المشغّل إلى تسجيل المصدر الأول.

نطاقات تحديد المصدر مقابل الفلاتر

على الرغم من أنّ وظيفة نطاقات الإحالة والفلاتر قد تبدو متشابهة، فإنّ العامل المميّز هو مكان تطبيقها في مسار تسجيل المشغِّل. تتم فلترة نطاقات تحديد المصدر قبل تحديد المصدر. وهذا يعني أنّه يقلّل من مجموعة المصادر المرشّحة غير المنتهية الصلاحية التي تتضمّن الموقع الإلكتروني الوجهة نفسه ومصدر إعداد التقارير نفسه، وذلك استنادًا إلى المصادر التي تتضمّن نطاقات تتداخل مع النطاقات المتوفّرة في عامل التشغيل. ومع ذلك، يتم تطبيق الفلاتر على أعلى مستوى بعد تحديد مصدر واحد للمشغّل. إذا لم تتقاطع فلاتر المصدر وفلاتر المشغّل، لن يتم إنشاء أي تقارير.

تعرض الصورة التالية مجموعة من المصادر ومشغّلاً لهما الموقع الجغرافي الوجهة ومنشأ إعداد التقارير نفسهما، وهما غير منتهيتَي الصلاحية. سنتحدّث بإيجاز عن كيفية استخدام نطاقات تحديد المصدر والفلاتر وما إذا كان سيتم إنشاء تقرير استنادًا إلى المصادر وعوامل التشغيل المتاحة.

قبل تحديد المصدر

• تمت فلترة المصدر رقم 1 لأنّ نطاق تحديد المصدر لا يتطابق مع نطاق المشغّل casualwear. لا يمنع حصول المصدر على الأولوية القصوى بين جميع المصادر المتاحة من استبعاده من خلال الفلترة المسبقة لتحديد المصدر، لأنّ هذه الفلترة تتم قبل التحقّق من الأولويات.
• يتم أيضًا استبعاد المصدر رقم 2 لأنّه لا يتضمّن النطاق نفسه الذي يتضمّنه المشغّل. يتضمّن مصدر البيانات هذا أيضًا الفلتر نفسه المستخدَم في المشغّل، ولكن لا يتم تطبيق الفلاتر ذات المستوى الأعلى إلا بعد تحديد المصدر.

أثناء تحديد المصدر

• لم يتم اختيار المصدر رقم 3 لتحديد المصدر لأنّ أولويته أقل من المصدر رقم 4.
• تم اختيار المصدر رقم 4 لأنّه يتضمّن نطاق تحديد مصدر مطابقًا للمشغّل ولديه الأولوية القصوى. يتم تطبيق الفلاتر ذات المستوى العالي بعد تحديد المصدر، لذا لا يتم أخذها في الاعتبار أثناء عملية تحديد المصدر.

تحديد مصدر المشاركة

• لم يتم إنشاء أي تقرير لأنّ الفلاتر ذات المستوى العالي للمصدر المحدّد (المصدر رقم 4) وعامل التشغيل لا يتقاطعان.

لا يؤدي المثال السابق إلى إنشاء تقرير. في المقابل، إذا تمت إزالة المصدر الرابع بالكامل:

أثناء تحديد المصدر

• تم اختيار المستند المصدر رقم 3 لأنّ له نطاق تحديد مصدر متقاطع مع عبارة التشغيل.

تحديد مصدر المشاركة

• لم يتم رفض المصدر رقم 3 لأنّ الفلتر الخاص به يتقاطع مع الفلتر في المشغّل. بعد ذلك، ستخضع عملية تحديد المصدر لبقية عمليات التحقّق من صحة تحديد المصدر بعد النشر، وتنتهي بإنشاء تقرير إذا اجتازت جميع عمليات التحقّق.

تؤدي نطاقات تحديد المصدر إلى تقليل عدد المصادر التي يتم أخذها في الاعتبار عند تحديد المصدر. بعد ذلك، يتم تطبيق خطوات تحديد المصدر المتبقية على هذه المجموعة الأصغر من المصادر، ما قد يؤدي إلى إنشاء تقرير.

موضع نطاقات تحديد المصدر في مسار تحديد المصدر

يتم تطبيق نطاقات تحديد المصدر قبل اختيار مصدر لتحديد المصدر. يسبق ذلك أيضًا الفلاتر على أعلى مستوى وفلترة نافذة التقارير المخصّصة. يعرض المخطّط البياني التالي نسخة مبسطة من عملية تحديد المصدر الإجمالية مع تحديد نطاق تحديد المصدر قبل تحديد المصدر وبقية عمليات التحقّق من تحديد المصدر.

عمليات مسار تحديد المصدر

في ما يلي ملخّص للعمليات المختلفة التي يتم تنفيذها أثناء مسار تحديد المصدر:

• تسجيل المصدر: عندما يتفاعل مستخدم مع إعلان على موقع المعلِن الإلكتروني، يتم تسجيل حدث مصدر. يرسل الجهاز بعد ذلك طلبًا إلى نقطة نهاية مصدر إعداد التقارير، والتي تستجيب بعناوين تتضمّن بيانات أحداث المصدر.
• تسجيل حدث مشغِّل: عند حدوث إحالة ناجحة على الموقع الإلكتروني للمعلِن، يتم تسجيل حدث مشغِّل. يرسل الجهاز طلبًا آخر إلى مصدر إعداد التقارير، والذي يستجيب له بعرض عنوان يحتوي على بيانات حدث التشغيل.
• مطابقة المصدر: يطابق الجهاز أحداث المصدر والتشغيل استنادًا إلى معايير مثل الموقع الوجهة ومصدر إعداد التقارير وتاريخ انتهاء الصلاحية.
• التحقّق من نطاقات تحديد المصدر: يتم فلترة المصادر استنادًا إلى التقاطع بين قيم attribution_scopes للمصدر والمشغّل.
• تحديد المصدر: يختار الجهاز المصدر الأعلى أولوية لتحديد المصدر إذا تطابقت مصادر متعددة. إذا كانت الأولويات متساوية، يتم اختيار الأحدث.
• التحقّق من الفلاتر: يقارن الجهاز بين فلتر المصدر وفلتر المشغّل لتحديد ما إذا كانا متطابقَين. في حال عدم تطابق الفلاتر، يتم تجاهل تحديد المصدر.
• إيقاف المصادر الأخرى: إذا تطابقت فلاتر المصدر المحدّد، سيوقف الجهاز المصادر التي تمّت مطابقتها خلال مرحلة "مطابقة المصدر". ستشمل المصادر التي تم إيقافها المصادر التي لا تتطابق نطاقات تحديد المصدر الخاصة بها مع نطاقات المشغِّل.
• عمليات التحقّق بعد تحديد المصدر: يُجري الجهاز المزيد من عمليات التحقّق من تحديد المصدر الذي تم اختياره، مثل التحقّق مما إذا كان المصدر يتضمّن تقارير مزيّفة، والتحقّق من عمليات تحديد المصدر المكرّرة باستخدام مفاتيح إزالة التكرار، والتحقّق مما إذا كان المشغّل يقع ضمن فترة إعداد التقارير الخاصة بالمصدر، والتحقّق من حدود المعدّل.
• إنشاء التقارير: إذا اجتازت جميع عمليات التحقّق، ينشئ الجهاز تقرير تحديد المصدر ويجدول إرساله إلى نقطة نهاية مصدر إعداد التقارير.

الخطوات التالية

• يمكنك الاطّلاع على مزيد من المعلومات حول نطاقات تحديد المصدر في شرح حول الفلترة المسبقة لتحديد المصدر على GitHub.
• يمكنك الاطّلاع على مزيد من المعلومات عن الفلاتر في مقالة تحديد قواعد العملاء باستخدام الفلاتر.