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

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

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

باستخدام الأولويات من جهة المصدر، يمكنك تغيير السلوك التلقائي لواجهة برمجة التطبيقات 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 إلى عنوان تسجيل العامل المشغِّل واضبط أولوية أعلى للتحويلات التي تريد منحها الأولوية.

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

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

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

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

راجِع مثال الرمز: منح الأولوية للإحالات الناجحة من النوع checkout

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

للاطّلاع على معلومات عن ضبط المصادر وعوامل التفعيل، يُرجى الرجوع إلى: