Śledzenie konwersji

Rysunek 1. Omówienie śledzenia konwersji

Omówienie

Śledzenie konwersji pozwala śledzić konwersje rozpoczęte przez Google za pomocą jednej z naszych integracji z Action Center. Musisz zadbać o to, aby integracja działała prawidłowo, ponieważ może to wpływać na pozycję w rankingu na niektórych stronach. Za każdym razem, gdy Google wygeneruje action_link, konkretny adres URL zostanie zmodyfikowany, aby zawierał unikalny parametr zapytania: rwg_token. Możesz przechowywać token i zwracać odpowiednie wartości, gdy użytkownik dokona rezerwacji.

Aby przeprowadzić integrację:

1. Przeanalizuj i zapisz rwg_token.
2. Przeanalizuj i zapisz informacje o sprzedawcy.
3. Zwraca wartości rwg_token i merchant_changed.
4. Przetestuj i sprawdź śledzenie konwersji.

Przeanalizuj i zapisz dane rwg_token

Aby dokończyć integrację, musisz zbierać i przechowywać rwg_token przez maksymalnie 30 dni od momentu początkowego polecenia przez Google. Wartość rwg_token to zakodowany ciąg znaków zawierający metadane dotyczące linku i informacje o sprzedawcy, który wygenerował ten action_link.

Ważne: token nie przechowuje ani nie szyfruje danych użytkownika.

Przetwarzanie tokena

Gdy użytkownik zostanie przekierowany na Twoją stronę rezerwacji, do podanego adresu URL zostanie dołączony nowy parametr rwg_token. Na stronie rezerwacji musisz przeanalizować wartość tokena.

Ten przykład pokazuje, jak element rwg_token jest analizowany na potrzeby śledzenia na poziomie urządzenia za pomocą przeglądarki.

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

Token dołączony do adresu URL jest zaszyfrowany (patrz przykład poniżej).rwg_token Użyj tego przykładowego tokena, aby mieć pewność, że poprawnie go zanalizujesz, wraz ze znakami specjalnymi, takimi jak =.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Przechowywanie tokena

Podczas przechowywania wartości rwg_token możesz stosować śledzenie konwersji na 2 poziomach:

• Na poziomie urządzenia
• Na poziomie użytkownika

Token możesz przechowywać na dowolnym poziomie, ale musisz go przechowywać przez 30 dni po pierwszym odesłaniu.

Poniższy przykład pokazuje śledzenie konwersji na poziomie urządzenia. Wartości tokenów możesz przechowywać w przeglądarce w ramach własnego pliku cookie. W tym przykładzie zakładamy, że wartość tokenu została przeanalizowana w zmiennej. Pamiętaj, aby zaktualizować adres rootdomain.com, podając swoją domenę.

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

Za każdym razem, gdy Google generuje action_link, który został przez Ciebie podany w plikach danych, adres URL jest modyfikowany, aby zawierał unikalny parametr zapytania: rwg_token. Musisz przechowywać ten token i przekazywać go jako część zdarzenia konwersji.

Przechowywanie na poziomie urządzenia

Poziom urządzenia obejmuje używanie plików cookie przeglądarki, pamięci lokalnej, pamięci lokalnej aplikacji lub dowolnej innej metody, która może przechowywać token przez 30 dni w okresie atrybucji. Token jest przechowywany lokalnie na urządzeniu użytkownika. Zdarzenie konwersji nie może prawidłowo przypisać konwersji, jeśli użytkownik:

• Zmień urządzenie, którego używają.
• Czyści pamięć lokalną lub pliki cookie.
• Korzysta z przeglądarki w trybie prywatnym lub incognito.

Jeśli używasz śledzenia konwersji na poziomie urządzenia, musisz ponownie zaimplementować zdarzenie konwersji na każdym obsługiwanym urządzeniu, w tym na urządzeniach mobilnych.

Przechowywanie na poziomie użytkownika

Na poziomie użytkownika token jest przechowywany w bazie danych aplikacji za pomocą systemu analitycznego po stronie serwera lub innych systemów po stronie serwera. Token jest przechowywany po stronie serwera. Zdarzenie konwersji nadal jest prawidłowo przypisywane po ponownym zalogowaniu się użytkownika.

Gdy używasz śledzenia konwersji na poziomie użytkownika na podstawie architektury systemu, możesz zaimplementować zdarzenie konwersji raz po stronie serwera i wykorzystać je ponownie na wszystkich obsługiwanych urządzeniach.

