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

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

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

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

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

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

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

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

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

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

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

• تسجيل مصادر تحديد المصدر
• تسجيل عبارات تشغيل تحديد المصدر