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

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

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

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

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

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

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

أوضاع الوصول

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

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

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

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

قد لا يتيح بعض مقدّمي خدمات قياس مدى ظهور الإعلان جميع أوضاع الوصول. يُرجى التواصل مع مقدّمي خدمات قياس إمكانية العرض للتحقّق من الأوضاع المتوافقة. في السابق، كانت حزمة IMA تتيح DOMAIN وضع الوصول، والذي يتم ضبطه تلقائيًا الآن على الوضع 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.LIMITED;

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

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

2. اضبط OmidAccessMode لشريك قياس إمكانية العرض على FULL.