Uwaga: miejsce przechowywania danych rwg_token możesz wybrać w sposób dostosowany do swoich potrzeb.

Odświeżanie tokena

Gdy Google poleci użytkownikowi tego samego sprzedawcę, dotychczasowy token, który jest już przechowywany, zostanie zastąpiony nowym tokenem z najnowszego polecenia. Po wymianie tokena okno atrybucji o długości 30 dni przechowywania tokena zostanie zresetowane, a wszystkie nowe konwersje tego sprzedawcy zostaną przypisane do najnowszego tokena.

Więcej informacji znajdziesz w artykule Wymagania dotyczące atrybucji konwersji.

Przetwarzanie i przechowywanie informacji o sprzedawcy

Gdy użytkownik zostanie przekierowany na stronę rezerwacji, musisz zaimplementować logikę, która może znaleźć i przechwycić dane sprzedawcy. Partnerzy zwykle dodają metadane sprzedawcy lub merchant_id do linków akcji, aby identyfikować i przechowywać informacje o sprzedawcy.

Zalecamy przechowywanie wartości merchant_id lub wybranego identyfikatora wraz z wartością rwg_token. Gdy użytkownik potwierdzi rezerwację, możesz się z nim skontaktować, zanim wyślesz prośbę o przeprowadzenie konwersji. Podobnie jak w przypadku przechowywania tokenów, musisz zapisać dane sprzedawcy wraz z tokenem na 30 dni od daty początkowego polecenia.

W tym przykładzie modyfikujemy wcześniej zapisaną wartość rwg_token. Zakładamy, że zanalizowałeś informacje o sprzedawcy z metadanych w podanym adresie URL i zapisujesz je jako merchant_id lub dopasowujesz do istniejącego merchant_id.

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

Zwracanie wartości rwg_token i merchant_changed

Gdy użytkownik dokona rezerwacji, która rozpoczęła się od action_link, musisz wysłać żądanie HTTP POST do punktu końcowego konwersji. Dostępne są 2 typy punktów końcowych:

• Wersja produkcyjna: https://www.google.com/maps/conversion/collect
• Środowisko piaskownicy: https://www.google.com/maps/conversion/debug/collect

Podczas wysyłania zdarzenia konwersji musisz uwzględnić zapisane rwg_token oraz wartość merchant_changed 1 lub 2. Więcej informacji o merchant_changed znajdziesz w artykule Zwracanie wartości zmiany Merchant.

Treść żądania POST musi być obiektem zakodowanym w formacie JSON w formacie:

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

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

Ten przykład obejmuje śledzenie konwersji na poziomie urządzenia za pomocą pliku cookie na urządzeniu użytkownika, zaimplementowanego w języku JavaScript:

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

Uwaga: jedyną akceptowaną wartością argumentu MIME Content-Type jest text/plain. Nie ustawiaj w nagłówku żadnych innych wartości Content-Type, ponieważ może to spowodować błąd CORS.

Ostrzeżenie: w ramach danych o konwersji nie wysyłaj do Google informacji umożliwiających identyfikację użytkownika.

Uwaga: w wersji produkcyjnej nie możesz wysyłać zdarzeń konwersji, które nie są przypisane do tej integracji. Przed wysłaniem zdarzenia sprawdź, czy wartość parametru rwg_token jest prawidłowa i nie wygasła.

Zwracanie wartości zmiany sprzedawcy

Wartość merchant_changed służy do określenia, czy sprzedawca został zmieniony w stosunku do sprzedawcy początkowego. Zmiana sprzedawców jest częsta, jeśli strona docelowa znajduje się na platformie, która obejmuje innych sprzedawców. W takim przypadku, jeśli użytkownik zostanie przekierowany przez Google na Twoją platformę i zdecyduje się na przejście do innego sprzedawcy, aby dokonać rezerwacji, musisz wiedzieć, że konwersja nastąpiła u innego sprzedawcy. Operator logiczny pozwala określić zmianę sprzedawcy, ale nie jego szczegóły.

Gdy zdecydujesz, jaką wartość przypisać do merchant_changed, musisz wziąć pierwotnego sprzedawcę zapisanego w parsowaniu i przechowywaniu informacji o sprzedawcy. Sprawdź, czy sprzedawca się zmienił, i przypisz wartość zgodnie z wymaganiami.

