بدء استخدام تقارير الإحالة

إليك من أين تبدأ، بما في ذلك عملية الإعداد وإلقاء نظرة عامة سريعة.

اختيار نوع تقرير

باستخدام Attribution Reporting API، يمكنك إنشاء نوعَين من التقارير: التقارير على مستوى الحدث والتقارير الملخّصة. تتطلب التقارير على مستوى الحدث إعدادًا أقل من التقارير القابلة للتجميع أو التلخيصية، لذا قد تكون نقطة انطلاق جيدة. تتطلب التقارير الموجزة الدمج مع خدمة التجميع، ولا ينطبق ذلك على التقارير على مستوى الحدث.

يمكنك إعداد التقارير لكلّ من التقارير على مستوى الحدث والتقارير الملخّصة. فهما متكاملان.

التقارير على مستوى الحدث

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

التقارير الموجزة

تقرير الملخّص هو أحد أنواع التقارير في Attribution Reporting API وواجهة برمجة التطبيقات الخاصة للتجميع الخاص. يتضمن تقرير الملخص بيانات المستخدمين المجمّعة ويمكن أن يحتوي على بيانات إحالات ناجحة تفصيلية، مع إضافة تشويش. تتكون التقارير الموجزة من تقارير إجمالية.

التنفيذ

يمكنك البدء بتجربة الخطوات التالية.

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

إنشاء تقرير على مستوى الحدث

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

  1. تسجيل مصدر يُرجى الرجوع إلى تسجيل مصادر تحديد المصدر للحصول على التعليمات. تجدر الإشارة إلى أنّ الخطوات تختلف بالنسبة إلى النقرات والمشاهدات.

  2. تسجيل عامل تشغيل يُرجى الرجوع إلى تسجيل عوامل التشغيل إلى تحديد المصدر للحصول على التعليمات.

  3. إعداد نقطة نهاية باستخدام عنوان URL التالي:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    يمكنك الرجوع إلى مثال الرمز في adtech.js للاطّلاع على طريقة post. يمكنك الاطّلاع على مزيد من المعلومات حول .well-known.

اطّلِع على مزيد من التفاصيل عن التقارير على مستوى الحدث هنا.

إنشاء تقرير الملخص

لإنشاء تقارير موجزة، اتبع هذه الخطوات عالية المستوى:

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

  2. تسجيل عامل تشغيل يُرجى الرجوع إلى تسجيل عوامل التشغيل إلى تحديد المصدر للحصول على التعليمات.

  3. إعداد نقطة نهاية للتقارير القابلة للتجميع باستخدام عنوان URL التالي:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    يمكنك الرجوع إلى مثال الرمز في adtech.js للاطّلاع على طريقة post. يمكنك الاطّلاع على مزيد من المعلومات حول .well-known.

  4. تجميع التقارير وإرسالها لإجراء المزيد من المعالجة من قِبل خدمة التجميع والتي ستُنتج تقارير موجزة. راجِع تقارير التجميع المجمّعة.

يمكنك الاطّلاع على مزيد من التفاصيل حول تقارير الملخّص هنا.

تعرَّف على كيفية إعداد تقارير تصحيح الأخطاء في سلسلة تصحيح أخطاء إعداد تقارير تحديد المصدر.

مفاهيم إضافية في التقارير التلخيصية

بالإضافة إلى فهم خطوات التنفيذ هنا، ستساعدك المفاهيم التالية على التخطيط لاستراتيجية إعداد التقارير الموجزة:

خطوات اختيارية

  1. إعداد الفلاتر (اختياري):
    1. اتّبِع التعليمات الواردة في مقالة تحديد القواعد المخصَّصة باستخدام الفلاتر.
    2. راجِع التفاصيل المتعلّقة بفلاتر التقارير المجمّعة في قسم عوامل التشغيل ضمن الشرح.

لا تنسَ اكتشاف الميزات

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

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

في حال عرض نتيجة التحقّق من رصد الميزات هذه على "صحيح"، سيتم السماح باستخدام واجهة برمجة التطبيقات في السياق (الصفحة) الذي يتم فيه إجراء عملية التحقّق.

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

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

إذا كنت مستعدًا لبدء التنفيذ، راجِع المستندات التالية:

ضبط إعدادات الجهاز

الخلفية

العروض التوضيحية والأدوات

التخطيط

إذا كنت لا تزال في مرحلة التخطيط، يُرجى إلقاء نظرة على المستندات التالية: