Wyjścia makr w Studio

Cel

Wstawienie informacji/makra usługi Studio do adresu URL wyjścia.

Rozwiązanie

Informacje ze Studio, takie jak identyfikator reklamy, możesz dodać na dwa sposoby:

• Dodaj makra Studio w docelowym adresie URL w interfejsie internetowym Studio

• Pobierz informacje ze Studio przy użyciu interfejsu API Studio i utwórz ciąg zapytania lub pełny URL w kodzie kreacji. Następnie użyj metody Enabler.exitQueryString(id, queryString).

Gdy używasz dynamicznych adresów URL wyjścia, strona docelowa może przekierowywać użytkowników do innego URL-a. Tym działaniem steruje serwer strony docelowej, a nie Studio.

Konfiguracja

Przed dodaniem makr Studio do wyjść zapoznaj się z tabelą poniżej. Zawiera ona informacje o dostępnych makrach i odpowiadających im wywołaniach API Studio. Jeśli chcesz dodać parametry Studio do adresu URL wyjścia bezpośrednio w kodzie kreacji, upewnij się, że istnieje odpowiednia do tego celu metoda interfejsu API Studio. Jeśli nie ma takiej metody, nie będzie można pobrać informacji ze Studio do wyjścia.

Makra obsługiwane przez Studio

Makro	Metoda Studio API	Parametr serwera reklam Studio
%eadv!	Enabler.getParameter("adv");	Identyfikator reklamodawcy
%eaid!	Enabler.getDartAdId();	Identyfikator reklamy
%ebuy!	Enabler.getParameter(“buy”);	Identyfikator kampanii
%ecid!	Enabler.getDartCreativeId();	Identyfikator kreacji
%epid!	Enabler.getDartPageId();	Identyfikator miejsca docelowego
%erid!	Enabler.getDartRenderingId();	Identyfikator renderowania
%esid!	Enabler.getDartSiteId();	Identyfikator witryny
%n	Brak dostępnego API	Liczba losowa
%p	Brak dostępnego API	Dopasowanie do wzorca
%s	Enabler.getDartSiteName();	Nazwa witryny

 

Informacje Studio są dostępne tylko wtedy, gdy kreacja wyświetla się w aktywnym tagu. Podczas podglądu makra Studio zwracają 0 lub nierozstrzygnięte wartości makr. Odpowiadające im metody interfejsu API Studio zwracają w trakcie wyświetlania podglądu w Studio lub testowania lokalnego 0, null lub "".

Jeśli kreacja pobiera adresy URL wyjścia z zewnętrznego źródła (XML, JSON) i zawierają one wartości makr Studio, trzeba zastąpić wartości makr w reklamie odpowiednimi metodami interfejsu API Studio przy użyciu mechanizmu zastąpienia string w kodzie kreacji. Tabela powyżej zawiera informacje o makrach odpowiadających poszczególnym metodom interfejsu API Studio. Wartości makr Studio nie wolno kodować na stałe w kreacji.

Jeśli wartości makr Studio są zakodowane na stałe w kreacji, nie zastąpią ich odpowiednie parametry serwera reklam Studio w aktywnym tagu. W przypadku wartości zakodowanych na stałe istnieje także ryzyko, że po kliknięciu kreacji adres URL będzie uruchamiał blokowanie wyskakujących okienek w przeglądarkach Internet Explorer. Adresów URL wyjścia zakodowanych na stałe w kreacji nie można zastąpić w interfejsie internetowym Studio ani w DCM.

Przykłady

Dodaj makra Studio w docelowym adresie URL w Studio

Wklej adres URL strony docelowej, zawierający dane makr Studio, w polu Docelowy URL na karcie Zdarzenia > Wyjścia w Studio.

Przykładowy zewnętrzny URL przekierowania
W tym przykładzie makra są podświetlone na czerwono.

http://yourdomain.com/clk?aAgencyId=01&aSource=adsrv&aTrackDataExt=
%epid!;%eaid!;%ecid!&migRandom=%n&aTrackFmtExt=client;io;ad;crtv&
aUnencodedDest=http://yourdomain.com

Użyj parametrów Studio w kodzie kreacji, a następnie podaj podstawowy adres URL w Studio

1. Zamiast używać metody Enabler.exit() w kodzie, zastąp wyjście, do którego chcesz dodać parametry, metodą Enabler.exitQueryString(). Pozwala ona na ustawienie podstawowego adresu URL w Studio i dołączenie do niego parametrów w kodzie kreacji.
2. W drugim parametrze metody exitQueryString dodaj metody interfejsu API Studio, które odpowiadają poszczególnym parametrom Studio. Dostępne metody znajdziesz w pakiecie SDK Studio HTML5 (aby przejść bezpośrednio do ich listy, wyszukaj na stronie „getDart”). Oto przykładowy kod JavaScript kreacji HTML5:

   
   var adIdVar = Enabler.getDartAdId();
   var siteIdVar = Enabler.getDartSiteId();
   
   function exitHandler() {
     Enabler.exitQueryString("my exit", "adid=" + adIdVar + "&siteid=" + siteIdVar);
   }
   
   exitBtn.addEventListener('click', exitHandler, false);

3. Dodaj podstawowy URL w polu docelowego adresu URL na karcie Zdarzenia > Wyjścia.

   Jeśli na przykład jako podstawowy URL podasz http://yourdomain.com/, wynikowy URL otwierany po kliknięciu reklamy w aktywnym tagu będzie mieć taką postać:
   
   http://yourdomain.com/?adid=123456789&siteid=12345