Śledzenie konwersji

Podsumowanie

Śledzenie konwersji służy do śledzenia konwersji rozpoczętych przez Google za pomocą jednej z naszych integracji z Action Center. Jest to bardzo ważne, aby integracja działała prawidłowo i bezpiecznie oraz aby mogła wpływać na pozycję w rankingu niektórych stron. Za każdym razem, gdy Google wyświetla link do działania, adres URL jest modyfikowany, aby zawierał unikalny parametr zapytania: rwg_token. To Twoja odpowiedzialność, aby przechowywać ten token i zwracać odpowiednie wartości, gdy użytkownik dokona rezerwacji.

Aby dokończyć integrację, wykonaj te czynności:

1. Zbieraj i przechowuj dane rwg_token.
2. Zbierz i przechowuj dane sprzedawcy.
3. Zwraca wartości rwg_token i merchant_change.
4. Testowanie i weryfikowanie śledzenia konwersji.

Zbieraj i przechowuj dane rwg_token.

Aby dokończyć tę integrację, musisz zbierać i przechowywać rwg_token przez maksymalnie 30 dni od momentu początkowego polecenia przez Google. Wartość rwg_token to zakodowany ciąg znaków zawierający metadane dotyczące linku i sprzedawcy, który go wygenerował. Pamiętaj, że w tokenie nie są przechowywane ani szyfrowane żadne dane użytkownika.

Zbiór tokenów

Gdy użytkownik zostanie przekierowany na Twoją stronę rezerwacji, do podanego adresu URL zostanie dołączony nowy parametr zapytania rwg_token. Na stronie rezerwacji musisz przeanalizować wartość. Dołączony jest przykładowy sposób parsowania tego tokena na potrzeby śledzenia na poziomie urządzenia za pomocą przeglądarki.

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

Parametr zapytania dołączony do adresu URL będzie zaszyfrowanym tokenem, jak w tym przykładzie: rwg_token. Użyj tego przykładowego tokena, aby mieć pewność, że token jest poprawnie analizowany, w tym znaki specjalne, takie jak „=". Poniżej znajdziesz przykładowy token.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Miejsce na tokeny

Podczas przechowywania rwg_token możesz stosować śledzenie konwersji na 2 poziomach: na poziomie urządzenia i użytkownika. Gdzie chcesz przechowywać token, zależy od Ciebie, ale musisz go przechowywać przez 30 dni od momentu pierwszego polecenia.

Następny przykład to śledzenie konwersji na poziomie urządzenia, które polega na przechowywaniu tych wartości w przeglądarce za pomocą własnego pliku cookie. W tym przykładzie zakładamy, że wartość tokena została przeanalizowana i przechowywana w zmiennej, tak jak w przykładzie dotyczącym przechowywania tokenów. Pamiętaj, aby zaktualizować adres rootdomain.com, podając swoją domenę.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Wybierając miejsce na dane rwg_token, weź pod uwagę te kwestie.

Pamięć na poziomie urządzenia

Poziom urządzenia obejmuje pliki cookie przeglądarki, pamięć lokalną, pamięć lokalną aplikacji lub dowolną inną metodę, która może przechowywać token przez 30-dniowy okres atrybucji. Ponieważ token jest przechowywany lokalnie na urządzeniu użytkownika, jeśli użytkownik zmieni urządzenie, wyczyści pamięć podręczną lub pliki cookie albo będzie używać trybu prywatnego lub incognito, zdarzenie konwersji może nie zostać prawidłowo przypisane. Jeśli korzystasz z śledzenia konwersji na poziomie urządzenia, musisz ponownie zaimplementować tę funkcję na wszystkich obsługiwanych platformach (w tym na urządzeniach mobilnych).

Miejsce na dane na poziomie użytkownika

Poziom użytkownika obejmuje zapisywanie danych w bazie danych aplikacji za pomocą systemu analitycznego po stronie serwera lub innych systemów po stronie serwera. Ponieważ token jest przechowywany po stronie serwera, jeśli użytkownik zmieni urządzenie, wyczyści pamięć podręczną lub pliki cookie albo będzie korzystał z przeglądania prywatnego lub trybu incognito, zdarzenie konwersji zostanie przypisane po ponownym zalogowaniu się użytkownika. Jeśli używasz śledzenia konwersji na poziomie użytkownika, w zależności od architektury systemu możesz wdrożyć to raz po stronie serwera i wykorzystywać na wszystkich obsługiwanych platformach.

