تفعيل ميزة "القياس المفتوح"

حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) بتنسيق HTML5

تتضمّن حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات الوسائط التفاعلية" في HTML5 حزمة تطوير البرامج (SDK) الخاصة بـ Open Measurement‏ (OM)، وهي معيار متّبع في المجال تم تطويره من قِبل مكتب الإعلانات التفاعلية (IAB) بهدف إتاحة قياس إمكانية العرض والتحقّق من صحة البيانات من جهات خارجية. عند استخدام حزمة تطوير البرامج للإعلانات التفاعلية من Google في HTML5، تحلّل حزمة تطوير البرامج الخاصة بـ Open Measurement المضمّنة تلقائيًا العلامة <AdVerifications> ضمن علامات إعلانات VAST وترسل بيانات إمكانية العرض إلى مورّدي القياس المحدّدين باستخدام واجهة برمجة التطبيقات OMID. يمكنك اختياريًا ضبط قواعد وضع الوصول لكل طلب للتحكّم في المحتوى الذي يمكن لبرنامج التحقّق الوصول إليه.

تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية مع الإصدار 1.4 من حزمة OM SDK.

المتطلبات الأساسية

  • في حال استخدام الإصدار 4.1 أو الإصدارات الأحدث من VAST، يجب ضبط الإعلانات لتوفير عملية التحقّق باستخدام <AdVerifications>. في حال استخدام إصدارات VAST السابقة، يجب أن تستخدم الإعلانات <Extension type="AdVerifications">.

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

أوضاع الوصول

تتيح حزمة تطوير البرامج OM SDK تشغيل نصوص برمجية للتحقّق في أربعة أوضاع وصول مختلفة تتحكّم في مقدار البيانات التي يمكن أن تصل إليها نصوص التحقّق البرمجية:

  • FULL: يمكن لنص التحقّق البرمجي الوصول مباشرةً إلى تصميم الإعلان وصفحة الناشر.

  • CREATIVE: يتم وضع نص التحقّق والإعلان في وضع الحماية بعيدًا عن صفحة الناشر. ومع ذلك، يمكن للبرنامج النصي الوصول مباشرةً إلى تصميم الإعلان.

  • ‫LIMITED: يتم وضع نص التحقّق البرمجي في بيئة الاختبار المعزولة، ولا يمكنه الوصول إلى تصميم الإعلان أو صفحة الناشر، كما لا يمكنه التأكّد مباشرةً من نطاق الناشر الذي يظهر عليه.

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

ضبط قواعد وضع الوصول لطلب

يجب ضبط قواعد وضع الوصول على مستوى AdsRequest. لضبط أوضاع وصول مختلفة لمقدّمي نصوص التحقّق المختلفة، مرِّر قاموسًا يربط كل OmidVerificationVendor بأحد أوضاع الوصول المذكورة أعلاه. يُستخدَم الحقل OmidVerificationVendor.OTHER لضبط وضع الوصول التلقائي لجميع المورّدين غير المضمّنين بشكل صريح في القاموس. في حال عدم تحديد أي قواعد لوضع الوصول، يتم تشغيل نصوص التحقّق في وضع الوصول LIMITED للمورّدين.

انظر المثال التالي الذي يضبط GOOGLE على google.ima.OmidAccessMode.FULL. بالنسبة إلى جميع موفّري الخدمات الآخرين، بما في ذلك الموفّرون المدرَجون في OmidVerificationVendor، يتم تلقائيًا استخدام طريقة ضبط OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.LIMITED;

لتنفيذ وضع الوصول CREATIVE، يجب اتّباع الخطوتَين التاليتَين:

  1. وضع مشغّل الفيديو في وضع الحماية ضمن إطار iframe آمن ومعزول عن بقية موقعك الإلكتروني

  2. اضبط OmidAccessMode لشريك إمكانية العرض على FULL.