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

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

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

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

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

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

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

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

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

التنفيذ

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

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

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

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

  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
}

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

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

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

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

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

الخلفية

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

التخطيط

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