Za każdym razem, gdy Google wyświetli link podany w plikach danych, adres URL jest modyfikowany, aby zawierał unikalny parametr zapytania: rwg_token. Wartość rwg_token to zakodowany ciąg znaków zawierający niektóre metadane dotyczące klikniętego przez użytkownika linku, ale bez danych użytkownika. Musisz przechowywać ten token i przekazywać go jako część zdarzenia konwersji.

Odświeżanie tokena

Gdy użytkownik zostanie skierowany przez Google do tego samego sprzedawcy, a dotychczasowy token jest przechowywany, zostaje on zastąpiony nowym tokenem z najnowszego skierowania. Po wymianie tokena 30-dniowy okres przechowywania tokena jest resetowany, a wszystkie nowe konwersje tego sprzedawcy powinny być przypisane do najnowszego tokena.

Więcej informacji znajdziesz w wymaganiach dotyczących atrybucji konwersji.

Zbierz i przechowuj dane sprzedawcy.

Gdy użytkownik zostanie przekierowany na stronę rezerwacji, musisz zaimplementować logikę, która znajdzie i zarejestruje sprzedawcę. Zwykle partnerzy dodają metadane sprzedawcy lub merchant_id do linków do działań, aby identyfikować i przechowywać informacje o sprzedawcu. Zalecamy zapisanie merchant_id (lub wybranego identyfikatora) obok rwg_token, aby po potwierdzeniu rezerwacji przez użytkownika można było skontaktować się ze sprzedawcą przed wysłaniem żądania konwersji. Podobnie jak w przypadku okna przechowywania tokena, w przypadku sprzedawcy musi być zapisywany wraz z tokenem przez 30 dni od daty początkowego polecenia.

W następnych przykładach zostanie skorygowany wcześniej zapisany obiekt rwg_token. Zakładamy, że z metadanych w podanym adresie URL wyodrębniasz sprzedawcę i zapisujesz go jako merchant_id lub dopasowujesz do istniejącego merchant_id.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Zwraca wartości rwg_token i merchant_change.

Gdy użytkownik zarezerwuje produkt lub usługę, która została zainicjowana za pomocą linku do działania, musisz wysłać żądanie HTTP POST do punktu końcowego konwersji. Dostępne są 2 punkty końcowe: jeden dla środowiska produkcyjnego, a drugi dla środowiska piaskownicy.

• Wersja produkcyjna: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Podczas wysyłania zdarzenia konwersji musisz podać zapisaną wartość rwg_token oraz wartość merchant_change 1 lub 2. Więcej informacji o wartości merchant_change znajdziesz w artykule Zwracanie wartości zmiany przez sprzedawcę.

Treść żądania POST powinna być obiektem zakodowanym w formacie JSON w formacie:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

Następujący przykład obejmuje śledzenie konwersji na poziomie urządzenia za pomocą pliku cookie na urządzeniu użytkownika. Jest on napisany w języku JavaScript:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

Zwracanie wartości zmiany sprzedawcy

Wartość merchant_changed służy do określenia, czy sprzedawca został zmieniony w stosunku do pierwotnego sprzedawcy przekierowania. Zmiana sprzedawcy jest częsta, jeśli strona docelowa znajduje się na platformie, która obejmuje innych sprzedawców. W tym przypadku, jeśli użytkownik został skierowany na Twoją platformę przez Google i postanowił przejść do innej witryny sprzedawcy, aby dokonać rezerwacji, chcemy wiedzieć, że nastąpiła konwersja, ale z udziałem innego sprzedawcy. Nie musimy znać nazwy sprzedawcy, wystarczy, że nastąpiło zdarzenie konwersji i udział wziął w nim inny sprzedawca. Aby określić, czy sprzedawca się zmienił, używamy wartości logicznej.

Aby zdecydować, jaką wartość przypisać merchant_change, musisz wziąć pod uwagę pierwotnego sprzedawcę zapisanego w Zbieranie i przechowywanie danych o sprzedawcu i sprawdzić, czy sprzedawca się zmienił. Następnie przypisz wartość, korzystając z tabeli poniżej.

Jeśli strona rezerwacji nie znajduje się na platformie lub użytkownicy nie mogą przejść do innego sprzedawcy, możesz zakodować na stałe wartość tych żądań na 2. Jest to typowe dla partnerów, którzy integrują strony rezerwacji z witryną sprzedawcy lub mają niestandardowe strony docelowe do przetwarzania rezerwacji.

Testowanie i weryfikowanie śledzenia konwersji.

