Tagowanie po stronie serwera w przypadku aplikacji mobilnych

Za pomocą pakietu SDK Google Analytics dla Firebase możesz skonfigurować aplikacje mobilne, aby współpracowały z tagowaniem po stronie serwera w Menedżerze tagów Google.

Tagowanie po stronie serwera umożliwia etapowanie, usuwanie i rozszerzanie danych przed ich wysłaniem do usług docelowych, takich jak Google Analytics. Dowiedz się więcej o tagowaniu po stronie serwera.

Aby skonfigurować tagowanie po stronie serwera w przypadku aplikacji mobilnych:

1. Przygotowanie aplikacji do tagowania po stronie serwera
2. Konfigurowanie kontenera serwera do obsługi ruchu mobilnego
3. Włączanie tagowania po stronie serwera w usłudze w GA4

Wymagania wstępne

• W aplikacji musisz uwzględnić pakiet SDK Google Analytics dla Firebase i połączyć go z usługą w Google Analytics 4. Dowiedz się więcej o pakiecie SDK Google Analytics dla Firebase.
• Potrzebujesz konta Menedżera tagów Google i kontenera serwera. Jeśli go nie masz, utwórz nowe konto i kontener Menedżera tagów.
• Musisz skonfigurować serwer tagowania.

Krok 1. Przygotuj aplikację do tagowania po stronie serwera

iOS

1. Włącz funkcję przesyłania tagów po stronie serwera i skonfiguruj niestandardowy schemat URL-a dla trybu debugowania tagowania po stronie serwera w pliku Info.plist. Zastąp w tym fragmencie ciąg BUNDLE_ID identyfikatorem pakietu aplikacji.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Aby włączyć tryb debugowania lub podglądu, dodaj wywołanie metody Analytics.handleOpen(_:) w metodie cyklu życia, aby przekazać adres URL uruchamiania.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   W przypadku aplikacji, które nie korzystają z SwiftUI ani UIScene, nie musisz nic robić. Pakiet SDK otrzymuje adres URL uruchamiania z ApplicationDidFinishLaunchingNotification.

Android

1. Zainstaluj najnowszą wersję pakietu SDK Google Analytics dla Firebase.

2. Aby włączyć sGTM, dodaj do pliku AndroidManifest.xml aplikacji następujące informacje:

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

Krok 2. Skonfiguruj kontener serwera pod kątem obsługi ruchu mobilnego

W tej sekcji zakładamy, że masz już wdrożone tagowanie po stronie serwera i znasz jego założenia. Jeśli nie masz doświadczenia z tagowaniem po stronie serwera, możesz skorzystać z podstawowego kursu o tagowaniu po stronie serwera.

Konfigurowanie klienta Google Analytics: GA4 (aplikacja)

Klient to typ zasobu Menedżera tagów, który przechwytuje określone typy przychodzących żądań i generuje zdarzenia, które można przekazać do miejsca docelowego, np. do Google Analytics 4. W tym przypadku żądanie HTTP jest zdarzeniem Google Analytics 4, więc musisz skonfigurować wbudowany klient Google Analytics: GA4 (App). Na potrzeby każdego źródła danych, np. pakietu SDK GA i witryny, wystarczy 1 klient GA4. Dowiedz się więcej o tym, jak działają klienci.

1. W kontenerze serwera otwórz Klienci i kliknij Nowy.

2. Kliknij kolejno Konfiguracja klienta i Google Analytics: GA4 (aplikacja).

   

3. Wpisz nazwę klienta i kliknij Zapisz.

Konfigurowanie tagu Google Analytics: GA4

Aby wysyłać dane do Google Analytics, musisz utworzyć tag Google Analytics: GA4 w kontenerze serwera. Klient analizuje przychodzące żądanie HTTP i przekształca je w obiekt danych zdarzenia. Tag pobierze obiekt danych zdarzenia, przemapuje go na odpowiedni format, a potem prześle do Google Analytics 4.

1. W kontenerze serwera otwórz Tagi i kliknij Nowy.

