Tagi Google Floodlight

Ten artykuł jest przeznaczony dla deweloperów, którzy chcą przenieść tagi Floodlight z kontenera internetowego Menedżera tagów do kontenera serwera.

Menedżer tagów po stronie serwera umożliwia przenoszenie tagów sprzedaży i licznika Google Floodlight ze strony internetowej na serwer. Przeniesienie tych tagów na serwer zmniejszy ilość kodu, który trzeba uruchomić na stronie, i pomoże skrócić czas wczytywania strony.

Zanim zaczniesz

Zanim przeniesiesz tagi na serwer, upewnij się, że masz:

• dostęp administratora do Menedżera tagów Google i Floodlight,
• skonfigurowany i zainstalowany Menedżer tagów Google,
• skonfigurowany kontener serwera,
• skonfigurowanego klienta Google Analytics: GA4.

Krok 1. Skonfiguruj tag łączący konwersje

Konto Floodlight może wysyłać dane o konwersjach do Menedżera tagów Google tylko wtedy, gdy skonfigurujesz tag łączący konwersje.

Jeśli masz już skonfigurowany tag łączący konwersje w kontenerze serwera, możesz pominąć ten krok.

Aby skonfigurować tag łączący konwersje:

1. W obszarze roboczym kontenera serwera otwórz po lewej stronie menu Tagi.
2. Aby dodać nowy tag, kliknij Nowy.
3. Wybierz typ tagu Tag łączący konwersje.
4. Skonfiguruj regułę, która spowoduje uruchomienie tagu łączącego konwersje po stronie serwera.
   W większości przypadków najlepszym rozwiązaniem jest reguła Wszystkie strony.
5. Nazwij tag i kliknij Zapisz.

Krok 2. Skonfiguruj tagi Floodlight

Menedżer tagów Google obsługuje w kontenerze serwera tagi licznika Floodlight i tagi sprzedaży Floodlight.

Licznik Floodlight

Aby skonfigurować tag licznika Floodlight:

1. W obszarze roboczym kontenera serwera otwórz po lewej stronie menu Tagi.
2. Aby dodać nowy tag, kliknij Nowy.

3. Wybierz typ tagu Licznik Floodlight.

   

4. Aby zebrać wartości wymagane do skonfigurowania tagu, otwórz nowe okno przeglądarki i zaloguj się w usłudze Campaign Manager 360. Kliknij kolejno Reklamodawcy i nazwę reklamodawcy. Wpisz te wartości w nowym tagu licznika Floodlight w Menedżerze tagów:

   • Identyfikator reklamodawcy: identyfikator reklamodawcy znajduje się na stronie z informacjami o reklamodawcy poniżej jego nazwy. Ta wartość występuje również jako wartość src= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu grupy: w tabeli Aktywność wyszukaj odpowiednią aktywność i znajdź ciąg tagu grupy wymieniony w kolumnie po prawej stronie. Ta wartość występuje również jako wartość type= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu aktywności: w tabeli Aktywność wyszukaj odpowiednią aktywność i znajdź ciąg tagu aktywności wymieniony w kolumnie po prawej stronie. Ta wartość występuje również jako wartość cat= w wygenerowanym kodzie tagu Floodlight.

5. Ustaw żądaną metodę zliczania:

   • Standardowa: zliczane są wszystkie konwersje.
   • Unikalna: zliczana jest pierwsza konwersja dla każdego unikalnego użytkownika w ciągu każdej doby (od północy do północy czasu wschodniego w USA).
   • Na sesję: zliczana jest jedna konwersja na użytkownika na sesję. Długość sesji jest ustawiana w witrynie, w której znajduje się tag Floodlight.

6. Otwórz okno Wybierz regułę.

7. W menu Konfiguracja reguły wybierz regułę. W większości przypadków najlepszym rozwiązaniem jest reguła Wszystkie strony.

   

8. Wpisz nazwę tagu i kliknij Zapisz.

   

Sprzedaż Floodlight

Aby skonfigurować tag sprzedaży Floodlight:

