با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
IMA SDK برای Android شامل Open Measurement (OM) SDK است، یک استاندارد صنعتی که توسط اداره تبلیغات تعاملی (IAB) برای فعال کردن قابلیت مشاهده و اندازه‌گیری تأیید شخص ثالث ایجاد شده است. هنگام استفاده از کیت توسعه نرم افزار IMA برای Android، کیت توسعه نرم افزاری OM ارائه شده به طور خودکار تگ <AdVerifications> را در تگ های تبلیغات VAST تجزیه می کند و داده های قابلیت مشاهده را از طریق API OMID به فروشندگان اندازه گیری مشخص شده ارسال می کند. کیت توسعه نرم افزار IMA از افزونه های OM SDK v1.4، GAM AdVerifications در افزونه های VAST 2+، و مزیت های VAST OnVTo opener، 4+ پشتیبانی می کند. برای اندازه گیری، نکات زیر را در نظر داشته باشید:
برای استفاده از Open Measurement باید نسخه 3.11.0 یا بالاتر IMA SDK برای Android را داشته باشید. با این حال، نمونه موجود در این راهنما برای جدیدترین نسخه SDK طراحی شده است و شامل APIهای معرفی شده در نسخه 3.16.5 است.
در صورت استفاده از VAST 4.1+، تبلیغات باید به گونه‌ای پیکربندی شوند که <AdVerifications> در VAST خود طبق مشخصات VAST 4.1 تنظیم کنند. در غیر این صورت، باید از <Extension type="AdVerifications"> استفاده شود.
از پوشاندن AdDisplayContainer با هر گونه پوشش (شفاف یا مات) خودداری کنید، زیرا این موارد توسط OM SDK به عنوان موانع علامت گذاری می شوند و قابلیت مشاهده را کاهش می دهند.
برای آزمایش Open Measurement با استفاده از IMA SDK، از یکی از نسخه‌های مورد نیاز SDK بالا به همراه یک برچسب آگهی آزمایشی استفاده کنید.
باید <AdVerifications> را در پاسخ VAST خود مشاهده کنید.
انسدادهای پوششی کنترل های ویدئویی را ثبت کنید
کنترل‌های ویدیویی مانند دکمه‌های مکث یا نوارهای پیشرفت، اطلاعات و اقدامات ضروری پخش را در اختیار کاربران قرار می‌دهند. در تلفن همراه، ضربه‌های غیردقیق و انتظارات کاربر، ارائه کنترل‌های بزرگ و لمس‌پسند بر روی عنصر رسانه را رایج کرده است. این کنترل‌ها معمولاً با یک ضربه کاربر محو می‌شوند و در اکثریت قریب به اتفاق زمان پخش قابل مشاهده نیستند.
در زیر نمونه ای از کنترل های ویدیویی ارائه شده توسط برنامه YouTube آورده شده است:
هنگام استفاده از IMA SDK، اکثر ناشران این کنترل ها را با افزودن یک نمای بالای محفظه نمایش آگهی که عمدتاً شفاف است، اجرا می کنند. معمولاً کنترل‌ها عناصر فرعی این نمای هستند که پخش‌کننده ویدیوی زیرین را کاملاً مسدود می‌کنند. این پوشش شفاف برای ضبط رویدادهای ضربه زدن و سپس ارائه کنترل ها به کاربران هنگام ضربه زدن استفاده می شود.
وقتی قابلیت مشاهده آگهی از طریق Open Measurement SDK محاسبه می‌شود، همه نماهایی که عنصر رسانه را پوشانده‌اند، مانع تلقی می‌شوند و میزان مشاهده‌پذیری را کاهش می‌دهند. در مواردی که یک روکش شیر شفاف بالای کل محفظه نمایش آگهی قرار گیرد، ممکن است موجودی کاملاً غیرقابل مشاهده اعلام شود.
Open Measurement SDK پیش‌بینی می‌کند که کنترل‌های ویدیو به عنوان موانع «دوستانه» در نظر گرفته شوند که برای تجربه کاربر ضروری هستند. پس از ثبت به‌عنوان دوستانه، این کنترل‌ها از اندازه‌گیری قابلیت مشاهده آگهی حذف می‌شوند.
با پشتیبانی IAB و MRC، IMA SDK یک API برای ثبت این پوشش‌ها با Open Measurement SDK معرفی می‌کند. این کنترل ها باید پوشش های کاملا شفاف یا دکمه های کوچک باشند. سایر نماهایی که به کنترل های ویدئویی مربوط نمی شوند نباید ثبت شوند.
ثبت نام کنید
ثبت نام نکنید
پوشش شفاف برای ثبت ضربه های کاربر
دکمه های گذرا
مکث کنید
بازی کنید
تمام صفحه
بازیگران/ایرپلی
فرو ریختن
پیشرفت/جستجو
سایر اقدامات مربوط به پخش
واترمارک
پاپ آپ
دیالوگ ها
دکمه های غیر گذرا
سایر دیدگاه های مبهم
کد نمونه زیر نحوه ثبت همپوشانی کنترل‌های ویدیویی را در ظرف نمایش آگهی نشان می‌دهد:
myTransparentTapOverlay=(ViewGroup)rootView.findViewById(R.id.overlay);myPauseButton=(ImageButton)rootView.findViewById(R.id.pauseButton);// Substitute "myTransparentTapOverlay" and "myPauseButton" with the// elements you want to register as video controls overlays.// Make sure to register before ad playback starts.overlayObstruction=ImaSdkFactory.createFriendlyObstruction(myTransparentTapOverlay,FriendlyObstructionPurpose.NOT_VISIBLE,"This overlay is transparent");pauseButtonObstruction=ImaSdkFactory.createFriendlyObstruction(myPauseButton,FriendlyObstructionPurpose.VIDEO_CONTROLS,"This is the video player pause button");displayContainer.registerFriendlyObstruction(overlayObstruction);displayContainer.registerFriendlyObstruction(pauseButtonObstruction);
وقتی کار با آنها تمام شد، این موانع را می توان با فراخوانی روش زیر برطرف کرد:
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe IMA SDK for Android incorporates the Open Measurement (OM) SDK, an industry standard for third-party viewability and verification measurement, automatically sending viewability data to specified vendors.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize Open Measurement, ensure you're using IMA SDK for Android version 3.11.0 or higher, and that ads are configured to traffic \u003ccode\u003e<AdVerifications>\u003c/code\u003e tags in their VAST responses.\u003c/p\u003e\n"],["\u003cp\u003eAvoid obstructing the \u003ccode\u003eAdDisplayContainer\u003c/code\u003e with overlays, as they negatively impact viewability measurements, unless they are registered as friendly obstructions, like transparent tap overlays or video control buttons, using the provided API.\u003c/p\u003e\n"],["\u003cp\u003eWhen registering friendly obstructions for video controls, use the \u003ccode\u003eImaSdkFactory.createFriendlyObstruction()\u003c/code\u003e method with a \u003ccode\u003edetailedReason\u003c/code\u003e string that adheres to the IAB standard: 50 characters or less, containing only \u003ccode\u003eA-z\u003c/code\u003e, \u003ccode\u003e0-9\u003c/code\u003e, or spaces.\u003c/p\u003e\n"]]],[],null,["# Enable Open Measurement in IMA\n\nThe IMA SDK for Android 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\nAndroid, the included OM SDK automatically parses\nthe `\u003cAdVerifications\u003e` tag within VAST ad tags and sends viewability data to\nthe specified measurement vendors via the OMID API.The IMA SDK supports OM SDK\nv1.4, GAM AdVerifications extensions on VAST 2+,\nand the AdVerifications node on VAST 4+.To take advantage of Open Measurement,\nkeep the following points in mind:\n\n- To use Open Measurement you must have version\n 3.11.0 or\n greater of the IMA SDK for Android.\n However, the sample in this guide is designed for the newest version of the SDK\n and includes APIs introduced in version 3.16.5.\n\n- Ads must be configured to traffic `\u003cAdVerifications\u003e` in their VAST as per\n the [VAST 4.1 spec](//iabtechlab.com/wp-content/uploads/2018/06/VAST4.1-June7-FINAL.pdf)\n if using VAST 4.1+; otherwise, `\u003cExtension type=\"AdVerifications\"\u003e`\n should be used.\n\n- Refrain from covering the `AdDisplayContainer` with any overlays\n (transparent or opaque), since these will be flagged as obstructions by the OM\n SDK and reduce viewability.\n\nPrerequisites\n-------------\n\n- If your ads are trafficked through Ad Manager, [configure a viewability\n provider for your Ad Manager network](//support.google.com/admanager/answer/9025968#configure-a-viewability-provider) and assign that viewability provider to your line item.\n\nTesting\n-------\n\nTo test Open Measurement using the IMA SDK, use one of the required versions of\nthe SDK above, along with a [test ad tag](https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/omid_ad_samples&env=vp&gdfp_req=1&output=vast&sz=640x480&description_url=http%3A%2F%2Ftest_site.com%2Fhomepage&vpmute=0&vpa=0&vad_format=linear&url=http%3A%2F%2Ftest_site.com&vpos=preroll&unviewed_position_start=1&correlator=).\n\nYou should see the `\u003cAdVerifications\u003e` returned in your VAST response.\n\nRegister video controls overlay obstructions\n--------------------------------------------\n\nVideo controls such as pause buttons or progress bars provide essential playback\ninformation and actions to users. On mobile, imprecise taps and user\nexpectations have made it common practice to render large, touch-friendly\ncontrols over the media element. These controls usually fade in and out on a\nuser tap and are not visible for the vast majority of playback time.\n\nBelow is an example of video controls rendered by the YouTube app:\n\nWhen using the IMA SDK, most publishers implement these controls by adding a\nview above the ad display container that is mostly transparent. Usually, the\ncontrols are child elements of this view that fully occludes the underlying\nvideo player. This transparent overlay is used to capture tap events and then\nrender the controls to users when tapped.\n\nWhen ad viewability via the Open Measurement SDK is calculated, all views\noverlaying the media element are considered obstructions and reduce the\nviewability rate. In the case where a transparent tap overlay sits above the\nentire ad display container, it is possible for inventory to be declared\ncompletely unviewable.\n\nThe Open Measurement SDK makes provisions for video controls to be considered\n\"friendly\" obstructions that are essential to the user's experience. Once\nregistered as friendly, these controls are excluded from ad viewability\nmeasurement.\n\nWith IAB and MRC support, the IMA SDK introduces an API for registering these\noverlays with the Open Measurement SDK. These controls must be fully transparent\noverlays or small buttons. Any other views not related to video controls must\nnot be registered.\n\n| DO register | DO NOT register |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|\n| - Transparent overlay to capture user taps - Transient buttons - Pause - Play - Fullscreen - Cast/AirPlay - Collapse - Progress/Seek - Other playback relevant actions | - Watermarks - Pop ups - Dialogs - Non-transient buttons - Other obscuring views |\n\nThe following sample code demonstrates how to register video controls overlays\non the ad display container:\n\n\n| **Key Point:** The `detailedReason` string used when calling [`ImaSdkFactory.createFriendlyObstruction()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkFactory#public-friendlyobstruction-createfriendlyobstruction-view-view,-friendlyobstructionpurpose-purpose,-string-detailedreason) must follow the IAB standard by:\n|\n| - Being 50 characters or less.\n| - Only contain characters `A-z`, `0-9`, or spaces.\n- The string can be nil. \n\n myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);\n myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);\n // Substitute \"myTransparentTapOverlay\" and \"myPauseButton\" with the\n // elements you want to register as video controls overlays.\n // Make sure to register before ad playback starts.\n overlayObstruction = ImaSdkFactory.createFriendlyObstruction(\n myTransparentTapOverlay,\n FriendlyObstructionPurpose.NOT_VISIBLE,\n \"This overlay is transparent\"\n );\n pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(\n myPauseButton,\n FriendlyObstructionPurpose.VIDEO_CONTROLS,\n \"This is the video player pause button\"\n );\n\n displayContainer.registerFriendlyObstruction(overlayObstruction);\n displayContainer.registerFriendlyObstruction(pauseButtonObstruction);\n\nWhen you're done with them, these obstructions can be removed by calling the\nfollowing method:\n\n displayContainer.unregisterAllFriendlyObstructions();\n\n| **Note:** For information on measurement and verification providers that have committed to the development of this new viewability standard, see the [IAB open measurement documentation](//iabtechlab.com/working-groups/open-measurement-working-group/)."]]
