Śledzenie konwersji

Implementacja

Podsumowanie

Implementacja śledzenia konwersji składa się z 3 elementów:

• Pobieram rwg_token i merchant_id ze strony docelowej lub aplikacji i punktu wejścia.
• Zachowywanie zasad rwg_token i merchant_id na potrzeby odpowiedniej atrybucji okno.
• Porównaj wartości merchant_id i merchant_id w czasie konwersji (rezerwacja ukończona).
• Wysyłanie zdarzenia konwersji w momencie konwersji (rezerwacja ukończona).

Ta implementacja śledzenia konwersji nie wymaga korzystania z Google Analytics lub dowolny kod JavaScript firmy zewnętrznej.

Przed rozpoczęciem pracy nad implementacją śledzenia konwersji zdecyduj, czy chcesz śledzić konwersje na poziomie urządzenia czy na poziomie użytkownika:

• Na poziomie urządzenia można korzystać z plików cookie przeglądarki, pamięci lokalnej i aplikacji pamięci masowej lub innej metody, która może zachować token przez 30 dni okna atrybucji. Ponieważ token byłby przechowywany lokalnie na na urządzeniu, jeśli użytkownik zmieni używane urządzenie, wyczyści dane lokalne pamięci, plików cookie, przeglądania prywatnego lub trybu incognito. zdarzenie konwersji może być nieprawidłowo przypisane. Na poziomie urządzenia śledzenia konwersji, musisz zaimplementować je ponownie w przypadku każdego obsługiwanego (w tym mobilnych).
• Poziom użytkownika obejmuje utrwalanie go w bazie danych aplikacji przez system analityczny po stronie serwera lub inne systemy po stronie serwera. Ponieważ po stronie serwera, gdy użytkownik zmieni urządzenie. korzysta z pamięci lokalnej, usuwa je z pamięci lokalnej lub pliki cookie albo korzysta z funkcji lub w trybie incognito zdarzenie konwersji jest przypisywane tylko raz użytkownik zaloguje się ponownie. Jeśli korzystasz ze śledzenia konwersji na poziomie użytkownika, w zależności w architekturze systemu. Może uda się wdrożyć to rozwiązanie raz na po stronie serwera i używać ich na wszystkich obsługiwanych platformach.

Zbieranie: rwg_token

Za każdym razem, gdy Google wyświetli link action_link podany przez Ciebie w plikach danych, ten URL został zmodyfikowany, by zawierał unikalny parametr zapytania: rwg_token. Wartość rwg_token to zakodowany ciąg znaków, który zawiera metadane dotyczące który kliknął użytkownik, ale nie zawiera danych użytkownika. Należy zapisać ten token oraz przekazać ją z powrotem w ramach zdarzenia konwersji.

Na każdej stronie docelowej / w punkcie wejścia do aplikacji musisz przeanalizować wartość ustawioną dla parametru rwg_token i przechowywać go. Wymagania dotyczące przechowywania został opisany w kroku z zachowaniem rwg_token.

Przykład analizy tego tokena pod kątem śledzenia na poziomie urządzenia przeglądarka jest dostępna poniżej. Możesz też zbierać ten token w po stronie serwera w odpowiedzi na żądanie:

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;
  }
}

Zbieranie: merchant_id

Jeśli logikę śledzenia konwersji wdrożysz we frontendzie, na stronie docelowej musisz zaimplementować niestandardowy skrypt, który znajdzie i przechwytuje merchant_id Zazwyczaj merchant_id może już znajdować się w strony docelowej lub adresu URL, aby można było potem przechwycić je z tego miejsca. Jeśli nie, musisz znaleźć sposób na ich umieszczenie, tak aby dało się to zrobić, zmian w backendzie.

Jeśli implementujesz logikę śledzenia konwersji w backendzie, możesz znaleźć merchant_id wraz z danymi, które wysyłają zapytania do systemu wewnętrznego w celu ich wygenerowania stronie frontendowej.

Ta wartość merchant_id musi być taka sama jak ta, którą udostępniasz Google w usłudze kanału.

Zachowuję te zasady: rwg_token i merchant_id

Musisz zachować parametr adresu URL rwg_token, który będzie dołączane do wszystkich podanych przez Ciebie linków do działań (łączna długość tych linków to 30 dni). Wartość rwg_token powinna być przechowywana i zwracana bez żadnych zmian.

Oprócz rwg_token musisz też przechowywać merchant_id powiązane z linkiem do działania.

Jeśli istniejący token został utrwalony podczas poprzedniej wizyty, wcześniejsze Parametry rwg_token i merchant_id należy zastąpić, oraz 30-dniowe okno dla pamięć masowa powinna zostać zresetowana.

Gdy utrzymujesz powyższą parę, możesz zapisać wartości na urządzeniu na poziomie użytkownika lub na poziomie użytkownika:

