Śledzenie konwersji

Omówienie

Śledzenie konwersji pozwala śledzić konwersje rozpoczęte przez Google za pomocą jednej z naszych integracji z Action Center. Pomaga to w utrzymywaniu prawidłowego działania integracji, ponieważ może ona wpływać na pozycjonowanie 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 przechowuj 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.

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.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

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.

W tym przykładzie pokazano ś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 (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; 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

Na poziomie urządzenia obejmuje to używanie plików cookie przeglądarki, pamięci lokalnej, pamięci lokalnej aplikacji lub innej metody, która może przechowywać token przez 30-dniowy okres 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.
• Użyj 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 zapisywany 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.

Odświeżanie tokena

Gdy Google przekieruje użytkownika do tego samego sprzedawcy, dotychczasowy token, który jest już przechowywany, zostanie zastąpiony nowym tokenem z najnowszego przekierowania. 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 do działań, 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ę skontaktować z handlowcem, zanim wyślesz prośbę o ukończenie 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 zapisałeś je jako merchant_id lub dopasowałeś do istniejącego merchant_id.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + 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ć zakodowanym obiektem 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`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

Zwracanie wartości zmiany sprzedawcy

Wartość merchant_changed służy do określenia, czy sprzedawca został zmieniony w stosunku do pierwotnego sprzedawcy przekierowania. 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 zidentyfikować zmianę sprzedawcy, ale nie jego szczegóły.

Gdy zdecydujesz, jaką wartość przypisać do elementu merchant_changed, musisz pobrać pierwotnego sprzedawcę zapisanego w parsowaniu i przechowywaniu informacji o sprzedawcu. 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

Testowanie i weryfikowanie śledzenia konwersji

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

Użyj linku do działania lub adresów URL stron 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 usunięcie wszystkich istniejących tokenów powiązanych z bieżącym użytkownikiem i zapewni Ci czyste środowisko do pracy.

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

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 strony z działaniem 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.

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 miejscu 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 w innej sesji w okresie 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 podać 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.