دليل دمج "الجمهور المحمي" (المعروف سابقًا باسم FLEDGE) لمقدّمي خدمات القياس

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

في Protected Audience API، عندما يفوز إعلان لتجديد النشاط التسويقي بالمزاد، يتم عرض سيتم إرسال عنوان URL الخاص بالإعلان إلى وحدة إعلانية مسيّرة. إطار لـ العرض. الإطار المحاط بسور هو عنصر HTML مقترح للمحتوى المضمن، المشابهة لإطار iframe. على عكس إطارات iframe، يقيّد الإطار المحمي الاتصال مع سياق التضمين للسماح بوصول الإطار إلى بيانات مواقع إلكترونية متعددة بدون مشاركته مع سياق التضمين. لمزيد من التفاصيل، يُرجى الرجوع إلى حالات استخدام ميزة Fenced Frames التطبيق.

العرض يتيح الفيديو 360 استخدام قائمة وحدات الماكرو للقياس الذي يمكن استخدامه لتتبع مرات الظهور والنقرات. فقط مجموعة فرعية صغيرة من هذه يمكن استبدال وحدات الماكرو كجزء من عرض تصميم الإعلان، بسبب نقص وإشارات مزاد الإعلانات. على سبيل المثال، سيتم إيقاف ${PUBLISHER_ID} بدون تغييرات. إلى علامات مقدّمي خدمات القياس

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

التسجيل

اعتبارًا من آب (أغسطس) 2023، قد يحتاج مقدّمو خدمات القياس إلى اتّباع الخطوات. أدناه لتسجيل أنفسهم لاستخدام واجهات برمجة التطبيقات Fenced Frame Reporting API في خدمات الحماية Audience API:

تفاصيل حول كيفية تنفيذ ذلك والأشخاص الذين عليهم إجراء ذلك التسجيل

الدمج

علامات ظهور مقدّم خدمة القياس

تعليمات الإعداد:

علامات النص البرمجي مثال 
<script src='https://tracking.com/a.js'>xxx</script>
 المسؤولية: على موفّري خدمات القياس تعديل علامات النص البرمجي من أجل استخدامها. واجهة برمجة تطبيقات reportEvent لتتبُّع مرات الظهور (راجِع الإرشادات) أدناه).
علامات الصور مثال 
<img src='https://tracking.com/'>
 المسؤولية: الشبكة الإعلانية فيديو 360 لتعديل علامات img src من أجل استخدامها واجهة برمجة تطبيقات reportEvent لتتبُّع مرات الظهور

واجهة برمجة التطبيقات reportEvent

تم اقتراح استخدام واجهة برمجة التطبيقات تتبُّع ما بعد العرض فقط تحتوي واجهة برمجة التطبيقات على جزأين: registerAdMacro reportEvent

  • العرض يستخدم الفيديو 360 الدالة registerAdMacro في reportWin. تشير رسالة الأشكال البيانية أزواج المفتاح/القيمة في المتصفح قبل عرض الاتصال.
  • استنادًا إلى نوع العلامة، يمكن يمتلك موفّرو خدمة الفيديو 360 أو خدمات القياس التغييرات على علامات نماذج الجهات الخارجية لاستخدام واجهة برمجة تطبيقات reportEvent

يستخدم reportEvent إدخال "destinationURL" واحدًا فقط، وهو ما يشير إلى إلى خوادم مزوِّدي خدمة القياس يمكن أن يحتوي على أي وحدات ماكرو مدرجة في الشبكة الإعلانية مساعدة Video 360 الوسط. على سبيل المثال:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

عندما ينشط Chrome فحص اتصال عنوان URL في الدالة، سيبحث عن النتائج وحدات الماكرو واستبدالها بالقيم قبل إرسال طلب HTTP GET إلى https://adtech.example

خطوات تعديل علامات النص البرمجي

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

  1. جهِّز عنوان URL لمرّات الظهور لمزوِّد خدمة القياس من أجل قبول إشعارات مرّات الظهور. على سبيل المثال:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. إضافة reportEvent JavaScript عند الرد على نص برمجي من Protected Audience API: على سبيل المثال:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. تسجيل مرات الظهور عند تلقي إشعارات من عنوان URL لمرات الظهور الذي تم إعداده في الخطوة الأولى.

علامات النقر لمقدّم خدمات القياس

وستواصل علامة النقر الحالية لمقدِّم خدمة القياس العمل بميزة "مرات ظهور الجمهور المحمي". العرض سيستخدم فيديو 360 واجهة برمجة التطبيقات Fenced Frames Ads Reporting API. إشارة reserved.top_navigation لتسجيل النقرات، وإجراء سلسلة من جميع خدمات تتبُّع النقرات لدى مزوّد القياس كعمليات إعادة توجيه. لمزيد من التفاصيل، راجع مستندات Chrome لإعداد تقارير الإعلانات الخاضعة لقيود: API.