2. Kliknij kolejno Konfiguracja tagu i Google Analytics: GA4.

   

Domyślnie tag odziedziczy wszystkie odpowiednie pola i parametry z obiektu danych zdarzenia utworzonego przez klienta:

• Jeśli przychodzące żądanie Google Analytics 4 przechodzi przez klienta Google Analytics: GA4 (aplikacja), tag dziedziczy identyfikator aplikacji i parametry zdarzenia.
• Jeśli przychodzące żądania Google Analytics 4 przechodzą przez klienta Google Analytics: GA4 (sieć), tag dziedziczy identyfikator pomiaru i parametry zdarzenia.

Wskazówka: możesz opcjonalnie użyć przekształceń, aby uwzględnić, wykluczyć lub zmodyfikować parametry zdarzenia zwracane przez klienta, zanim zostaną one udostępnione tagom. Przekształcenia umożliwiają ochronę informacji poufnych i dają precyzyjną kontrolę nad tym, jakie parametry zdarzeń są dostępne do dalszego przetwarzania.

Konfigurowanie reguł dla ruchu z urządzeń mobilnych

Następnie określ, kiedy ma być wywoływany tag GA4. Klient Google Analytics: GA4 (aplikacja) analizuje przychodzące żądanie i przekształca je w obiekt danych zdarzenia, a tag odziedziczy jego wartości. Dlatego zwykle chcesz, aby tag był uruchamiany za każdym razem, gdy klient GA4 odbierz żądanie.

Aby skonfigurować te reguły:

1. W ustawieniach tagu kliknij Wyzwalanie.
2. Aby utworzyć nowy regułę, w prawym górnym rogu kliknij ikonę +.
3. Kliknij Skonfiguruj regułę, aby wybrać typ reguły.

4. Z listy wybierz Niestandardowy lub Zdarzenie niestandardowe.

   • Typ Reguła niestandardowa uruchamia domyślnie tag, gdy dowolne zdarzenie zostanie wygenerowane przez klienta po stronie serwera.
   • Za pomocą typu reguły Zdarzenie niestandardowe możesz uruchomić tag po wystąpieniu określonej nazwy zdarzenia lub zdarzenia, które pasuje do wzorca wyrażenia regularnego.

5. Aby włączyć listę warunków aktywacji tego aktywatora, np. aby działał tylko na podstawie danych o zdarzeniach mobilnych lub internetowych, wybierz Niektóre zdarzenia.

   1. Zobaczysz, że Nazwa zdarzenia jest wstępnie wybrana. Kliknij selektor i na liście wybierz Wybierz zmienną wbudowaną.
   2. Aby zwracać automatycznie nazwę klienta, który wygenerował zdarzenie, wybierz Nazwa klienta.

   3. Użyj nazwy skonfigurowanego wcześniej klienta, aby odpowiednio ustawić warunek. Swój reguł powinien wyglądać tak:

      

      Uwaga: nazwa klienta to ta, którą podano w poprzednim kroku. Typ klienta to Google Analytics: GA4 (aplikacja). Zmienna nazwa_klienta zwraca nazwę, a nie typ klienta.

6. Zapisz regułę i podaj jej nazwę. Możesz np. użyć opcji „Wszystkie zdarzenia w aplikacji GA4”.

7. Powinieneś/powinnaś być teraz z powrotem w ustawieniach tagu z nowym wyzwalaczem na swoim miejscu. Zapisz tag i wpisz nazwę opisową, np. „GA4”. Twój tag powinien wyglądać tak:

   

Wskazówka: aby pominąć wysyłanie niektórych zdarzeń, możesz użyć niestandardowych reguł z logiką warunkową na podstawie nazwy zdarzenia (lub innej zmiennej) albo dodać wyjątki reguł. Dowiedz się więcej o uruchamianiu reguł i ich wyjątkach.

Podgląd kontenera

Przed opublikowaniem zmian możesz użyć Menedżera tagów Google, aby przetestować i przeprowadzić debugowanie kontenera serwera. Pamiętaj, że podgląd nie będzie działać, dopóki nie włączysz tagowania po stronie serwera w usłudze w GA4.

