Używanie dynamicznych adresów URL wyjścia

Cel

Korzystanie z adresu URL wyjścia z zewnętrznego źródła danych (takiego jak Arkusze Google, plik danych XML czy Google Merchant Center) zamiast podawania go w Studio albo usługach Campaign Manager 360 lub Google Ad Manager.

Rozwiązanie

Metoda Enabler.exitOverride(id, url) z pakietu SDK HTML5 Studio zastępuje wszystkie adresy URL wyjścia podane w Studio albo w usługach Campaign Manager 360 lub Ad Manager.

Przykłady

Skonfiguruj zmienną exitURL, tak by przechowywała docelowy adres URL w kreacji. Adres URL możesz przekazać dynamicznie w pliku XML, pobrać z dynamicznego pliku danych lub zakodować na stałe.

Używanie adresu URL wyjścia z dynamicznego pliku danych w aplikacji Google Web Designer

1. Kliknij + na panelu Dynamiczny, by dodać wiązanie dynamiczne.
2. Na karcie Wiązania w oknie dialogowym Właściwości dynamiczne kliknij Dodaj powiązanie.
3. Jako element wybierz identyfikator obszaru kliknięcia.
4. Jako atrybut elementu wybierz Exit override URL (Zastępowanie adresu URL wyjścia).
5. W przypadku obiektu schematu danych wybierz obiekt z pliku danych, który reprezentuje dynamiczny adres URL (np. Product.0.url).

Dynamiczne elementy zamykające w Studio

Używanie adresu URL wyjścia z dynamicznego pliku danych w kodzie JavaScript

// Zastąp wartość dynamicContent poniżej własną wartością elementu dynamicznego.
var exitURL = dynamicContent.Feed_1[0].ExitURL.Url;

function exitClickHandler() {
  Enabler.exitOverride("nazwa wyjścia", exitURL);
}

exitButton.addEventListener('click', exitClickHandler, false);

Używanie zakodowanego na stałe adresu URL wyjścia w kodzie JavaScript

Korzystaj z tego sposobu tylko wtedy, gdy wiesz, że nie ma potrzeby późniejszej zmiany adresu URL. Jeśli zajdzie potrzeba zmiany adresu URL, będzie trzeba zaktualizować kod kreacji i ponownie przesłać ją do trafikowania.

// productId to wartość obliczana w innym miejscu kodu
//i nie znajduje się w tym przykładzie.
var exitURL = "http://www.yoursite.com?product=" + productId;

function exitClickHandler() {
  Enabler.exitOverride("nazwa wyjścia", exitURL);
}

exitButton.addEventListener('click', exitClickHandler, false);

 

Dodawanie wartości lub parametrów do dynamicznych adresów URL wyjścia

Dodaj do dynamicznych adresów URL wyjścia funkcję śledzenia od innej firmy, umieszczając w kodzie JavaScript kreacji dodatkową metodę, która będzie pobierać parametry ustawione w usłudze Campaign Manager 360. Użyj metody Enabler.getParameter, by pobierać wartość przyrostka strony docelowej (przechowywaną w makrze exit_suffix) i dodawać ją do adresów URL wyjścia z powiązanego dynamicznego pliku danych.

Krok 1. Dodaj kod do kreacji

Korzystając z jednej z opcji opisanych poniżej, dodaj do kreacji kod, by połączyć dynamiczny adres URL wyjścia z przyrostkiem z Campaign Managera 360.

Łączenie dynamicznego adresu URL wyjścia z przyrostkiem w aplikacji Google Web Designer

1. Kliknij obszar kliknięcia, do którego chcesz zastosować dynamiczne wyjście i przyrostek.
2. Dodaj nowe zdarzenie, klikając przycisk „+” w panelu zdarzeń.
3. Wybierz Obszar kliknięcia > Kliknięcie w etapie zdarzeń.
4. W etapie działań wybierz Niestandardowe > Dodaj działanie niestandardowe .
5. Dodaj nazwę funkcji, a potem wklej ten kod niestandardowy w obszarze tekstowym. Zastąp przykładowy adres URL wyjścia własnym.
6. Kliknij OK.

// Zastąp wartość dynamicContent poniżej własną wartością elementu dynamicznego.
var exitURL = dynamicContent.Feed_1[0].ExitURL.Url;
var urlSuffix = Enabler.getParameter('exit_suffix'); 
var symbol = (exitURL.indexOf('?') > -1) ? '&': '?'; 
if (urlSuffix) { 
  while (urlSuffix.charAt(0) == '?' || urlSuffix.charAt(0) == '&') { 
    urlSuffix = urlSuffix.substring(1); 
  } 
  if (urlSuffix.indexOf('?') > -1) { 
    urlSuffix = urlSuffix.replace(/\?/g, '&'); 
  } 
} 
exitURL = exitURL + symbol + urlSuffix;

Enabler.exitOverride('exit', exitURL);

Łączenie dynamicznego adresu URL wyjścia z przyrostkiem za pomocą JavaScriptu w dowolnym edytorze kodu HTML

Jeśli używasz innego edytora HTML niż Google Web Designer, użyj metody JavaScript podobnej do opisanej poniżej, by pobrać przyrostek wyjścia z Campaign Managera 360. Zanim będzie można wywołać tę funkcję, musisz załadować i zainicjować komponent Enabler.

function addSuffix(url, dcmParameter) { 
  var urlSuffix = Enabler.getParameter(dcmParameter); 
  var _url = ''; 

  if (url) { 
    var symbol = (url.indexOf('?') > -1) ? '&': '?'; 
    if(urlSuffix) { 
      while (urlSuffix.charAt(0) == '?' || urlSuffix.charAt(0) == '&') { 
        urlSuffix = urlSuffix.substring(1); 
      } 
      if (urlSuffix.indexOf('?') > -1) { 
        urlSuffix = urlSuffix.replace(/\?/g, '&'); 
      } 
    } 
    _url = url + symbol + urlSuffix; 
  } 
  return _url; 
} 

// Przykład użycia tej funkcji:
exitUrl = addSuffix(exitUrl, 'exit_suffix'); 

Krok 2. Dodaj parametry adresu URL w usłudze Campaign Manager 360

Po dodaniu kreacji do Campaign Managera 360 podaj parametry zapytania, które będą dołączone do adresu URL wyjścia. Aby to zrobić, dodaj przyrostek strony docelowej.

Miejsce, w którym musisz dodać przyrostek, zależy od tego, gdzie ma być on stosowany:

• Wszystkie strony docelowe we wszystkich kampaniach: dodaj przyrostek we właściwościach reklamodawcy.
• Wszystkie strony docelowe w jednej kampanii: dodaj przyrostek we właściwościach kampanii.
• Wszystkie kreacje przypisane do reklamy: dodaj przyrostek we właściwościach reklamy.

Ustaw przyrostek na jak najwyższym poziomie, tak by był on stosowany do większej liczby kreacji. Aby go zastąpić, możesz skonfigurować go na bardziej precyzyjnym, niższym poziomie. Jeśli na przykład skonfigurujesz przyrostek we właściwościach reklamodawcy, zastąpią go wszystkie przyrostki ustawione we właściwościach kampanii lub reklamy.

Dodawanie przyrostka strony docelowej

1. Otwórz właściwości reklamy, kampanii lub reklamodawcy i kliknij Przyrostek adresu URL strony docelowej.
2. Wpisz cały przyrostek w polu tekstowym. Przyrostki mogą zawierać wiele parametrów zapytań, ale ich długość nie może przekraczać 128 znaków. Jeśli sufiks jest dziedziczony, możesz edytować go w elemencie nadrzędnym lub wyłączyć opcję Dziedzicz przyrostek adresu URL. Gdy dziedziczenie jest włączone, używany jest sufiks z jednostki nadrzędnej. Odziedziczony przyrostek w kampanii pochodzi z ustawień reklamodawcy. Odziedziczony sufiks w reklamie pochodzi z ustawień kampanii.
3. Campaign Manager 360 rozpozna wszystkie pary klucz-wartość w przyrostku i umożliwi ich edytowanie poniżej pola jako parametrów zapytania.Możesz wybrać makra lub wpisać ciągi niestandardowe. Aby usunąć parę klucz-wartość, kliknij Usuń .

Ustawienia przyrostka adresu URL strony docelowej i edytor par klucz-wartość w usłudze Campaign Manager 360

Więcej informacji o przyrostkach stron docelowych znajdziesz w Centrum pomocy Campaign Managera 360