Planowane zmiany w API - przypomnienie

Przypominamy, że 4 września 2019 wprowadzone zostaną zmiany związane z Refaktoringiem planów emisyjnych kampanii i zleceń. Zmiany opisane 31 lipca 2019 będą miały wpływ na operacje API i w przyszłości ułatwią wprowadzanie nowych funkcjonalności w AdOcean.

Brand safety

Wszyscy zgadzamy się, że ważne jest, aby dbać o kontekst, w którym prezentowane są marki - AdOcean pomoże Ci zachować bezpieczeństwo, dzięki czemu reklamy będą wyświetlane obok treści odpowiednich dla promowanej marki. Dzięki funkcjonalności "Context patterns" możesz utworzyć listę fraz, które można później wykorzystać w targetowaniu kampanii. W ten sposób możesz zapewnić, że reklama pojawi się na stronach o konkretnej treści lub zabezpieczysz emisję reklamy przed wyświetleniem jej na stronach z niepasująca treścią.

Aby skorzystać z nowych możliwości, w zakładce Ustawienia w menu po lewej stronie należy wybrać "Brand safety" i wprowadzić wyrażenia.

Wybrane frazy należy wprowadzić wprowadzić w polu "Pattern" i potwierdzić klikając w przycisk "Dodaj". Zdefiniowane frazy będą prezentowane na liście. Domyślnie lista posortowana jest po dacie utworzenia (od najstarszych), ale można również posortować frazy alfabetycznie poprzez kliknięcie w odpowiednią ikonę z prawej strony tabeli.

Jeśli fraza została już użyta w jakimś targetowaniu, a jest w niej błąd, może zostać poprawiona - po kliknięciu w daną frazę możliwa jest jej edycja. Fraza zostanie zaktualizowana we wszystkich targetowaniach, w których jest użyta, więc nie trzeba dodatkowo edytować kampanii. Frazy będące w trakcie edycji są podświetlone ciemniejszym kolorem, a te, których zmiany zostały już zatwierdzone, podświetlone są na zielono.

Konfiguracja skryptu

Aby funkcjonalność Brand Safety mogła działać, niezbędna jest specjalna konfiguracja skryptu ado.config na stronie.

Szczegółowe informacje na temat konfiguracji dostępne są pod linkiem "Show configuration", prezentowanym w interfejsie nad listą wyrażeń.

Skrypt konfiguracyjny musi zawierać ustawienia mode: "new" oraz contextPatterns.

Przykład konfiguracji contextPatterns:

contextPatterns: {"domain" : "myao.adocean.pl","fileID" : "ijrbafhfbiwytdeuzmfelajcqxka","caseInsensitive" : true,"sentPatternsLimit" : 50}

• Opcja caseInsensitive domyślnie jest ustawiona na true co oznacza, że frazy "EXAmple" i "example" pasują do tych samych słów (np. "Example" i "exAMple"). Aby je rozróżnić, należy zmienić ustawienie na false.
• Opcja sentPatternsLimit domyślnie jest ustawiona na 50 co oznacza, że maksymalna liczba znaków dla fraz znalezionych na stronie to 50, a pozostała część wzorca będzie ignorowana.

Przykład kodu konfiguracyjnego korzystającego z contextPatterns
(kod należy wstawić w sekcji HEAD strony):

<script type="text/javascript" src="//myao.adocean.pl/files/js/ado.js"></script>
<script type="text/javascript">
/* (c)AdOcean 2003-2019 */
        if(typeof ado!=="object"){ado={};ado.config=ado.preview=ado.placement=ado.master=ado.slave=function(){};}
        ado.config({mode: "new", xml: false, consent: true, characterEncoding: true,
                contextPatterns: {
                        "domain" : "myao.adocean.pl",
                        "fileID" : "ijrbafhfbiwytdeuzmfelajcqxka",
                        "caseInsensitive" : true,
                        "sentPatternsLimit" : 50 
                }
        });
        ado.preview({enabled: true});
</script>

Context targeting

Targetowanie kontektsowe pozwala wyświetlić lub zablokować reklamy, jeśli zdefiniowana wcześniej w sekcji "Brand Safety" fraza znajduje się na danej stronie.

• Wzorce pasujące: Co najmniej jedna fraza z listy wyrażeń dopasowujących musi zostać znaleziona na stronie, aby wyświetlić na niej reklamę. Jeśli strona zawiera zarówno frazę z listy wyrażeń pasujących, jak i niepasujących, reklama nie zostanie wyświetlona. Jeśli lista wzorców dopasowujących jest pusta, tylko lista niepasujących wyrażeń jest brana pod uwagę.
• Wzorce niepasujące: Jeśli co najmniej jedna fraza z listy zostanie znaleziona na stronie, reklama nie zostanie wyświetlona.

Targetowanie można przypisać do danego zlecenia/surroundu lub jako targetowanie niezależne z wieloma placementami i kreacjami.

Nowy algorytm planowania kampanii - priorytety zleceń

Wprowadzamy nowy algorytm planowania kampanii - Priorytety zleceń. Po włączeniu tej opcji, podczas wybierania kreacji do emisji emiter sprawdza priorytety zleceń i wyświetla reklamy zgodnie z ich priorytetami od najwyższego do najniższego. Reklamy ze zlecenia o najniższym priorytecie będą emitowane tylko, jeśli wykonanie planu kampanii będzie zagrożone.

Aby skorzystać z tego algorytmu, w widoku właściwości kampanii należy wybrać opcję "Tryb emisji: Dla całej kampanii" i wybrać algorytm z listy rozwijanej.

Nowy szablon kreacji - SDK Shutter banner

Prezentujemy nowy szablon kreacji pozwalający wyświetlać reklamy w aplikacjach mobilnych: SDK Shutter banner. Zachowanie tej kreacji jest takie samo jak jej standardowej wersji, opisanej na stronie demo AdOcean.

Wersja SDK szablonu nie obsługuje opcji "Animate on mouse wheel", więc ten parametr nie jest prezentowany. Zalecamy również korzystanie z wartości "Horizontal" parametru "Orientation", z powodu pionowego przewijania treści aplikacji.

Aby zapewnić płynną animację, należy włączyć przyspieszenie sprzętowe w kodzie aplikacji (setHardwareAcceleration (true)).

adocean api brand safety context targeting planowanie priorytety zleceń sdk shutter banner szablony kreacji targetowanie kontekstowe