Ta strona została przetłumaczona przez Cloud Translation API.

Śledzenie konwersji

Wdrażanie

Podsumowanie

Wdrożenie śledzenia konwersji składa się z 3 elementów:

Zbieranie rwg_token ze strony docelowej / punktu wejścia aplikacji.
Zachowanie rwg_token odpowiedniego okna atrybucji
Wysyłanie zdarzenia konwersji w momencie płatności

Ta implementacja śledzenia konwersji nie wymaga korzystania z Google Analytics ani zewnętrznego kodu JavaScript firmy zewnętrznej.

Zanim zaczniesz pracę nad wdrożeniem śledzenia konwersji, zastanów się, czy chcesz śledzić konwersje na poziomie urządzenia, czy na poziomie użytkownika:

Na poziomie urządzenia obejmuje użycie plików cookie przeglądarki, pamięci lokalnej, pamięci lokalnej aplikacji lub innej metody, która może zachowywać token na 30-dniowy okres atrybucji. Token będzie przechowywany lokalnie na urządzeniu użytkownika, więc jeśli użytkownik zmieni urządzenie, z którego korzysta, wyczyści pamięć lokalną lub pliki cookie albo użyje trybu prywatnego przeglądania lub incognito, zdarzenie konwersji może nie zostać prawidłowo przypisane. Jeśli korzystasz ze śledzenia konwersji na poziomie urządzenia, musisz ponownie zaimplementować je na wszystkich obsługiwanych platformach (w tym na urządzeniach mobilnych).
Poziom użytkownika obejmuje przechowywanie go w bazie danych aplikacji za pomocą systemu analitycznego po stronie serwera lub innych systemów po stronie serwera. Token będzie przechowywany po stronie serwera, więc jeśli użytkownik zmieni urządzenie, z którego korzysta, wyczyści pamięć lokalną lub pliki cookie albo użyje trybu prywatnego przeglądania lub incognito, zdarzenie konwersji zostanie przypisane, gdy użytkownik ponownie się zaloguje. W przypadku śledzenia konwersji na poziomie użytkownika w zależności od architektury systemu możesz to zrobić po stronie serwera i wykorzystywać go ponownie na wszystkich obsługiwanych platformach.

Zbieranie `rwg_token`

Za każdym razem, gdy Google wyświetla w pliku danych atrybut action_link podany przez Ciebie w pliku danych, zmieniamy ten adres URL, dodając unikalny parametr zapytania: rwg_token. Wartość rwg_token to zakodowany ciąg znaków, który zawiera metadane o linku klikniętym przez użytkownika. Zapiszesz go i przekażesz z powrotem w ramach zdarzenia konwersji.

Na każdej stronie docelowej lub w punkcie wejścia aplikacji musisz przeanalizować wartość parametru zapytania rwg_token i zapisać ją. Wymagania dotyczące przechowywania tego parametru opisano w kroku Stała właściwość rwg_token.

Przykład analizy tego tokena do śledzenia na poziomie urządzenia w przeglądarce znajdziesz poniżej. Możesz też zebrać ten token po stronie serwera, odpowiadając na żądanie:

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

Trwający `rwg_token`

Uwaga: dzięki temu, że właściwość rwg_token jest prawidłowa, wymagane jest poprawne wdrożenie wymaganego okna atrybucji. Więcej szczegółów o wymaganiach związanych z atrybucją znajdziesz poniżej w sekcji Wymagania dotyczące atrybucji konwersji.

Musisz zachować parametr rwg_token adresu URL, który zostanie dołączony do wszystkich podanych przez Ciebie linków do działań przez łącznie 30 dni. Wartość rwg_token powinna być przechowywana i zwracana bez zmian. Jeśli podczas poprzedniej wizyty zostanie zachowany token, stary token powinien zostać zastąpiony, a okno 30-dniowego miejsca na dane powinno zostać zresetowane.

Utrzymując token, możesz go zapisać na poziomie urządzenia lub użytkownika:

