منح الأولوية لنقرات أو مشاهدات أو إحالات ناجحة معيّنة

يمكنك ضبط واجهة برمجة التطبيقات لمنح الأولوية لمصادر أو مشغّلات معيّنة.

منح الأولوية لنقرات أو مشاهدات معيّنة للتقارير على مستوى الحدث أو للتقارير القابلة للتجميع

باستخدام الأولويات من جهة المصدر، يمكنك تغيير السلوك التلقائي Attribution Reporting API. بشكلٍ تلقائي، يكون نموذج تحديد المصدر هو نقطة الاتصال الأخيرة، ما يعني أنّ الإحالة الناجحة تُنسَب إلى آخر حدث مصدر مطابق. بالنسبة إلى التقارير على مستوى الحدث والتقارير المجمّعة، يمكنك تعديل هذا السلوك.

لتغيير الأولوية التلقائية، أضِف المفتاح priority إلى عنوان تسجيل المصدر.

حدِّد أولوية أعلى للمصادر التي تريد منحها الأولوية. تشير القيم الأكبر إلى أولوية أعلى، مثلاً، إذا كان حدث مصدر يتضمّن priority بقيمة 2، سيكون له الأولوية على مصدر يتضمّن priority بقيمة 1.

لا يتم إرسال سوى التقرير الذي يتطابق مع الحدث المصدر ذا الأولوية القصوى.

مثال على الرمز

غيِّر عملية تحديد المصدر لاختيار مصادر أقل حداثة (النقرة الأولى):

const currentTimestamp = Date.now();
const priority = - currentTimestamp;

 res.set(
  'Attribution-Reporting-Register-Source',    
  JSON.stringify({
  // … all usual fields for that header
      priority: `${priority}`
    })
 );

منح الأولوية لإحالات ناجحة محدّدة للتقارير على مستوى الحدث

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

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

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

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

لإجراء ذلك، أضِف مفتاح priority إلى عنوان تسجيل المشغّل وحدِّد أولوية أعلى للإحالات الناجحة التي تريد تحديد أولوية عالية لها.

عند بدء عملية تحديد مصدر لحدث مصدر معيّن، إذا تم الوصول إلى الحدّ الأقصى لعدد عمليات تحديد المصدر (ثلاث إحالات للنقرات وواحد للمشاهدات) في هذا المصدر، سينفّذ المتصفّح ما يلي:

  • قارِن أولوية التقرير الجديد بأولويات التقارير المُجدوَلة الحالية للمصدر نفسه.

  • عليك حذف التقرير ذا الأولوية الأدنى لجدولة التقرير الجديد بدلاً من ذلك. وإذا كان التقرير الجديد هو التقرير ذا الأولوية الأدنى، يتم تجاهله ولن تتلقاه.

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

راجِع الرمز النموذجي: إعطاء الأولوية للإحالات الناجحة لنوع الدفع

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

للحصول على معلومات عن إعداد المصادر والعوامل المشغِّلة، يُرجى الاطّلاع على ما يلي: