Dołączanie wartości lub parametrów do adresów URL wyjścia

Cel

Chcesz dodać wartości do adresu URL na podstawie danych wejściowych użytkownika lub wartości dynamicznych z kreacji.

W ramach tego rozwiązania parametry dodawane są do adresów URL wyjścia określonych w Studio lub w usłudze Campaign Manager 360. Jeśli chcesz korzystać z dynamicznych adresów URL wyjścia pobranych z zewnętrznego źródła danych, np. z pliku danych XML lub Arkuszy Google, przeczytaj artykuł Używanie dynamicznych adresów URL wyjścia.

Rozwiązanie

Użyj ciągu zapytania wyjścia, dodając metodę Enabler.exitQueryString().Szczegóły znajdziesz w informacjach o pakiecie SDK HTML5 Studio.

Ciąg zapytania wyjścia jest przydatny, gdy chcesz wysłać dane do strony docelowej. Jeśli na przykład pole tekstowe w kreacji zawiera prośbę do użytkownika o przesłanie kodu pocztowego, możesz użyć ciągu zapytania wyjścia do przekazania kodu pocztowego na stronę docelową przy użyciu docelowego adresu URL.

Studio dodaje tylko ciąg zapytania do adresu URL wyjścia i nie ma kontroli nad używaniem tych danych na stronie docelowej. Aby dane ciągu zapytania działały w witrynie, musi ona mieć informacje o przekazywanych parametrach zapytania.

Przykłady

Ten artykuł dotyczy dwóch sposobów korzystania z ciągu zapytania wyjścia:

• Dodanie danych wejściowych użytkownika do adresu URL wyjścia
• Dodanie par klucz-wartość do adresu URL wyjścia

Możesz dodać wartości do docelowego adresu URL wyjścia w standardowej postaci ciągu zapytania przy użyciu Enabler.exitQueryString(id, opt_queryString) zamiast Enabler.exit(). W interfejsie internetowym Studio wpisz adres URL tak jak w przypadku standardowego zdarzenia wyjściowego. Parametr queryString zostanie dodany na końcu adresu URL.

W przypadku tej metody Studio automatycznie wykrywa, czy wpisany adres URL zawiera już ciąg zapytania, i wybiera odpowiedni separator: „?” lub „&”. Nie musisz więc już ręcznie dodawać separatora w wartości ciągu zapytania w kreacji.

Dowiedz się, w jaki sposób Studio wybiera separator „?” lub „&” w ciągu zapytania wyjścia

Jest to podstawowy przykład wywołania, które wypełnia URL wartością zmiennej theaterVar i pełnym wynikowym adresem URL wraz ze znakiem interpunkcyjnym dodanym przez Studio.

Enabler.exitQueryString("Buy Tickets","venue="+theaterVar);

Jeśli adresem URL dla tekstu "Buy Tickets" jest https://www.yoursite.com/purchasetickets.html, dane wyjściowe będą takie: https://www.yoursite.com/purchasetickets.html?venue=thecoliseum

Adres URL wpisany w Studio nie zawiera ciągu zapytania, więc Studio dodaje wartość z separatorem „?”. Jeśli jednak adresem URL dla tekstu "Buy Tickets" jest https://www.yoursite.com/purchasetickets.html?showid=1234, dane wyjściowe będą takie:

https://www.yoursite.com/purchasetickets.html?showid=1234&venue=thecoliseum

URL wpisany w Studio zawiera już ciąg zapytania, więc Studio dodaje wartość z separatorem „&”.

Dodanie danych wejściowych użytkownika do adresu URL wyjścia

Aby dodać do strony docelowej informacje o kodzie pocztowym użytkownika z wejściowego pola tekstowego w kreacji, skorzystaj z tego przykładu:

var zipCode = document.getElementById("zipcode").value;

function zipExitHandler() {

  // Jeśli na przykład wartość „10023” jest w polu tekstowym o identyfikatorze „zipcode”.
  Enabler.exitQueryString("my zip exit", "zip="+ zipCode);
}

exitBtn.addEventListener('click', zipExitHandler, false);

Jeśli w Studio wpiszesz adres URL http://www.purchasetickets.com dla tekstu my zip exit, dane wyjściowe będą takie:

http://www.purchasetickets.com?zip=10023

Dodanie par klucz-wartość do adresu URL wyjścia

Aby dodać do strony docelowej wartości loc i name ustawione przez trafikera lub witrynę, skorzystaj z tego przykładu:

Dostęp do wartości loc i name trzeba uzyskać przy użyciu metody Enabler.getParameter() w Studio. Więcej informacji o tej metodzie znajdziesz w dokumentacji pakietu SDK HTML5 Studio.

var locVar = Enabler.getParameter("loc");
var nameVar = Enabler.getParameter("name");

function onKeyValueExitHandler() {
  Enabler.exitQueryString(
      "my key value exit",
      "loc="+locVar+"&name="+nameVar);
}

exitBtn.addEventListener('click', onKeyValueExitHandler, false);

Jeśli w Studio wpiszesz URL http://www.purchasetickets.com dla tekstu my key value exit, a para klucz-wartość jest ustawiona na „madison” dla zmiennej loc i „mraz” dla zmiennej name, dane wyjściowe będą takie:

http://www.purchasetickets.com?loc=madison&name=mraz