1. W obszarze roboczym kontenera serwera otwórz po lewej stronie menu Tagi.
2. Aby dodać nowy tag, kliknij Nowy.

3. Wybierz typ tagu Sprzedaż Floodlight. Uwaga: tag sprzedaży Floodlight automatycznie zbiera te wartości z odpowiedniego pola e-commerce:

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. Aby zebrać wartości wymagane do skonfigurowania tagu, otwórz nowe okno przeglądarki i zaloguj się w usłudze Campaign Manager 360. Kliknij kolejno Reklamodawcy i nazwę reklamodawcy. Wpisz te wartości w nowym tagu licznika Floodlight w Menedżerze tagów:

   • Identyfikator reklamodawcy: identyfikator reklamodawcy znajduje się na stronie z informacjami o reklamodawcy poniżej jego nazwy. Ta wartość występuje również jako wartość src= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu grupy: w tabeli Aktywność wyszukaj odpowiednią aktywność i znajdź ciąg tagu grupy wymieniony w kolumnie po prawej stronie. Ta wartość występuje również jako wartość type= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu aktywności: w tabeli Aktywność wyszukaj odpowiednią aktywność i znajdź ciąg tagu aktywności wymieniony w kolumnie po prawej stronie. Ta wartość występuje również jako wartość cat= w wygenerowanym kodzie tagu Floodlight.

5. Ustaw żądaną metodę zliczania:

   • Standardowa: zliczane są wszystkie konwersje.
   • Unikalna: zliczana jest pierwsza konwersja dla każdego unikalnego użytkownika w ciągu każdej doby (od północy do północy czasu wschodniego w USA).
   • Na sesję: zliczana jest jedna konwersja na użytkownika na sesję. Długość sesji jest ustawiana w witrynie, w której znajduje się tag Floodlight.

6. Otwórz okno Wybierz regułę.

7. W menu Konfiguracja reguły wybierz regułę. W większości przypadków najlepszym rozwiązaniem jest reguła Wszystkie strony.

8. Wpisz nazwę tagu i kliknij Zapisz.

Opcjonalnie: skonfiguruj konwersje z danymi koszyka

Możesz skonfigurować tag sprzedaży Floodlight tak, aby wysyłał konwersje z danymi koszyka. Konwersje z danymi koszyka dostarczają szczegółowych informacji o zdarzeniach konwersji na poziomie SKU. Przesyłając identyfikator sprzedawcy, etykietę pliku danych, język pliku danych i dane produktu, możesz określić, które produkty sprzedają się dobrze, a które mogą wymagać większego wsparcia.

Krok 1 z 2. Prześlij parametry danych koszyka do warstwy danych

1. Utwórz tablicę JSON ecommerce.purchase.products. Na przykład:

       'ecommerce':{
       'purchase':{
           'products': [{
               'id': 'String',
               'price': 'Floating point',
               'quantity': Integer,
               'country': 'String', // Optional
               'accountId': 'String' // Optional
           },
           {
               … // Each SKU (product) in the transaction
               // is in its own array item.
           }]
       }
       }'
   

2. Aby udostępniać dane w warstwie danych Menedżera tagów Google, skorzystaj z dataLayer.push metody.

Krok 2 z 2. Skonfiguruj tag sprzedaży Floodlight

Dane zdarzenia

1. W kontenerze serwera otwórz tag sprzedaży Floodlight.
2. W sekcji „Raporty produktowe” zaznacz pole wyboru Podaj dane sprzedaży na poziomie produktu.
3. W menu „Źródło danych” kliknij Dane zdarzenia. Menedżer tagów Google będzie automatycznie korzystać z danych przesyłanych w warstwie danych w tablicy ecommerce.purchase.products.
4. Kliknij Zapisz.

Konfiguracja niestandardowa

1. W kontenerze serwera otwórz tag sprzedaży Floodlight.
2. W sekcji „Raporty produktowe” zaznacz pole wyboru Podaj dane sprzedaży na poziomie produktu.
3. W menu „Źródło danych” wybierz Konfiguracja niestandardowa.
4. Wybierz zmienną dynamiczną lub ręcznie wpisz wartość w tych polach:
   • Dane produktu: sformatowany ciąg znaków zawierający dane produktu.
   • Identyfikator sprzedawcy: identyfikator sprzedawcy w Google Merchant Center.
   • Etykieta pliku danych: etykieta identyfikująca konkretny plik danych używany w Google Merchant Center.
   • Język pliku danych: język pliku danych podany za pomocą dwuliterowego kodu ISO 639-1.
