Tagi Google Floodlight

Ten artykuł jest przeznaczony dla programistó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 przeniesienie tagów sprzedaży i tagów licznika Google Floodlight ze strony internetowej na serwer. Przeniesienie tych tagów na serwer zmniejszy ilość kodu do uruchomienia na stronie i pomoże skrócić czas wczytywania strony.

Zanim zaczniesz

Przed przeniesieniem tagów na serwer upewnij się, że masz:

• Dostęp administracyjny do Menedżera tagów Google i Floodlight
• instalowanie i konfigurowanie Menedżera tagów Google.
• Konfigurowanie kontenera serwera
• Skonfiguruj klienta Google Analytics: GA4.

Krok 1. Skonfiguruj tag łączący konwersje

Twoje 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 w kontenerze serwera masz już skonfigurowany tag tag łączący konwersje, możesz pominąć ten krok.

Aby skonfigurować tag łączący konwersje:

1. W obszarze roboczym kontenera serwera otwórz menu Tagi po lewej stronie.
2. Aby dodać nowy tag, kliknij Nowy.
3. Jako typ tagu wybierz Tag łączący konwersje.
4. Skonfiguruj regułę, która będzie powodować uruchamianie 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 tagi licznika Floodlight i tagi sprzedaży Floodlight w kontenerze serwera.

Licznik Floodlight

Aby skonfigurować tag licznika Floodlight:

1. W obszarze roboczym kontenera serwera wybierz menu Tagi po lewej stronie.
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 tuż pod jego nazwą. Ta wartość występuje też jako wartość src= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu grupy: w tabeli Aktywność znajdź aktywność, nad którą chcesz pracować, 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 aktywność, nad którą chcesz pracować, 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 odpowiednią 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 1 konwersja na użytkownika na sesję. Długość sesji jest ustawiana w witrynie, w której wdrażany jest tag Floodlight.

6. Otwórz okno Wybierz wyzwalacz.

7. W menu Skonfiguruj regułę wybierz regułę. W większości przypadków najlepszą opcją jest Wszystkie strony.

   

8. Wpisz nazwę tagu i kliknij Zapisz.

   

Sprzedaż Floodlight

Aby skonfigurować tag sprzedaży Floodlight:

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

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

   *   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 tuż pod jego nazwą. Ta wartość występuje też jako wartość src= w wygenerowanym kodzie tagu Floodlight.
   • Ciąg tagu grupy: w tabeli Aktywność znajdź aktywność, nad którą chcesz pracować, 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 aktywność, nad którą chcesz pracować, 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 odpowiednią 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 1 konwersja na użytkownika na sesję. Długość sesji jest ustawiana w witrynie, w której wdrażany jest tag Floodlight.

6. Otwórz okno Wybierz wyzwalacz.

7. W menu Skonfiguruj regułę wybierz regułę. W większości przypadków najlepszą opcją jest Wszystkie strony.

8. Wpisz nazwę tagu i kliknij Zapisz.

Opcjonalnie: skonfiguruj konwersje rozszerzone

Jeśli nie korzystasz z konwersji rozszerzonych, przejdź od razu do sekcji Sprawdzanie konfiguracji.

Aby skonfigurować konwersje rozszerzone, wykonaj podane niżej czynności.

Konfigurowanie zmiennej danych przekazywanych przez użytkowników

Konwersje rozszerzone można wdrożyć 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 chcesz zbierać dane wejściowe, wybierz konfigurację ręczną lub za pomocą kodu.	Określ wybrane właściwości CSS lub zmienne JavaScript, aby zbierać dane przekazywane przez użytkowników. 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 jest najlepszym wyborem, jeśli chcesz zmaksymalizować dokładność konwersji rozszerzonych, ponieważ umożliwia Ci wysyłanie spójnych danych po każdym uruchomieniu tagu konwersji.
złożoność	Prosty	Medium	Złożony
Umiejętności	Nie są wymagane żadne specjalne umiejętności	HTML i CSS	Projektowanie stron internetowych

Automatyczne zbieranie danych

1. W kontenerze internetowym otwórz menu Zmienne.
2. Utwórz nową zmienną zdefiniowaną 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ą zdefiniowaną przez użytkownika typu Dane przekazywane przez użytkowników.
3. Jako Typ wybierz Konfiguracja ręczna.

4. W odpowiednim polu danych użytkownika, które chcesz przekazywać za pomocą konwersji rozszerzonych, dodaj nową lub istniejącą 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, wykonaj podane instrukcje. Zmienne te mogą być zaszyfrowane i niezaszyfrowane.

5. Aby określić element z modelu DOM, utwórz jedną z opcji: Nowa zmienna > Konfiguracja zmiennej > Element DOM.

