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

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

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

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

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

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

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

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

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

التنفيذ

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

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

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

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

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

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

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

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

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

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

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

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

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

  4. تجميع التقارير وإرسالها لمزيد من المعالجة بواسطة خدمة التجميع التي ستنتج عنها تقارير موجزة. يمكنك الرجوع إلى التقارير القابلة للتجميع.

يتوفّر المزيد من التفاصيل في شرح التقرير القابل للتجميع.

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

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

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

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

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

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

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

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

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

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

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

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

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

الخلفية

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

التخطيط

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