5. Kliknij Zapisz.

Uwaga: aby w pełni korzystać z tej funkcji, musisz spełniać wymagania dotyczące konwersji z danymi koszyka.

Opcjonalnie: skonfiguruj konwersje rozszerzone

Jeśli nie używasz konwersji rozszerzonych, przejdź do sekcji Sprawdzanie konfiguracji.

Aby skonfigurować konwersje rozszerzone, wykonaj te czynności.

Skonfiguruj zmienną danych przekazywanych przez użytkowników

Konwersje rozszerzone można implementować w Menedżerze tagów na 3 sposoby. Musisz wybrać tylko 1 opcję zbierania danych przekazywanych przez użytkowników.

	Automatyczne zbieranie danych	Konfiguracja ręczna	Konfiguracja kodu
Metoda zbierania danych	Automatycznie zbiera dane przekazywane przez użytkowników na podstawie kodu Twojej witryny. Jeśli chcesz mieć kontrolę nad tym, gdzie zbierać dane wejściowe, wybierz konfigurację ręczną lub konfigurację kodu.	Aby zbierać dane przekazywane przez użytkowników, określ wybrane właściwości arkusza CSS lub zmienne JavaScriptu. Jeśli chcesz mieć kontrolę nad formatowaniem i szyfrowaniem danych, wybierz konfigurację kodu.	Umieść w witrynie fragment kodu, który przesyła zaszyfrowane dane klientów niezbędne do dopasowywania. Ta metoda to najlepszy sposób na zmaksymalizowanie dokładności konwersji rozszerzonych, ponieważ pozwala przesyłać spójne dane po każdym uruchomieniu tagu konwersji.
Złożoność	Prosty	Średnia	Złożona
Umiejętności	Nie są wymagane żadne specjalne umiejętności	HTML i CSS	Programowanie stron internetowych

Automatyczne zbieranie danych

1. W kontenerze internetowym otwórz menu Zmienne.
2. Utwórz nową zmienną definiowaną przez użytkownika typu Dane przekazywane przez użytkowników.
3. Jako Typ wybierz Automatyczne zbieranie danych.
4. Nazwij zmienną, np. My user-defined data.
5. Kliknij Zapisz.

Konfiguracja ręczna

1. W kontenerze internetowym otwórz menu Zmienne.
2. Utwórz nową zmienną definiowaną przez użytkownika typu Dane przekazywane przez użytkowników.
3. Jako Typ wybierz Konfiguracja ręczna.

4. Aby utworzyć odpowiednie pole danych użytkownika, które chcesz przekazywać za pomocą konwersji rozszerzonych, dodaj nową lub dotychczasową zmienną.

   Uwaga: jeśli w warstwie danych masz już zmienne (niezależnie od tego, czy używasz selektorów arkusza CSS czy innych typów zmiennych), możesz je wybrać, zamiast tworzyć nowe. Jeśli nie masz pewności, postępuj zgodnie z instrukcjami. Zmienne mogą być zaszyfrowane lub niezaszyfrowane.

5. Aby określić element z modelu DOM, kliknij kolejno Nowa zmienna > Konfiguracja zmiennej > Element DOM.

6. W sekcji Metoda wyboru możesz kliknąć Selektor arkusza CSS lub Identyfikator. Wskazówka: jeśli zmienne arkusza CSS często ulegają zmianie, dodaj do witryny identyfikator HTML i użyj zmiennej Identyfikator.

7. Wpisz nazwę selektora arkusza CSS lub identyfikatora. Pole Nazwa atrybutu możesz pozostawić puste.

8. Nazwij zmienną Element DOM i kliknij Zapisz. Na ekranie ponownie pojawią się ustawienia zmiennej Dane przekazywane przez użytkowników.