6. W sekcji Metoda wyboru możesz użyć selektora arkusza CSS lub identyfikatora. Wskazówka: jeśli zmienne CSS często się zmieniają, dodaj do witryny identyfikator HTML i użyj zmiennej ID.

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

8. Nazwij i zapisz zmienną Element DOM. Na ekranie zostanie ponownie wyświetlony ekran ustawień 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ć niezaszyfrowane dane, które Google będzie szyfrować, zanim trafią na serwery, albo dane wstępnie zaszyfrowane. Jeśli zdecydujesz się wysyłać dane wstępnie zaszyfrowane, zakoduj je za pomocą algorytmu SHA256 z kodowaniem szesnastkowym. W obu przypadkach wypełnij co najmniej jedno z tych pól: adres e-mail lub numer telefonu.
Aby przekazać niezaszyfrowane dane do warstwy danych:

1. Przechowuj w swojej witrynie dane przekazywane przez użytkowników jako pary 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. Wyślij dane użytkownika za pomocą zdarzenia za pomocą funkcji 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. Wysyłaj dane użytkownika razem ze zdarzeniem za pomocą funkcji dataLayer.push(). Przykład poniżej przedstawia implementację warstwy danych, która zakłada, że samodzielnie napisałeś(-aś) funkcję szyfrowania uruchamianą 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ą zdefiniowaną przez użytkownika typu Dane przekazywane przez użytkowników.
3. Jako Typ wybierz Kod.
4. Aby utworzyć odpowiednie pole danych użytkownika, kliknij kolejno menu i Nowa zmienna.
5. W sekcji Wybierz typ 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 ją zapisz. Na ekranie zostanie ponownie wyświetlony ekran ustawień Dane przekazywane przez użytkowników.
8. Nazwij zmienną Dane przekazywane przez użytkowników, np. My user-defined data.
9. Kliknij Zapisz.

Przypisywanie zmiennej do tagu Google

1. W kontenerze internetowym otwórz menu Tagi.
2. Edytuj 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. Ustaw Wartość na zmienną Dane przekazywane przez użytkowników, np. {{My user-provided data}}.

4. Zapisz zmiany. Twój tag powinien wyglądać tak:

   

Skonfiguruj tag Floodlight po stronie serwera

W kontenerze serwera włącz konwersje rozszerzone w tagu sprzedaży Floodlight lub licznika Floodlight.

1. Zaznacz pole wyboru Uwzględnij dane przekazywane przez użytkowników.
   
2. Kliknij Zapisz, aby zapisać zmiany.

Opcjonalnie: wartość przychodów

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 przychodów, musisz skonfigurować zmienną pobierającą dane z bazy danych i przypisywać ją do tagu sprzedaży Floodlight.

Uwaga: kontener serwera szyfruje wartość przychodów, aby dane o konwersjach nie były ujawniane podczas przesyłania danych z powrotem do przeglądarki przez serwer.

Aby utworzyć nową zmienną:

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

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

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

3. W sekcji Unikalne parametry:

   • 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ć go.

   

4. Zapisz tag.

Opcjonalnie: parametry niestandardowe

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

Menedżer tagów Google

Aby skonfigurować pola niestandardowe we Floodlight, do nazwy parametru dołącz ciąg 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 zasygnalizować, że trafi do Floodlight, dołącz na początku x-dc-. Jeśli na przykład normalnie wysyłasz match_id, zmień go na x-dc-match_id.

   

4. Zapisz tag.

gtag.js

Aby skonfigurować pola niestandardowe we Floodlight, do nazwy parametru zdarzenia dołącz ciąg x-dc-:

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

Krok 3. Zweryfikuj konfigurację

Gdy zaczniesz wysyłać dane z kontenera serwera, możesz sprawdzić, czy działa on prawidłowo. W tym celu wykonaj te czynności:

1. Otwórz swoją witrynę.
2. W kontenerze serwera Menedżera tagów Google kliknij Podgląd. Tag Assistant uruchomi i wczyta kontener serwera.
3. Na karcie Tagi znajdziesz wszystkie uruchomione tagi. Sprawdź, czy skonfigurowany przez Ciebie tag się uruchomił.
4. Na karcie Konsola są wyświetlane wszystkie błędy, które wystąpiły podczas przesyłania danych do kontenera serwera. Sprawdź je i rozwiąż je.

Więcej informacji o debugowaniu kontenerów Menedżera tagów znajdziesz w artykule o podglądzie i debugowaniu.

Dalsze kroki

Gdy tag Floodlight zacznie działać zgodnie z oczekiwaniami, możesz usunąć odpowiadające mu tagi z kontenera internetowego, aby uniknąć duplikowania danych.