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

اختيار النظام الأساسي: HTML5 Android iOS

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

تتوافق حزمة IMA SDK مع حزمة OM SDK الإصدار 1.6.

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

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

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

أوضاع الوصول

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

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

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

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

قد لا تتيح بعض جهات قياس إمكانية العرض جميع أوضاع الوصول. يُرجى التواصل مع جهات قياس إمكانية العرض للتأكّد من الأوضاع المتاحة. في السابق، كانت حزمة IMA SDK تتيح وضع الوصول 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