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

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

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

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

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

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

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

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

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

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

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