• Wymaganie: gdy użytkownik opuszcza witrynę pierwotnego sprzedawcy i dokonuje zakupu na Twojej platformie u innego sprzedawcy.
  • Wartość zmiany dla sprzedawcy: 1
• Wymaganie: gdy użytkownik dokona transakcji za pomocą pierwotnego sprzedawcy.
  • Wartość zmiany dla sprzedawcy: 2

Uwaga: jeśli strona rezerwacji nie znajduje się na platformie lub użytkownicy nie mogą przejść do innego sprzedawcy, możesz zakodować na stałe wartość tych żądań na 2. Jest to typowe dla partnerów, którzy integrują strony rezerwacji z witryną sprzedawcy lub mają niestandardowe strony docelowe do przetwarzania rezerwacji.

Testowanie i weryfikowanie śledzenia konwersji

Podane niżej przypadki testowe korzystają z tokenów testowych podanych w sekcji Tokeny testowe i mają na celu zaznajomić Cię ze wszystkimi różnymi scenariuszami, które mogą prowadzić do zdarzenia konwersji. Dzięki temu masz pewność, że token jest odpowiednio przechowywany, wartość merchant_changed jest prawidłowo ustawiona, a w odpowiednich przypadkach jest wysyłane zdarzenie konwersji.

Użyj adresów URL strony docelowej lub strony rezerwacji podanych w plikach danych i uruchom każdy test, dodając do adresu URL tokeny testowe. Upewnij się, że używasz prywatnego okna przeglądarki lub okna w trybie incognito. Spowoduje to wyczyszczenie wszystkich tokenów powiązanych z bieżącym użytkownikiem i zapewni Ci czyste środowisko do pracy.

Przykład testu	Test Description	Proces użytkownika	Oczekiwany wynik
1	Użytkownik kończy rezerwację, która nie pochodzi z Google.	Użytkownik przechodzi bezpośrednio na stronę rezerwacji bez odesłania przez Google lub bez wcześniejszego odesłania. Nie powinno to powodować żadnych zdarzeń konwersji.	Brak zdarzenia konwersji, ponieważ użytkownik nie odwiedził wcześniej strony rezerwacji ani nie został do niej skierowany przez Google.
2	Użytkownik kończy rezerwację, która została utworzona w Google.	Użytkownik znajduje Twojego sprzedawcę w Google, zostaje przekierowany na stronę rezerwacji i dokonuje rezerwacji.	Zdarzenie konwersji zostanie wysłane z tokenem A i wartością merchant changed  2, ponieważ użytkownik został przekierowany na stronę rezerwacji przez Google.
3	Użytkownik (pochodzący z Google) rozpoczyna proces rezerwacji, ale porzuca sesję przed jej zakończeniem. Uwaga: ta sesja powinna być otwarta podczas testów 4 i 5.	Użytkownik jest przekierowywany na Twoją stronę rezerwacji, ale sesja kończy się, zanim zdąży dokonać rezerwacji.	Brak konwersji, ponieważ użytkownik nie dokończył rezerwacji, ale token B powinien być przechowywany przez 30 dni.
4	Użytkownik wraca na stronę rezerwacji, nie korzystając z Google, i kończy rezerwację. Uwaga: adres URL procesu rezerwacji nie może zawierać parametru rwg_token.	Użytkownik wraca na stronę rezerwacji po Test 4. Token B powinien być przechowywany przez 30 dni, a każda konwersja w tym okresie powinna zwracać zdarzenie konwersji.	Zdarzenie konwersji zostanie wysłane z tokenem B i wartością 2 w polu merchant changed, ponieważ użytkownik wraca na stronę rezerwacji po wcześniejszym odesłaniu z Google.
5	Użytkownik po teście 4 dokonuje nowej rezerwacji za pomocą Google.	Jeśli użytkownik wróci na Twoją stronę rezerwacji, korzystając z polecenia Google, jego 30-dniowe okno przechowywania zostanie zresetowane, a nowy token Token C zastąpi stary Token B. W przyszłości wszystkie konwersje będą przypisywane do Tokenu C.	Zdarzenie konwersji zostanie wysłane z tokenem C i wartością 2 w parametrze merchant changed, ponieważ użytkownik dokonał rezerwacji, a nowy token zastąpił wcześniej zapisany token.

Jeśli masz platformę, która umożliwia użytkownikom dokonanie płatności u innego sprzedawcy, przetestuj te opcje.