9. Nazwij zmienną Dane przekazywane przez użytkowników , np. My user-defined data.

10. Kliknij Zapisz.

Konfiguracja kodu

Krok 1. Odszukaj i zdefiniuj zmienne konwersji rozszerzonych

Możesz wysyłać dane niezaszyfrowane, które Google zaszyfruje, zanim dotrą one na serwery, lub dane zaszyfrowane wstępnie. Jeśli chcesz wysyłać wstępnie zaszyfrowane dane, zakoduj je za pomocą algorytmu SHA256 z kodowaniem szesnastkowym. W obu przypadkach podaj co najmniej 1 z tych pól: e-mail lub numer telefonu.
Aby przekazywać do warstwy danych niezaszyfrowane dane:

1. Dane przekazywane przez użytkowników przechowuj w swojej witrynie w postaci par klucz-wartość w zmiennej JavaScriptu. Na przykład:

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. Przesyłaj dane użytkownika razem ze zdarzeniem za pomocą obiektu dataLayer.push(). Na przykład:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

Zmienna leadsUserData jest teraz dostępna w Menedżerze tagów Google.

Aby przekazać do warstwy danych zaszyfrowane wstępnie dane:

1. W witrynie haszuj dane przekazywane przez użytkowników za pomocą szesnastkowego kodu SHA256. Klucz kodowanych danych musi zaczynać się od sha256_. Na przykład:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. Przesyłaj dane użytkownika razem ze zdarzeniem za pomocą obiektu dataLayer.push(). W poniższym przykładzie pokazano implementację warstwy danych przy założeniu, że samodzielnie tworzysz funkcję haszowania, która jest uruchamiana asynchronicznie.

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

Zmienna leadsUserData jest teraz dostępna w Menedżerze tagów Google.

Krok 2. Utwórz zmienną danych przekazywanych przez użytkowników

1. W kontenerze internetowym otwórz menu Zmienne.
2. Utwórz nową zmienną definiowaną przez użytkownika typu Dane przekazywane przez użytkowników.
3. Jako Typ wybierz Kod.
4. Aby utworzyć odpowiednie pole danych użytkownika, które chcesz przekazywać, kliknij kolejno menu i Nowa zmienna.
5. W sekcji Wybór typu zmiennej kliknij Zmienna warstwy danych.
6. W zmiennej warstwy danych odwołaj się do przechowywanych danych użytkownika. Na przykład leadsUserData.
7. Nazwij zmienną warstwy danych i kliknij Zapisz. Na ekranie ponownie pojawią się ustawienia zmiennej Dane przekazywane przez użytkowników.
8. Nazwij zmienną Dane przekazywane przez użytkowników , np. My user-defined data.
9. Kliknij Zapisz.

Przypisz zmienną do tagu Google

1. W kontenerze internetowym otwórz menu Tagi.
2. Zmień tag Google , którego używasz do wysyłania danych na serwer tagowania.
3. W sekcji Ustawienia konfiguracji dodaj nowy parametr konfiguracji o nazwie user_data. Jako Wartość wybierz zmienną Dane przekazywane przez użytkowników , np. {{My user-provided data}}.

4. Zapisz zmiany. Tag powinien wyglądać tak:

   

Skonfiguruj tag Floodlight po stronie serwera

W kontenerze serwera włącz konwersje rozszerzone, konfigurując tag sprzedaży Floodlight lub tag licznika Floodlight.

Uwaga: po uruchomieniu tagi Floodlight wysyłają do Google wszystkie dostępne dane o konwersjach (w tym dane przekazywane przez użytkowników). Jeśli chcesz zmodyfikować lub wykluczyć parametry zdarzenia przed uruchomieniem tagu, skonfiguruj i użyj odpowiednich transformacji oraz dołącz je do tagu.

Dane przekazywane przez użytkowników, przesyłane w formie zaszyfrowanej z Twojej witryny, pozwalają zwiększyć dokładność pomiarów. Aby to wdrożyć, musisz najpierw zaakceptować na swoim koncie Search Ads 360 warunki i zasady dotyczące danych przekazywanych przez użytkowników.

