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

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

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

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

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

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

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

أوضاع الوصول

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

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

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

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

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