Ważne: jak wspomniano w sekcji Zwracanie wartości zmiany dostawcy, jeśli strony rezerwacji lub linki do działań nie umożliwiają użytkownikowi zmiany dostawcy, możesz zakodować na stałe wartość tych żądań na 2. Jest to typowe dla partnerów, którzy integrują strony rezerwacji w witrynie sprzedawcy lub mają niestandardowe strony docelowe do przetwarzania rezerwacji. Jeśli jesteś jednym z tych partnerów, możesz pominąć te przypadki testowe.

Przykład testu	Test Description	Proces użytkownika	Oczekiwany wynik
6	Użytkownik jest przekierowywany przez Google na Twoją stronę rezerwacji i dokonuje rezerwacji u innego sprzedawcy.	Użytkownik jest kierowany przez Google na Twoją stronę rezerwacji, używa tokena A, ale przed dokonaniem rezerwacji przechodzi na inną stronę i zamawia u innego sprzedawcy niż ten, który był pierwotnie wskazany.	Zdarzenie konwersji zostanie wysłane, ponieważ użytkownik dokonał rezerwacji, która została zainicjowana przez polecenie Google z tokenem A i wartością merchant changed równą 1, ponieważ użytkownik dokonał rezerwacji u innego sprzedawcy niż ten, który polecił mu produkt.

Podczas testowania wyślij żądanie HTTP POST do punktu końcowego konwersji. Istnieją 2 punkty końcowe:

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

Tokeny testowe

Aby przetestować śledzenie konwersji, dodaj jeden z tych tokenów testowych na końcu linków do działań lub adresów URL stron rezerwacji podanych w plikach danych.

Token A:

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

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Po wysłaniu zdarzeń konwersji możesz zobaczyć ich zbiorcze podsumowanie w Centrum działań w panelu śledzenia konwersji.

Uwaga: wyświetlenie konwersji w panelu może potrwać do godziny.

Wymagania dotyczące atrybucji konwersji

Wymagany przez Google standard atrybucji konwersji to 30-dniowe okno atrybucji w przypadku każdej interakcji z linkiem do działania w dowolnym sklepie.

Okno atrybucji oznacza, że Google może oczekiwać, że zdarzenie konwersji zostanie wysłane w jednym z tych scenariuszy:

• Użytkownik klika link do działania związanego z miejscem docelowym i w tej samej sesji składa zamówienie u tego samego sprzedawcy. Wartość zmiany sprzedawcy = 2.
• Użytkownik klika link do działania w miejscu docelowym, a potem wraca z innego kanału w ciągu 30-dniowego okna atrybucji, aby złożyć zamówienie u tego samego sprzedawcy. Wartość zmiany sprzedawcy = 2.
• Użytkownik klika link do działania związanego z miejscem, a potem składa zamówienie w innym sklepie w ramach tej samej sesji lub innej sesji w oknie atrybucji wynoszącym 30 dni. Wartość zmiany sprzedawcy = 1.

Google spodziewa się też, że zdarzenia konwersji będą wysyłane z dowolnego urządzenia, do którego użytkownik ma dostęp za pomocą linku do działania w miejscu. Te urządzenia to:

• aplikacje internetowe na komputery lub urządzenia mobilne;
• aplikacje mobilne – za pomocą precyzyjnego linku aplikacji lub zarejestrowanego zamiaru aplikacji w przypadku Twojej domeny;

Jeśli token jest przechowywany na poziomie użytkownika, należy zapewnić atrybucję na różnych urządzeniach. Więcej informacji znajdziesz w artykule Przechowywanie na poziomie użytkownika. W takim przypadku użytkownik, który kliknie link do działania na komputerze, a potem dokończy transakcję na urządzeniu mobilnym przy użyciu tego samego konta użytkownika, musi wywołać zdarzenie konwersji.

Jeśli token jest przechowywany wyłącznie na poziomie urządzenia, np. w plikach cookie przeglądarki, nie musisz zapewniać atrybucji na wielu urządzeniach. W takim przypadku każde urządzenie może mieć osobny token, jeśli użytkownik kliknie na nim link do działania, a każde urządzenie może stosować reguły atrybucji osobno.

Uwaga: ta platforma atrybucji może się różnić od systemu analityki, który przypisuje konwersje. System ten działa niezależnie od dowolnego śledzenia konwersji w Twoich systemach i nie musi wpływać na Twoje wewnętrzne statystyki.