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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

<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) والعامل المشغِّل لا يتقاطعان.

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

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

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

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

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

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

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

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

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="An image showing a simplified version of the attribution flow with each step represented as a square linked to the next step by an arrow. الخطوات بالترتيب هي " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="مخطّط تدفق الإسناد المبسّط" />

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

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

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

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

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