HTML5 için IMA SDK'sı, üçüncü taraf görüntülenebilirlik ve doğrulama ölçümünü etkinleştirmek üzere Interactive Advertising Bureau (IAB) tarafından geliştirilen bir sektör 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 OMID API'yi kullanarak görüntülenebilirlik verilerini belirtilen ölçüm tedarikçilerine gönderir. Doğrulama komut dosyasının hangi içeriğe erişebileceğini kontrol etmek için her istek için isteğe bağlı olarak erişim modu kuralları ayarlayabilirsiniz.
IMA SDK, OM SDK v1.4'ü destekler.
Ön koşullar
VAST 4.1 veya daha yeni bir sürüm kullanılıyorsa reklamlar,
<AdVerifications>
kullanılarak 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 yayınlanıyorsa Ad Manager ağınız için bir görüntülenebilirlik sağlayıcısı yapılandırın ve bu 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, doğrulama komut dosyalarının dört farklı erişim modunda çalıştırılmasını destekler. Bu modlar, doğrulama komut dosyasının ne kadar erişebileceğini kontrol eder:
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ünürlük 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 ayarlanmıştır.
İstek için erişim modu kurallarını ayarlama
Erişim modu kuralları,AdsRequest
düzeyinde ayarlanmalıdır. Farklı doğrulama komut dosyası sağlayıcıları için farklı erişim modları ayarlamak üzere her OmidVerificationVendor
'ı yukarıda listelenen erişim modlarından biriyle eşleyen bir sözlük iletin. OmidVerificationVendor.OTHER
alanı, sözlüğe açıkça dahil edilmemiş tüm sağlayıcılar için varsayılan erişim modunu ayarlamak üzere kullanılır. Herhangi bir erişim modu kuralı belirtilmezse doğrulama komut dosyaları, tedarikçiler için LIMITED
erişim modunda çalışır.
GOOGLE
değerini google.ima.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
ayarına göre çalışır.
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.LIMITED;
CREATIVE
erişim modunu uygulamak için aşağıdaki adımların her 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ğeriniFULL
olarak ayarlayın.