Open Measurement'ı etkinleştirme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
HTML5 için IMA SDK'sı, üçüncü taraf görüntülenebilirlik ve doğrulama ölçümünü etkinleştirmek amacıyla Interactive Advertising Bureau (IAB) tarafından geliştirilen bir endüstri standardı olan Open Measurement (OM) SDK'sını içerir. HTML5 için IMA SDK'sı kullanılırken, dahil edilen OM SDK'sı VAST reklam etiketlerindeki <AdVerifications> etiketini otomatik olarak ayrıştırır ve görüntülenebilirlik verilerini OMID API'yi kullanarak belirtilen ölçüm tedarikçi firmalarına gönderir. Doğrulama komut dosyasının hangi içeriğe erişebileceğini kontrol etmek için isteğe bağlı olarak her istek için erişim modu kuralları ayarlayabilirsiniz.
IMA SDK'sı, OM SDK'sı 1.4 sürümünü destekler.
Ön koşullar
VAST 4.1 veya sonraki bir sürüm kullanılıyorsa reklamlar, <AdVerifications> kullanarak doğrulama sağlayacak şekilde yapılandırılmalıdır. Önceki VAST sürümleri kullanılıyorsa reklamlarda <Extension type="AdVerifications"> kullanılmalıdır.
Reklamlarınız Ad Manager üzerinden trafik alıyorsa Ad Manager ağınız için bir görüntülenebilirlik sağlayıcısı yapılandırın ve bu görüntülenebilirlik sağlayıcıyı satır öğenize atayın. Daha fazla bilgi için Ad Manager ağınız için görüntülenebilirlik sağlayıcısı yapılandırma başlıklı makaleyi inceleyin.
Erişim modları
OM SDK'sı, doğrulama komut dosyasının ne kadar erişebileceğini kontrol eden dört farklı erişim modunda doğrulama komut dosyalarının çalıştırılmasını destekler:
FULL: Doğrulama komut dosyası, reklam öğesine ve yayıncı sayfasına doğrudan erişebilir.
CREATIVE: Doğrulama komut dosyası ve reklam öğesi, yayıncı sayfasından korumalı alana alınır. Ancak komut dosyası, reklam öğesine doğrudan erişebilir.
LIMITED: Doğrulama komut dosyası korumalı alandadır ve reklam öğesine veya yayıncı sayfasına erişemez. Ayrıca, hangi yayıncı alanında olduğunu doğrudan doğrulayamaz.
Bazı görüntülenebilirlik sağlayıcılar tüm erişim modlarını desteklemeyebilir. Hangi modların desteklendiğini doğrulamak için görüntülenebilirlik sağlayıcılarınızla iletişime geçin. IMA daha önce DOMAIN erişim modunu destekliyordu. Bu mod artık varsayılan olarak LIMITED moduna ayarlandı.
Bir istek için erişim modu kurallarını ayarlama
Erişim modu kuralları StreamRequest düzeyinde ayarlanmalıdır. Farklı doğrulama komut dosyası sağlayıcıları için farklı erişim modları ayarlamak amacıyla her OmidVerificationVendor değerini yukarıda listelenen erişim modlarından birine eşleyen bir sözlük iletin. OmidVerificationVendor.OTHER alanı, sözlüğe açıkça dahil edilmeyen tüm tedarikçiler için varsayılan erişim modunu ayarlamak amacıyla kullanılır. Erişim modu kuralı belirtilmezse doğrulama komut dosyaları, tedarikçi firmalar için LIMITED erişim modunda çalışır.
GOOGLE değerini google.ima.dai.api.OmidAccessMode.FULL olarak ayarlayan aşağıdaki örneğe bakın. OmidVerificationVendor bölümünde listelenenler de dahil olmak üzere diğer tüm sağlayıcılar, varsayılan olarak OmidVerificationVendor.OTHER'ın ayarlandığı şekilde ayarlanır.
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 erişim modunu uygulamak için aşağıdaki adımların ikisini de uygulamanız gerekir:
Video oynatıcınızı sitenizin geri kalanından izole edilmiş güvenli bir iFrame'de korumalı alana alın.
Görüntülenebilirlik iş ortağınız için OmidAccessMode değerini FULL olarak ayarlayın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\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 use \u003ccode\u003e<AdVerifications>\u003c/code\u003e tags within VAST for the OM SDK to function correctly.\u003c/p\u003e\n"],["\u003cp\u003eFour access modes (FULL, CREATIVE, DOMAIN, LIMITED) control the level of access verification scripts have to creative content and publisher pages.\u003c/p\u003e\n"],["\u003cp\u003eAccess mode rules are set at the \u003ccode\u003eStreamRequest\u003c/code\u003e level and can be customized for different verification vendors.\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,["The 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- 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\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\u003cbr /\u003e\n\nAccess mode rules must be set at the\n[`StreamRequest`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/StreamRequest#omidAccessModeRules)\nlevel. To set different access modes for different verification script\nproviders, pass a dictionary that maps each\n[`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/global#OmidVerificationVendor)\nto one of the access modes listed above. The `OmidVerificationVendor.OTHER`\nfield is used to set the default access mode for all vendors not explicitly\nincluded in the dictionary. If no access mode rules are specified, verification\nscripts run in `LIMITED` access mode for vendors.\n\nSee the following example which sets `GOOGLE` to\n`google.ima.dai.api.OmidAccessMode.FULL`. All other providers, including those\nlisted in\n[`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/global#OmidVerificationVendor),\ndefault to how `OmidVerificationVendor.OTHER` is set. \n\n request.omidAccessModeRules = {};\n request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.GOOGLE]\n = google.ima.dai.api.OmidAccessMode.FULL;\n request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.OTHER]\n = google.ima.dai.api.OmidAccessMode.LIMITED;\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`."]]
