القياس المفتوح

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

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

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

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

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

أوضاع الوصول

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

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

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

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

  • 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.DOMAIN;

لتنفيذ وضع الوصول CREATIVE، عليك اتّباع كلٍّ من الخطوات التالية:

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

  2. اضبط OmidAccessMode لشريكك في ميزة "قياس مدى الرؤية" على FULL.