Etkinleştirici, Studio'nun ana kod kitaplığıdır. Bunu reklam öğesinin beyni olarak düşünün. Tüm bileşenler ve API çağrıları Etkinleştirici yoluyla kullanılmalıdır. Etkinleştirici kitaplığı, tüm rich media reklam öğeleri için gereklidir. Etkinleştirici'yi eklediğinizde, otomatik olarak reklam öğeniz:
- Görüntüleme süresi, gösterim sayısı, etkileşim süresi gibi metrikler ve diğer standart metrikler için standart izleme işlevselliğini içerir
- Video ve genişleme işlevselliği gibi daha karmaşık özellikleri işleyebilir
Etkinleştirici'yi ekleme
HTML dosyanızın <head> etiketine, Etkinleştirici'ye bağlantı veren bir komut dosyası etiketi ekleyin.
<script src="https://s0.2mdn.net/ads/studio/Enabler.js"></script>Burada, genel ad alanı içinde Etkinleştirici adında bir tekil nesne sunulur. Bunun üzerinden yöntemler çağırmak için Enabler.isInitialized(), Enabler.exit() vb. çağrıları yapın.
Reklam öğesinin boyutunu ayarlama
Resim veya videolardan farklı olarak, HTML dokümanlarının kendi boyutları yoktur. Reklamlarınızın doğru boyutta görüntülenmesi için HTML dosyanızın başlık bölümüne reklam boyutu meta etiketi ekleyin.
Aşağıdaki örnek meta etiketi kopyalayıp genişlik ve yükseklik değerlerini reklamınızın boyutuna uyacak şekilde değiştirin.
300x250 ölçüleri için örnek reklam boyutu meta etiketi
<meta name="ad.size" content="width=300,height=250">
İsteğe bağlı: Genişleyen bayraklar ayarlama
Genişleyen reklamlar için davranış ayarlamak amacıyla kullanabileceğiniz birkaç isteğe bağlı yöntem vardır. Bu yöntemlerden herhangi birini kullanmanız gerekirse aşağıdaki Etkinleştirici başlatma kodundan önce yerleştirin. Bu yöntemler şunlardır:
Enabler.setExpandingPixelOffsets(left:sayı, top:sayı, opt_expandedWidth:sayı, opt_expandedHeight:sayı)
Genişleyen reklamlar için sahne ofsetlerini belirler.-
Enabler.setIsMultiDirectional(value:Boole)
Reklamın birden çok yönde genişlemesine izin verir. -
Enabler.setStartExpanded(startExpanded:Boole)
Reklam yüklenirken kullanıcı tarafından genişletilmesini beklemeden halihazırda genişletilmiş olarak yüklenir.
Studio HTML5 SDK'sı konusunda bu yöntemler hakkında daha fazla bilgi edinebilirsiniz.
Etkinleştirici'nin başlamasını bekleme
Reklamdaki hiçbir şey Etkinleştirici başlatılana kadar otomatik yürütülmemelidir. Bu, her şeyin düzgün bir şekilde yüklenmesini ve Etkinleştirici yöntemlerine, kullanıcı reklamla etkileşime girmeden önce erişilebilmesini sağlar.
Dahili veya harici JavaScript'inizde Etkinleştirici'nin, doğru veya yanlış döndüren isInitialized yöntemini kullanarak başlatıldığını doğrulayın. Doğru ise işleminizi başlatacak çağrıyı yapın (bu örnekte enablerInitHandler()). Yanlış ise Etkinleştirici'nin INIT etkinliğini dinleyen bir yedek çağrı yapın.
// If true, start function. If false, listen for INIT.
window.onload = function() {
if (Enabler.isInitialized()) {
enablerInitHandler();
} else {
Enabler.addEventListener(studio.events.StudioEvent.INIT, enablerInitHandler);
}
}
function enablerInitHandler() {
// Start polite loading, or start animation,
// load in your image assets, call Enabler methods,
// and/or include other Studio modules.
}
Etkinleştirici başlatıldıktan sonra animasyonu başlatın, resim öğelerinizi ve çağrı izleme yöntemlerinizi yükleyin veya diğer Studio modüllerini ekleyin.
Etkinleştirici'yi güncelleme
Etkinleştirici'nin yeni bir sürümü yayınlandığında, Studio kullanıcı arayüzünde reklam öğenizin Etkinleştirici sürümünün eski olduğuna dair bir uyarı görürsünüz. Etkinleştirici'nin en son sürümüne geçmek için reklam öğesinin birincil HTML öğesini yeniden yükleyin.