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

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

في البداية، ستتعرّف على كيفية:

  • التفريق بين أنواع تقارير Attribution Reporting API

  • إكمال خطوات تنفيذ واجهة برمجة التطبيقات وإنشاء التقارير

  • العثور على معلومات مرجعية ومعلومات عن تحديد المشاكل وحلّها

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

لقياس أداء الحملات الإعلانية بفعالية بمستويات مختلفة من التفاصيل والخصوصية، توفّر Attribution Reporting API نوعَين مختلفَين من التقارير:

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

  • التقارير الموجزة: تقدّم بيانات مجمّعة للمستخدمين ويمكن أن تتضمّن معلومات أكثر تفصيلاً عن الإحالات الناجحة مع معلومات إضافية غير مفيدة. باستخدام كلٍّ من Attribution Reporting API وPrivate Aggregation API، يتمّ إنشاؤها من التقارير المجمّعة وتقدّم نموذج بيانات أكثر ثراءً من التقارير على مستوى الحدث. تكون التقارير التلخيصية مفيدة بشكلٍ خاص للسيناريوهات التي تتطلّب إحصاءات مجمّعة، مثل احتساب قيم الإحالات الناجحة أو تحليل أداء الحملة على مستوى شرائح المستخدِمين.

نظرة عامة على التنفيذ

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

شرط أساسي: يجب أن تكون مواقعك الإلكترونية مزوّدة بشهادات طبقة المقابس الآمنة/بروتوكول أمان طبقة النقل (HTTPS) قبل أن تتمكّن من تسجيل المصادر وعوامل التفعيل وتلقّي التقارير.

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

توضِّح الخطوات التالية كيفية إنشاء تقارير على مستوى الحدث:

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

  2. تسجيل عامل تشغيل: لتسجيل حدث إحالة ناجحة وربطه بمصدر مسجَّل سابقًا راجِع تسجيل عوامل تشغيل تحديد المصدر للحصول على التعليمات.

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

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

إنشاء التقارير الموجزة

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

  2. تسجيل عامل تشغيل: يُرجى اتّباع الخطوات نفسها المتّبعة في التقارير على مستوى الحدث. اطّلِع على تسجيل عوامل تشغيل تحديد المصدر.

  3. إعداد نقطة نهاية لإعداد التقارير: أنشئ نقطة نهاية لتلقّي تقارير مجمّعة. يجب أن يكون عنوان URL: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. يمكنك الاطّلاع على adtech.js للحصول على مثال على طريقة POST وWikipedia للحصول على معلومات عن .well-known.

  4. تجميع التقارير وإرسالها: يمكنك تجميع التقارير المجمّعة وإرسالها إلى خدمة التجميع لمعالجتها. ستنشئ خدمة التجميع بعد ذلك تقارير تلخيصية. اطّلِع على استراتيجيات تجميع الطلبات للحصول على مزيد من المعلومات.

للاطّلاع على مزيد من التفاصيل حول التقارير التلخيصية، يُرجى الاطّلاع على شرح التقارير القابلة للتجميع.

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

إعداد الفلاتر (اختياري)

للحصول على مزيد من التحكّم الدقيق في بيانات الإحالة التي تتلقّاها، يمكنك إعداد فلاتر.

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

لإعداد الفلترة، اطّلِع على مقالة تحديد قواعد مخصّصة باستخدام الفلاتر وقسم "العوامل المشغّلة" في مقالة تسجيل عامل تشغيل تحديد المصدر للحصول على تفاصيل محدّدة للتقارير القابلة للتجميع.

التأكّد من تفعيل واجهة برمجة التطبيقات

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

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

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

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

تقدّم الأقسام التالية مزيدًا من المعلومات حول بدء إعداد تقارير تحديد المصدر.

التنفيذ

الخلفية والمفاهيم

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

التخطيط