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

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

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

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

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

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

أوضاع الوصول

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

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

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

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

لتطبيق وضع الوصول عبر CREATIVE، عليك اتّباع الخطوتَين التاليتَين:

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

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