Aby sprawdzić, czy implementacja śledzenia konwersji jest prawidłowa, wykonaj ten test. Używaj linków do działań powiązanych z Twoimi sprzedawcami i wysyłaj żądania w oknie prywatnym lub incognito, aby usunąć wcześniejsze tokeny powiązane z tym użytkownikiem.

1. Dokończ rezerwację, korzystając tylko z linku do działania.
   • Rezerwacje bezpośrednie bez odesłania lub wcześniej zapisanych tokenów nie powinny powodować wysyłania żadnych żądań do Google.
2. Dokończ rezerwację, korzystając z linku z dołączonym rwg_token.
   • Upewnij się, że żądanie zostało wysłane i posiada wartość rwg_token oraz merchant_change o wartości 2
   • Pamiętaj, aby przechowywać rwg_token przez 30 dni.
3. Zarezerwuj ponownie to samo miejsce u tego samego sprzedawcy, używając nowego rwg_token.
   • Upewnij się, że żądanie zostało wysłane i zawiera nową wartość rwg_token i merchant_change o wysokości 2.
   • Okno przechowywania atrybucji tokenu jest odświeżane przez 30 dni
4. Przejdź bezpośrednio na stronę rezerwacji dostawcy, którego testujesz, i zrób nową rezerwację bez dołączonego rwg_token.
   • Upewnij się, że żądanie zostało wysłane z wcześniej zapisaną wartością rwg_token, a wartość merchant_change to 2.

Jeśli jesteś właścicielem platformy, która umożliwia użytkownikom dokonanie płatności za pomocą innego sprzedawcy, przetestuj te elementy.

1. Otwórz stronę rezerwacji sprzedawcy, korzystając z linku z dołączonym rwg_token, a potem przejdź do innego sprzedawcy i zrób rezerwację.
   • Upewnij się, że żądanie zostało wysłane z wartością rwg_token i merchant_change równą 1.

Podczas testowania wyślij żądanie HTTP POST do punktu końcowego konwersji. Dostępne są 2 punkty końcowe: jeden do środowiska produkcyjnego, a drugi do środowiska piaskownicy.

• Wersja produkcyjna: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Do linku do działania lub adresu URL musisz dołączyć ten token:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Użyj tego tokena do testów, które wymagają dodatkowych tokenów.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Po wysłaniu zdarzeń konwersji możesz zobaczyć ich zbiorcze podsumowanie w Centrum działań w panelu Śledzenie konwersji. Pamiętaj, że konwersje mogą pojawić się w panelu dopiero po upływie godziny.

Wymagania dotyczące atrybucji konwersji

Wymagany przez Google standard atrybucji konwersji to 30-dniowe okno atrybucji w przypadku każdej interakcji z linkiem do miejsca docelowego w dowolnym sklepie.

W tym oknie atrybucji Google oczekuje, że zdarzenie konwersji zostanie wysłane w jednym z tych scenariuszy:

• Użytkownik klika link do działania związanego z miejscem docelowym i w tej samej sesji składa zamówienie u tego samego sprzedawcy. (Merchant Change Value = 2 )
• Użytkownik klika link do działania w miejscu docelowym, a potem w okresie 30 dni wraca z innego kanału, aby złożyć zamówienie u tego samego sprzedawcy. (Merchant Change Value = 2 )
• Użytkownik klika link do działania związanego z miejscem, a potem składa zamówienie w innym sklepie – w ramach tej samej sesji lub w innej sesji w ciągu 30 dni. ( Merchant Change Value = 1 )

Google oczekuje też, że zdarzenia konwersji będą wysyłane ze wszystkich miejsc, do których użytkownik może trafić po kliknięciu linku do działania związanego z miejscem. W tym:

• aplikacje internetowe na komputery lub urządzenia mobilne;
• aplikacje mobilne – za pomocą precyzyjnego linku do aplikacji lub zarejestrowanego zamiaru korzystania z aplikacji w Twojej domenie;

Jeśli token jest przechowywany na poziomie użytkownika (patrz: trwałe przechowywanie tokena), należy zapewnić atrybucję na wielu urządzeniach. Oznacza to, że użytkownik, który kliknie link działania na komputerze, a potem dokona transakcji na urządzeniu mobilnym (korzystając z tego samego konta użytkownika), powinien wywołać zdarzenie konwersji.

Jeśli token jest przechowywany wyłącznie na poziomie urządzenia, np. w plikach cookie przeglądarki, nie musisz zapewniać atrybucji na różnych urządzeniach. W takim przypadku każde urządzenie miałoby osobny token, jeśli użytkownik kliknął na nim link do działania, a każde urządzenie miałoby odrębne reguły atrybucji.