• Na poziomie urządzenia można korzystać z plików cookie przeglądarki, pamięci lokalnej i aplikacji pamięci masowej lub innej metody, która może zachować token przez 30 dni okna atrybucji.
• Poziom użytkownika obejmuje utrwalanie go w bazie danych aplikacji przez system analityczny po stronie serwera lub inne systemy po stronie serwera.

Poniżej znajduje się przykład śledzenia konwersji na poziomie urządzenia, gdzie te wartości są przechowywane w przeglądarki za pomocą własnego pliku cookie. W tym przykładzie zakładamy, że udało Ci się przeanalizować jak w przykładzie powyżej. Aby użyć tego przykładu, Klient musi zaktualizować domenę rootdomain.com w Twojej domenie.

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

Jeśli używasz śledzenia konwersji na poziomie użytkownika, dyrektywa rwg_token + merchant_id powinna są przechowywane na serwerze i powiązane z użytkownikiem.

Wysyłanie danych o konwersjach

Gdy użytkownik realizuje transakcję, która można przypisać usłudze Miejsca Google link do działania, musisz wysłać żądanie HTTP POST do punktu końcowego konwersji. Istnieją 2 punkty końcowe: jeden dla środowiska produkcyjnego, a drugi dla środowiska w środowisku piaskownicy.

• produkcyjne: https://www.google.com/maps/conversion/collect
• Piaskownica: https://www.google.com/maps/conversion/debug/collect

Treść posta powinna być obiektem zakodowanym w formacie JSON:

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

Przykład (niezmieniony sprzedawca z tokenem testowym dla partnera 20123456):

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

Wartość merchant_changed jest używana do określenia, czy sprzedawca uległ zmianie. od sprzedawcy. Istnieją dwie wartości, które można przekazywać

Zarówno w środowisku piaskownicy, jak i w środowisku produkcyjnym należy podać ma wartość rwg_token podczas wysyłania zdarzenia konwersji. Do testowania użyj po uruchomieniu tego tokena testowego w obu środowiskach:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Aby przeprowadzić test w trybie piaskownicy, musisz ręcznie dołączyć poniższy parametr URL do Twoje linki do piaskownicy:

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

Pełny przykład śledzenia konwersji na poziomie urządzenia (za pomocą pliku cookie w pliku cookie na urządzeniu) w JavaScript znajdziesz poniżej:

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
    })
  });
}

Jeśli korzystasz ze śledzenia konwersji na poziomie użytkownika, musisz pobrać token, który jest powiązana z użytkownikiem (niezależnie od tego, z jakiej platformy korzysta) mechanizm przechowywania danych po stronie serwera i wysłać token przy użyciu tego samego punktów końcowych piaskownicy.

Wymagania dotyczące atrybucji konwersji

Wymaganym przez Google standardem atrybucji konwersji jest 30-dniowy okres atrybucji dla dowolnej interakcji z linkiem do miejsca w dowolnym sklepie.

To okno atrybucji oznacza, że Google spodziewa się zdarzenia konwersji wysyłane w następujących sytuacjach:

• Użytkownik klika link do działania związanego z miejscem i składa zamówienie dla tego samego sprzedawcy podczas jednej sesji. (Wartość zmiany sprzedawcy = 2 )
• Użytkownik klika link do działania związanego z miejscem, a potem wraca z innego kanału. w ciągu 30 dni, aby złożyć zamówienie na tego samego sprzedawcę. (Sprzedawca zmiana wartości = 2 )
• Użytkownik klika link do działania związanego z miejscem, a potem składa zamówienie w innym miejscu w ramach tej samej sesji lub innej sesji w ciągu 30 dni okno. ( Wartość zmiany sprzedawcy = 1 )

Poza tym Google oczekuje, że zdarzenia konwersji będą wysyłane ze wszystkich platform użytkownik może wejść na stronę po kliknięciu linku do działania związanego z miejscem. W tym:

• Aplikacje internetowe na komputer lub urządzenia mobilne
• w aplikacjach mobilnych – za pomocą precyzyjnego linku lub zarejestrowanej aplikacji, w Twojej domenie

Jeśli token jest przechowywany na poziomie użytkownika (patrz: zapamiętywanie tokena), jest od konwersji na różnych urządzeniach. Oznacza to, że użytkownik, który obserwuje Na komputerze wyświetli się link do działania, a następnie zrealizuje transakcję na urządzeniu mobilnym (korzystając z tego samego konta użytkownika) powinna wywołać zdarzenie konwersji.

Jeśli token jest przechowywany wyłącznie na poziomie urządzenia, np. w przeglądarce plików cookie, nie należy stosować atrybucji na różnych urządzeniach. W tym każde urządzenie miałoby osobny token, gdyby użytkownik na jego urządzeniu, a każde z nich będzie korzystać z funkcji atrybucji. reguł oddzielnie.