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

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

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

تتوافق حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) مع الإصدار 1.6 من حزمة تطوير البرامج (SDK) الخاصة بالقياس المفتوح.

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

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

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

أوضاع الوصول

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

• ‫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.