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
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==
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.
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.