فتح أداة القياس

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

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

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

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

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

أوضاع الوصول

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

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

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

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

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

قد لا يدعم بعض موفّري إمكانية العرض جميع أوضاع الوصول. يُرجى التواصل مع موفّري حلول قياس مدى الرؤية للتأكّد من الأوضاع المتاحة.

ضبط قواعد وضع الوصول لأحد الطلبات

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

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

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

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

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

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