تفعيل ميزة "القياس المفتوح"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتضمّن أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية
حزمة تطوير البرامج (SDK) الخاصة بـ Open Measurement (OM)، وهو معيار متّبع في المجال تم تطويره من قِبل Interactive Advertising Bureau (IAB) لتفعيل قياس إمكانية العرض والتحقّق من الجهات الخارجية. عند استخدام حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية في HTML5، تعمل
حزمة تطوير البرامج (SDK) المضمّنة لبرنامج Open Measurement على تحليل علامة <AdVerifications> تلقائيًا ضمن علامات إعلانات VAST
وترسل بيانات إمكانية العرض إلى مورّدي القياس المحدّدين باستخدام
OMID API. يمكنك اختياريًا ضبط قواعد وضع الوصول لكل طلب للتحكّم في
المحتوى الذي يمكن لنص التأكيد الوصول إليه.
تتوافق أداة تطوير البرامج لإعلانات الوسائط التفاعلية مع الإصدار 1.4 من حزمة تطوير البرامج OM SDK.
المتطلبات الأساسية
في حال استخدام الإصدار 4.1 من "نموذج عرض إعلانات الفيديو" أو إصدار أحدث، يجب ضبط الإعلانات لتقديم عملية إثبات الهوية باستخدام<AdVerifications>. في حال استخدام إصدارات VAST السابقة، يجب أن تستخدم الإعلانات
<Extension type="AdVerifications">.
إذا تمّ عرض إعلاناتك من خلال "مدير إعلانات Google"، عليك ضبط مقدّم خدمات قياس مدى الرؤية لشبكة "مدير إعلانات Google" وتعيين مقدّم خدمات قياس مدى الرؤية هذا لعنصر إعلانك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة
ضبط موفّر إمكانية العرض لشبكتك على "مدير إعلانات 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe IMA SDK for HTML5 utilizes the Open Measurement (OM) SDK for third-party viewability and verification measurement, automatically sending data to specified vendors.\u003c/p\u003e\n"],["\u003cp\u003eAds must be configured to supply verification using \u003ccode\u003e<AdVerifications>\u003c/code\u003e (VAST 4.1+) or \u003ccode\u003e<Extension type="AdVerifications">\u003c/code\u003e (previous VAST versions).\u003c/p\u003e\n"],["\u003cp\u003eFour access modes (FULL, CREATIVE, DOMAIN, LIMITED) control verification script access to the creative and publisher page, impacting the level of data access.\u003c/p\u003e\n"],["\u003cp\u003eAccess mode rules are set at the \u003ccode\u003eAdsRequest\u003c/code\u003e level, allowing customized access for different verification vendors, with \u003ccode\u003eLIMITED\u003c/code\u003e as the default.\u003c/p\u003e\n"],["\u003cp\u003eImplementing \u003ccode\u003eCREATIVE\u003c/code\u003e access mode requires sandboxing the video player in a secure iframe and setting the \u003ccode\u003eOmidAccessMode\u003c/code\u003e to \u003ccode\u003eFULL\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Enable Open Measurement\n\nThe IMA SDK for HTML5 includes the\n[Open Measurement (OM) SDK](//iabtechlab.com/standards/open-measurement-sdk/),\nan industry standard developed by the\n[Interactive Advertising Bureau (IAB)](//www.iab.com/) to enable third-party\nviewability and verification measurement. When using the IMA SDK for HTML5, the\nincluded OM SDK automatically parses the `\u003cAdVerifications\u003e` tag within VAST ad\ntags and sends viewability data to the specified measurement vendors using the\nOMID API. You can optionally set access mode rules for each request to control\nwhat content the verification script can access.\n\nThe IMA SDK supports OM SDK v1.4.\n\nPrerequisites\n-------------\n\n- If using VAST 4.1 or higher, ads must be configured to supply verification\n using `\u003cAdVerifications\u003e`. If using previous VAST versions, ads must use\n `\u003cExtension type=\"AdVerifications\"\u003e`.\n\n- If your ads are trafficked through Ad Manager, configure a viewability\n provider for your Ad Manager network and assign that viewability provider to\n your line item. For more information, see\n [Configure a viewability provider for your Ad Manager network](//support.google.com/admanager/answer/9025968#configure-a-viewability-provider).\n\nAccess modes\n------------\n\nThe OM SDK supports running verification scripts in four different access modes\nwhich controls how much the verification script can access:\n\n- `FULL`: The verification script has direct access to the creative and the\n publisher page.\n\n- `CREATIVE`: The verification script and creative are sandboxed from the\n publisher page. However, the script has direct access to the creative.\n\n- `LIMITED`: The verification script is sandboxed and cannot access the creative\n or publisher page, and cannot directly confirm what publisher domain it is on.\n\nSome viewability providers might not support all access modes. Contact your\nviewability providers to verify which modes are supported. Previously, IMA\nsupported a `DOMAIN` access mode, which now defaults to `LIMITED` mode.\n\nSet the access mode rules for a request\n---------------------------------------\n\nAccess mode rules must be set at the [`AdsRequest`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima.AdsRequest#omidAccessModeRules) level. To set different access modes for different verification script providers, pass a dictionary that maps each [`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor) to one of the access modes listed above. The `OmidVerificationVendor.OTHER` field is used to set the default access mode for all vendors not explicitly included in the dictionary. If no access mode rules are specified, verification scripts run in `LIMITED` access mode for vendors.\n\n\u003cbr /\u003e\n\nSee the following example which sets `GOOGLE` to\n`google.ima.OmidAccessMode.FULL`. All other providers, including those\nlisted in\n[`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor),\ndefault to how `OmidVerificationVendor.OTHER` is set. \n\n request.omidAccessModeRules = {};\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]\n = google.ima.OmidAccessMode.FULL;\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]\n = google.ima.OmidAccessMode.LIMITED;\n\n\nTo implement `CREATIVE` access mode, you must follow both of the following\nsteps:\n\n1. Sandbox your video player in a secure iframe, isolated from the rest of your\n site.\n\n2. Set the `OmidAccessMode` for your viewability partner to `FULL`."]]
