Komponent Enabler to główna biblioteka kodu w Studio. To jakby mózg kreacji. Muszą przez niego przejść wszystkie wywołania komponentów i interfejsu API. Biblioteka Enabler jest wymagana we wszystkich kreacjach multimedialnych. Gdy ją dodasz, automatycznie zyskujesz pewność, że kreacja:
- zawiera standardowe funkcje śledzenia danych takich jak czas wyświetlania, liczba wyświetleń, czas interakcji i innych danych standardowych;
- może obsługiwać bardziej złożone funkcje, np. odtwarzanie filmów czy rozwijanie.
Dodawanie komponentu Enabler
Do tagu <head> w pliku HTML dodaj tag script, który tworzy połączenie z komponentem Enabler:
<script src="https://s0.2mdn.net/ads/studio/Enabler.js"></script>To powoduje utworzenie pojedynczego obiektu Enabler w globalnej przestrzeni nazw. Aby wywołać jego metody, użyj instrukcji Enabler.isInitialized(), Enabler.exit() itp.
Ustawianie rozmiaru kreacji
W przeciwieństwie do obrazów czy filmów dokumenty HTML nie mają określonych wymiarów. Aby wyświetlać reklamę w odpowiednim rozmiarze, dodaj do sekcji <head> pliku HTML metatag rozmiaru reklamy.
Skopiuj poniższy przykładowy metatag, a następnie zmień szerokość i wysokość, aby pasowały do rozmiaru kreacji.
Przykładowy metatag rozmiaru reklamy dla kreacji o wymiarach 300 x 250
<meta name="ad.size" content="width=300,height=250">
Opcjonalnie: ustawianie reklam rozwijanych
Istnieje kilka opcjonalnych metod, za pomocą których można ustawić sposób działania reklam rozwijanych. Jeśli potrzebujesz użyć którejś z tych metod, zastosuj je przed kodem inicjującym komponentu Enabler poniżej. Są to następujące metody:
Enabler.setExpandingPixelOffsets(left:number, top:number, opt_expandedWidth:number, opt_expandedHeight:number)
Konfiguruje przesunięcie sceny na potrzeby rozwiniętej formy reklamy.-
Enabler.setIsMultiDirectional(value:Boolean)
Zezwala reklamie na rozwijanie się w wielu kierunkach. -
Enabler.setStartExpanded(startExpanded:Boolean)
Sprawia, że reklama ładuje się w wersji rozwiniętej – użytkownik nie musi jej rozwijać.
Więcej informacji na temat tych metod znajdziesz w pakiecie SDK HTML5 usługi Studio.
Oczekiwanie na zainicjowanie komponentu Enabler
Żadna część reklamy nie może być automatycznie uruchamiana przed zainicjowaniem komponentu Enabler. Dzięki temu wszystko wczytuje się poprawnie, a metody komponentu Enabler stają się dostępne, zanim użytkownik wejdzie w interakcję z reklamą.
W pliku JavaScript sprawdź, czy Enabler został zainicjowany przy użyciu metody isInitialized, która zwraca wartość true (prawda) lub false (fałsz). Jeśli wartość to prawda, wywołaj wybraną funkcję – w tym przykładzie to enablerInitHandler(). W przeciwnym razie wykonaj wywołanie zastępcze, aby dodać odbiornik zdarzenia INIT komponentu Enabler.
// Jeśli true, rozpocznij funkcję. Jeśli false, czekaj na INIT.
window.onload = function() {
if (Enabler.isInitialized()) {
enablerInitHandler();
} else {
Enabler.addEventListener(studio.events.StudioEvent.INIT, enablerInitHandler);
}
}
function enablerInitHandler() {
// Uruchom kontrolę wczytywania lub animację,
// załaduj zasoby graficzne, wywołaj metody komponentu Enabler,
// oraz dołącz inne moduły Studio.
}
Po zainicjowaniu komponentu Enabler możesz rozpocząć animację, wczytać zasoby graficzne, wywołać metody śledzące lub dołączyć inne moduły Studio.
Aktualizowanie komponentu Enabler
Gdy opublikujemy nową wersję komponentu Enabler, w interfejsie Studio zobaczysz ostrzeżenie, że wersja używana w Twojej kreacji jest nieaktualna. Aby uaktualnić komponent Enabler do najnowszej wersji, ponownie prześlij podstawowy zasób HTML kreacji.