Jeśli chcesz uwzględnić dane przekazywane przez użytkowników na potrzeby konwersji rozszerzonych w kampaniach internetowych, informacje umożliwiające identyfikację (PII) powinny być wysyłane z witryny (kontenera po stronie klienta), a następnie przekazywane przez kontener po stronie serwera. Jeśli nie chcesz, aby określony tag wysyłał informacje umożliwiające identyfikację, użyj transformacji, aby usunąć te informacje z wybranych tagów.

Opcjonalnie: wartość przychodu

Tag sprzedaży Floodlight używa parametru value zdarzenia jako domyślnej kwoty do obliczania przychodów. Aby określić inną podstawę do obliczania wartości przychodu, musisz skonfigurować zmienną, która będzie pobierać dane z bazy danych, i przypisać ją do tagu sprzedaży Floodlight.

Uwaga:kontener serwera szyfruje wartość przychodu, aby dane o konwersjach nie były widoczne, gdy serwer przesyła dane z powrotem do przeglądarki.

Aby utworzyć nową zmienną:

1. W kontenerze serwera otwórz menu Zmienne.
2. Utwórz nową zmienną definiowaną przez użytkownika na potrzeby danych wejściowych. Jeśli np. chcesz użyć wartości z bazy danych Firestore, utwórz zmienną {{Wyszukiwanie w Firestore}}.
3. Określ źródła danych dla zmiennej.
4. Nazwij zmienną, np. „Wyszukiwanie zysku”, i kliknij Zapisz.

Aby użyć zmiennej w tagu sprzedaży Floodlight:

1. W kontenerze serwera otwórz menu Tagi.
2. Zmień tag sprzedaży Floodlight.

3. W sekcji Parametry unikalne:

   • Jako Źródło danych wybierz Konfiguracja niestandardowa.
   • W polu Przychody wybierz utworzoną wcześniej zmienną.
   • W polu Identyfikator zamówienia wpisz identyfikator lub użyj zmiennej, aby dynamicznie wypełniać identyfikator zamówienia.

   

4. Zapisz tag.

Opcjonalnie: parametry niestandardowe

Możesz przekazywać niestandardowe pola ze strony internetowej do Google Marketing Platform, np. match_id.

Menedżer tagów Google

Aby skonfigurować pola niestandardowe dla Floodlight, dodaj przed nazwą parametru prefiks x-dc-:

1. W kontenerze internetowym otwórz menu Tagi.
2. Zmień tag zdarzenia GA4 lub utwórz nowy.

3. W sekcji Parametry zdarzenia dodaj nazwę parametru. Aby wskazać, że parametr ma trafić do Floodlight, dodaj przed nim prefiks x-dc-. Jeśli np. zwykle wysyłasz parametr match_id, zmień go na x-dc-match_id.

   

4. Zapisz tag.

gtag.js

Aby skonfigurować pola niestandardowe dla Floodlight, dodaj przed nazwą parametru zdarzenia prefiks x-dc-:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

Krok 3. Sprawdź konfigurację

Gdy zaczniesz wysyłać dane za pomocą kontenera serwera, możesz sprawdzić, czy działa on prawidłowo, wykonując te czynności:

1. Otwórz swoją witrynę.
2. W kontenerze serwera Menedżera tagów Google kliknij Podgląd. Uruchomi się Tag Assistant i wczyta kontener serwera.
3. Na karcie Tagi znajdziesz wszystkie tagi, które zostały uruchomione. Sprawdź, czy skonfigurowany tag został uruchomiony.
4. Na karcie Konsola znajdziesz wszystkie błędy, które wystąpiły podczas przesyłania danych do kontenera serwera. Sprawdź, czy nie ma błędów, i je usuń.

Więcej informacji o debugowaniu kontenerów Menedżera tagów znajdziesz w artykule Podgląd i debugowanie.

Dalsze kroki

Gdy tag Floodlight będzie działać zgodnie z oczekiwaniami, możesz usunąć wszystkie równoważne tagi Floodlight w kontenerze internetowym, aby uniknąć duplikowania danych.