Aby żądania aplikacji uruchamiały konfigurację podglądu, musisz:

1. W kontenerze serwera Menedżera tagów Google kliknij Podgląd.
2. W prawym górnym rogu kliknij ikonę Więcej działań ⋮ i wybierz Wyślij prośby z aplikacji.

3. Wpisz identyfikator aplikacji i kliknij Generuj kod QR.

   

4. Zeskanuj kod QR za pomocą aplikacji aparatu na telefonie. Zacznij korzystać z aplikacji w taki sam sposób jak przy generowaniu zdarzeń podglądu.

5. Kliknij OK, aby zamknąć okno.

Publikowanie kontenera

Po zweryfikowaniu zmian opublikuj kontener, aby wprowadzić je w życie dla całego ruchu. Dowiedz się więcej o publikowaniu, wersjach i zatwierdzaniu.

Krok 3. Włącz tagowanie po stronie serwera w usłudze w GA4

1. W usłudze w Google Analytics 4 kliknij Administracja.
2. Otwórz Strumienie danych.

3. Na karcie iOS lub Android wybierz konfigurację strumienia aplikacji.

   

4. Kliknij kolejno Skonfiguruj ustawienia pakietu SDK i Skonfiguruj Menedżera tagów po stronie serwera.

   

5. Aby umożliwić pakietowi SDK wysyłanie danych pomiarowych do adresu URL kontenera serwera:

   1. Przełącz opcję Wysyłaj dane do kontenera Menedżera tagów po stronie serwera.
   2. Skopiuj adres URL kontenera serwera. Aby to zrobić, w Menedżerze tagów Google kliknij Administracja > Ustawienia kontenera > URL-e kontenera serwera.

   3. Wybierz odsetek ruchu, który chcesz przekierować do kontenera serwera. Możesz wybrać opcję poniżej 100%, aby zweryfikować konfigurację serwera przed użyciem tagowania po stronie serwera w przypadku całego ruchu.

      Uwaga: użyj opcji Tylko urządzenia do debugowania, aby umożliwić wysyłanie danych na serwer tylko aplikacjom otwartym w trybie podglądu.

   

6. Kliknij Zapisz. SDK pobierze zaktualizowany adres URL kontenera serwera i przekaże mu dane pomiarowe.

Znane ograniczenia

• Aplikacje na Androida:

  • Aby uniknąć potencjalnych luk w zabezpieczeniach związanych z kontenerami serwerów i usługami Google Play, zdarzenia będą przechodzić przez serwer proxy bezstanowy między pakietem SDK a kontenerem serwera. Ten serwer pośredniczący będzie weryfikować źródło i punkt końcowy żądania, ale nie będzie sprawdzać ani przechowywać żadnych danych o tych zdarzeniach. Zgodnie z sposobem, w jaki GA4 gromadzi dane z urządzeń znajdujących się w UE, serwery proxy będą znajdować się w UE w przypadku ruchu z tego regionu.
  • Automatycznie rejestrowane zakupy w aplikacji polegają na integracji z systemem backendowym Google Play i nie są wysyłane do kontenera serwera.
  • Wydarzenie app_remove nie będzie zgłaszane na urządzeniach z Androidem.

• Aby dane SDK i konwersje były importowane do Google Ads, musisz nadal łączyć strumienie danych z aplikacji w Google Analytics z kontem Google Ads. Tagowanie po stronie serwera nie zapewnia żadnej wbudowanej integracji pakietu SDK z Google Ads.

Interfejs API

Dostęp do danych konfiguracji Menedżera tagów możesz uzyskać za pomocą interfejsu Tag Manager REST API. Więcej informacji o interfejsie API:

• Aby dowiedzieć się, jak pracować z interfejsem API, zapoznaj się z przewodnikiem dla deweloperów.
• Zapoznaj się z dokumentacją interfejsu API Menedżera tagów, aby poznać zasoby Menedżera tagów i dostępne operacje.