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

Śledzenie konwersji

Implementacja

Podsumowanie

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

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

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

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

Na poziomie urządzenia korzysta się z plików cookie przeglądarki, pamięci lokalnej aplikacji lub innej, która może być trwała dla 30-dniowego okna atrybucji. Ponieważ token są zapisywane lokalnie na urządzeniu użytkownika, jeśli zmieni się on urządzenia, z którego korzysta, czyści pamięć lokalną/pliki cookie; korzysta z przeglądania prywatnego lub trybu incognito, zdarzenie konwersji mogą nie zostać prawidłowo przypisane. Na poziomie urządzenia śledzenia konwersji, musisz zaimplementować je ponownie w każdym (w tym na urządzeniach mobilnych).
Poziom użytkownika obejmuje utrwalanie pliku w aplikacji. do bazy danych, systemu analitycznego po stronie serwera w systemach po stronie serwera. Ponieważ token byłby przechowywany w po stronie serwera, jeśli użytkownik zmieni używane urządzenie, lokalnej pamięci masowej lub plików cookie albo użytkownik korzysta z funkcji przeglądania prywatnego w trybie incognito zdarzenie konwersji zostanie przypisane tylko raz użytkownik zaloguje się ponownie. Jeśli używasz śledzenia konwersji na poziomie użytkownika, w zależności od architektury systemu zaimplementuj ją raz po stronie serwera i użyj ponownie na wszystkich na obsługiwanych platformach.

Zbieranie: `rwg_token`

Za każdym razem, gdy Google wyświetli action_link podany przez Ciebie kanału, URL zostanie zmieniony tak, aby zawierał niepowtarzalne zapytanie rwg_token. rwg_token jest zakodowanym ciągiem znaków, który zawiera metadane dotyczące który kliknął użytkownik. Zapiszesz ten token i przekażesz go z powrotem jako do zdarzenia konwersji.

Na każdej stronie docelowej lub w każdym punkcie wejścia do aplikacji musisz przeanalizować ustawioną wartość dla parametru zapytania rwg_token i zapisać go. Wymagania przechowywania tego parametru opisano w kroku Zachowanie 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 podczas odpowiadania 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>

Zachowuję `rwg_token`

Uwaga: zachowanie rwg_token jest kluczem do prawidłowego i wdrożyć wymagane okno atrybucji. Więcej informacji: wymagania dotyczące atrybucji – zapoznaj się z sekcją Wymagania dotyczące atrybucji konwersji poniżej.

Musisz zachować parametr adresu URL rwg_token, który zostanie dołączony do wszystkich podanych przez Ciebie linków do działań, uzyskując łącznie trwa 30 dni. Wartość rwg_token powinna być zapisane i zwrócone bez żadnych zmian. Jeśli istniejący token został utrwalony podczas poprzedniej wizyty, Należy zastąpić stary token i uzyskać 30-dniowy okres przechowywania należy zresetować.

Jeśli token jest utrwalony, możesz go przechowywać w na poziomie urządzenia lub użytkownika:

Poziom urządzenia obejmuje korzystanie z plików cookie przeglądarki, pamięci lokalnej i pamięci lokalnej aplikacji lub innej metody, która może zachować token dla 30-dniowego okna atrybucji.
Poziom użytkownika obejmuje utrwalanie go w bazie danych aplikacji. za pomocą systemu analitycznego po stronie serwera lub innych systemów po stronie serwera.

Oto przykład śledzenia konwersji na poziomie urządzenia: zapisując ten token w przeglądarce, po raz pierwszy plik cookie tej samej firmy. W tym przykładzie zakładamy, że wartość tokena została przeanalizowana jak w przykładzie powyżej. Aby skorzystać z tego przykładu: musisz zmienić „domenę główną” na swoją domenę.

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

Jeśli używasz śledzenia konwersji na poziomie użytkownika, parametr rwg_token powinien 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ć Google Place Action, musisz wysłać żądanie HTTP POST do punktu końcowego konwersji. Istnieją dwa punkty końcowe, jeden dla środowiska produkcyjnego a drugi w środowisku 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:

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

Zarówno w środowisku piaskownicy, jak i w środowisku produkcyjnym należy wykonać podczas wysyłania zdarzenia konwersji podaj prawidłowy atrybut rwg_token. Do testowania w środowisku piaskownicy możesz użyć tych token testowy.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Uwaga: w wersji produkcyjnej nie należy wysyłać zdarzeń konwersji, które nie są przypisanej do tej integracji. Pamiętaj o sprawdzeniu prawidłowych niewygasła wartość rwg_token przed wysłaniem zdarzenia.

Pełny przykład śledzenia konwersji na poziomie urządzenia (z użyciem pliku cookie urządzenia użytkownika) w JavaScripcie, jak wysłać to żądanie uwzględniono 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
    })
  });
}

Jeśli korzystasz ze śledzenia konwersji na poziomie użytkownika, pobieraj dane z sekcji powiązany z użytkownikiem (niezależnie od platformy, włączone) z mechanizmu przechowywania danych po stronie serwera i wysyłają używając tych samych punktów końcowych w środowisku produkcyjnym lub piaskownicy.

Uwaga: zdarzenia konwersji mogą być wysyłane z klienta internetowego lub aplikacji, lub z serwera. Taką decyzję można podjąć zgodnie z potrzebami i miejscem przechowywania tokena. jest wysyłane dokładnie raz na konwersję i zawiera prawidłowy ciąg Wartość: rwg_token.

Wymagania dotyczące atrybucji konwersji

Wymagany przez Google standard atrybucji konwersji to 30 dni dla dowolnej interakcji z linkiem do miejsca, sklepu.

To okno atrybucji oznacza, że spodziewamy się konwersji. w dowolnym z tych scenariuszy:

Użytkownik klika link do działania związanego z miejscem i składa zamówienie ta sama sesja
Użytkownik klika link do działania związanego z miejscem, a potem wraca inny kanał 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 w innym sklepie w ramach tej samej sesji lub w innym w ramach 30-dniowego okresu.

Oczekujemy, że zdarzenia konwersji będą wysyłane ze wszystkich miejsca, na które użytkownik może wejść 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 zarejestrowanego app-intent w Twojej domenie

Jeśli token jest przechowywany na poziomie użytkownika (zobacz artykuł na temat przechowywania tokena), należy się spodziewać atrybucja na różnych urządzeniach. Oznacza to, że użytkownik, który klika link działania na pulpicie, a następnie wykonuje transakcji na urządzeniu mobilnym (przy użyciu tego samego konta użytkownika), powinna wywołać zdarzenie konwersji.

Jeśli token jest przechowywany wyłącznie na poziomie urządzenia, np. plików cookie przeglądarki, nie należy podawać danych dla różnych urządzeń, o pochodzeniu danych. W takim przypadku każde urządzenie będzie miało oddzielny token. utrzymuje się, jeśli użytkownik kliknął link do działania na tym urządzeniu; przestrzegałyby reguł atrybucji z osobna.