Na poziomie urządzenia obejmuje użycie plików cookie przeglądarki, pamięci lokalnej, pamięci lokalnej aplikacji lub innej metody, która może zachowywać token na 30-dniowy okres atrybucji.
Poziom użytkownika obejmuje przechowywanie go w bazie danych aplikacji za pomocą systemu analitycznego po stronie serwera lub innych systemów po stronie serwera.

Poniżej znajduje się przykład śledzenia konwersji na poziomie urządzenia. Zawiera on ten token w przeglądarce za pomocą własnego pliku cookie. W tym przykładzie zakładamy, że wartość tokena została analizowana w zmiennej jak w przykładzie powyżej. Aby skorzystać z tego przykładu, musisz zaktualizować „rootdomain” do swojej domeny.

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

Jeśli korzystasz ze śledzenia konwersji na poziomie użytkownika, zdarzenie rwg_token powinno być przechowywane na serwerze i powiązane z tym użytkownikiem.

Wysyłanie danych o konwersjach

Gdy użytkownik wykona transakcję, która jest przypisana do linku Miejsca Google, musisz wysłać żądanie POST HTTP do punktu końcowego konwersji. Istnieją 2 punkty końcowe: jeden dla środowiska produkcyjnego i jeden dla środowiska piaskownicy.

Produkcja: 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 w formacie:

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Zarówno w piaskownicy, jak i w środowiskach produkcyjnych, podczas wysyłania zdarzenia konwersji musisz podać prawidłowy atrybut rwg_token. Do testowania w środowisku piaskownicy możesz użyć tego tokena testowego.

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Uwaga: w środowisku produkcyjnym nie należy wysyłać zdarzeń konwersji, które nie są przypisane do tej integracji. Zanim wyślesz zdarzenie, sprawdź, czy wartość rwg_token jest prawidłowa.

Pełny przykład śledzenia konwersji na poziomie urządzenia (za pomocą pliku cookie na urządzeniu użytkownika) w języku JavaScript pokazującym, jak utworzyć to żądanie posta:

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

Jeśli korzystasz ze śledzenia konwersji na poziomie użytkownika, musisz pobrać token powiązany z użytkownikiem (niezależnie od platformy, z której korzystają), z tokena pamięci po stronie serwera i wysłać go przy użyciu tych samych punktów końcowych produkcji lub piaskownicy.

Uwaga: zdarzenia konwersji mogą być wysyłane z klienta internetowego lub klienta aplikacji albo z serwera. Możesz podjąć tę decyzję zależnie od potrzeb i miejsca przechowywania tokena, o ile zdarzenie konwersji jest wysyłane tylko raz na konwersję i zawiera prawidłową wartość rwg_token.

Wymagania dotyczące atrybucji konwersji

Wymaganym przez Google standardem atrybucji jest 30-dniowe okno atrybucji w przypadku każdej interakcji z linkiem do miejsca, w każdym sklepie.

To okno atrybucji oznacza, że w którymkolwiek z tych scenariuszy należy wysyłać zdarzenie konwersji:

Użytkownik klika link do działania polegającego na złożeniu zamówienia i składa zamówienie w tej samej sesji.
Użytkownik klika link do działania związanego z miejscem, a następnie wraca z innego kanału w ciągu 30 dni, aby złożyć zamówienie.
Użytkownik klika link do działania związanego z miejscem, a następnie składa zamówienie w innym sklepie – w tej samej sesji lub w innej sesji w ciągu 30 dni.

Oczekujemy, że zdarzenia konwersji będą wysyłane ze wszystkich platform, na które użytkownik może wejść, korzystając z linku do działania związanego z miejscem. Lista utworów:

Aplikacje internetowe na komputery lub urządzenia mobilne
aplikacje mobilne, używając precyzyjnego linku do aplikacji lub zarejestrowanego zamiaru aplikacji w Twojej domenie,

Jeśli token jest przechowywany na poziomie użytkownika (zobacz zachowanie tokena), musisz podać atrybucję na różnych urządzeniach. Oznacza to, że użytkownik, który kliknie link działania na komputerze, a następnie dokona transakcji na urządzeniu mobilnym (przy użyciu tego samego konta), powinien wywołać zdarzenie konwersji.

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