تتضمّن حزمة تطوير البرامج (SDK) الخاصة بـ HTML5 لإعلانات الوسائط التفاعلية حزمة تطوير البرامج (SDK) الخاصة بالقياس المفتوح (OM)، وهو معيار متّبع في المجال تم تطويره من قِبل مكتب الإعلانات التفاعلية (IAB) لتفعيل قياس إمكانية العرض والتحقّق من جهة خارجية. عند استخدام حزمة تطوير البرامج للإعلانات التفاعلية من Google في HTML5، تحلّل حزمة تطوير البرامج Open Measurement المضمّنة تلقائيًا العلامة <AdVerifications> ضمن علامات إعلانات VAST، وترسل بيانات إمكانية العرض إلى مورّدي القياس المحدّدين باستخدام واجهة برمجة التطبيقات OMID. يمكنك اختياريًا ضبط قواعد وضع الوصول لكل طلب للتحكّم في المحتوى الذي يمكن لبرنامج التحقّق الوصول إليه.
تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية مع الإصدار 1.6 من حزمة تطوير البرامج الخاصة بالقياس المفتوح.
المتطلبات الأساسية
في حال استخدام الإصدار 4.1 أو الإصدارات الأحدث من VAST، يجب ضبط الإعلانات لتوفير عملية التحقّق باستخدام
<AdVerifications>. في حال استخدام إصدارات VAST السابقة، يجب أن تستخدم الإعلانات<Extension type="AdVerifications">.إذا تمّ نشر إعلاناتك من خلال "مدير إعلانات Google"، عليك ضبط جهة قياس إمكانية العرض لشبكة "إدارة الإعلانات" وتعيين جهة قياس إمكانية العرض هذه لبندك الإعلاني. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط جهة قياس إمكانية العرض لشبكة "إدارة الإعلانات".
أوضاع الوصول
تتيح حزمة تطوير البرامج OM SDK تشغيل نصوص برمجية للتحقّق في أربعة أوضاع وصول مختلفة تتحكّم في مقدار البيانات التي يمكن أن يصل إليها النص البرمجي للتحقّق، وهي:
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، يجب اتّباع الخطوتَين التاليتَين:
وضع مشغّل الفيديو في وضع الحماية ضمن إطار iframe آمن ومعزول عن بقية موقعك الإلكتروني
اضبط قيمة
OmidAccessModeلشريك إمكانية العرض علىFULL.