Implementacja
Podsumowanie
Implementacja śledzenia konwersji składa się z 3 elementów:
- Pobieram
rwg_token
imerchant_id
ze strony docelowej lub aplikacji i punktu wejścia. - Zachowywanie zasad
rwg_token
imerchant_id
na potrzeby odpowiedniej atrybucji okno. - Porównaj wartości
merchant_id
imerchant_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ć
Wartość zmiany sprzedawcy | Co musisz zrobić |
---|---|
1 | Tej wartości należy użyć, gdy użytkownik opuści weszli na stronę pierwotnego sprzedawcy i dokonali zakupu. za pomocą platformy u innego sprzedawcy |
2 | Tej wartości należy używać, gdy klient sfinalizował transakcję za pośrednictwem oryginalnego Podmiotu (Sprzedawca). |
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.