Tagowanie po stronie serwera w przypadku aplikacji mobilnych

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

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

Aby skonfigurować tagowanie po stronie serwera w aplikacjach mobilnych:

1. Przygotuj aplikację do tagowania po stronie serwera
2. Skonfiguruj kontener serwera, aby obsługiwał ruch z urządzeń mobilnych
3. Włącz tagowanie po stronie serwera w usłudze w GA4

Wymagania wstępne

• Musisz uwzględnić w aplikacji pakiet SDK Google Analytics dla Firebase i połączyć go z usługą w Google Analytics 4. Więcej informacji o pak0}iecie SDK Google Analytics dla Firebase.
• Musisz mieć konto Menedżera tagów Google i kontener serwera. Jeśli ich 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 tagowania po stronie serwera i skonfiguruj niestandardowy schemat URL na potrzeby trybu debugowania tagowania po stronie serwera w pliku Info.plist. Zastąp ciąg BUNDLE_ID w poniższym kodzie 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 funkcji Analytics.handleOpen(_:) w metodzie cyklu życia, aby przekazać adres URL uruchomienia.

   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 używają SwiftUI ani UIScene, nie trzeba podejmować żadnych działań. Pakiet SDK otrzymuje adres URL uruchomienia z powiadomienia ApplicationDidFinishLaunchingNotification.

Android

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

2. Włącz sGTM, dodając ten kod do pliku AndroidManifest.xml aplikacji.

   <!-- 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" />
   

   Uwaga: <APP_PACKAGE_ID> powinno zawierać tylko małe litery. Dopasowywanie schematów w frameworku Androida uwzględnia wielkość liter, w przeciwieństwie do RFC.

Krok 2. Skonfiguruj kontener serwera, aby obsługiwał ruch mobilny

W tej sekcji przyjęto założenie, że masz już wdrożone tagowanie po stronie serwera i znasz jego koncepcje. Jeśli dopiero zaczynasz korzystać z tagowania po stronie serwera, możesz zapoznać się z kursem Podstawy tagowania po stronie serwera.

Konfigurowanie klienta Google Analytics: GA4 (aplikacja)

Klient to typ zasobu Menedżera tagów, który przechwytuje określone typy żądań przychodzących i generuje zdarzenia, które można przekazywać do miejsca docelowego, np. do Google Analytics 4. W tym przypadku żądanie HTTP jest zdarzeniem Google Analytics 4, dlatego musisz skonfigurować wbudowanego klienta Google Analytics: GA4 (aplikacja). Na każde źródło danych, takie jak pakiet SDK Google Analytics i witryna, potrzebujesz tylko 1 klienta GA4. Więcej informacji o tym, jak działają klienci.

1. W kontenerze serwera kliknij kolejno Klienci i Nowy.

2. Kliknij Konfiguracja klienta, a potem wybierz 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ć w kontenerze serwera tag Google Analytics: GA4. Klient analizuje przychodzące żądanie HTTP i przekształca je w obiekt danych zdarzenia. Tag pobierze ten obiekt danych zdarzenia, przekształci go do odpowiedniego formatu, a następnie wyśle do Google Analytics 4.

1. W kontenerze serwera kliknij kolejno Tagi i Nowy.

2. Kliknij Konfiguracja tagu, a potem wybierz Google Analytics: GA4.

   

Domyślnie tag dziedziczy 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 żądanie Google Analytics 4 przechodzi przez klienta Google Analytics: GA4 (internet), tag dziedziczy identyfikator pomiaru i parametry zdarzenia.

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

Konfigurowanie reguł dla ruchu mobilnego

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

Aby skonfigurować reguły:

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

4. Na liście kliknij Niestandardowa lub Zdarzenie niestandardowe.

   • Typ Reguła niestandardowa domyślnie wywołuje tag, gdy klient po stronie serwera wygeneruje dowolne zdarzenie.
   • Typ reguły Zdarzenie niestandardowe umożliwia wywoływanie tagu na podstawie konkretnej nazwy zdarzenia lub zdarzenia pasującego do wzorca wyrażenia regularnego.

5. Aby włączyć listę warunków aktywacji tej reguły, np. aby wywoływać ją tylko w przypadku danych o zdarzeniach mobilnych lub internetowych, kliknij Niektóre zdarzenia.

   1. Zobaczysz, że opcja Nazwa zdarzenia jest wstępnie wybrana. Kliknij ten selektor i na liście wybierz Wbudowana zmienna.
   2. Aby automatycznie zwracać nazwę klienta, który wygenerował zdarzenie, kliknij Nazwa klienta.

   3. Użyj nazwy klienta skonfigurowanego wcześniej, aby odpowiednio ustawić warunek. Twoja reguła powinna wyglądać tak:

      

      Uwaga: nazwa klienta to nazwa podana w poprzednim kroku. Typ klienta to Google Analytics: GA4 (aplikacja). Zmienna Nazwa klienta zwraca nazwę, a nie typ klienta.

6. Zapisz regułę i wpisz nazwę opisową. Możesz na przykład użyć nazwy „Wszystkie zdarzenia aplikacji GA4”.

7. Powinny się teraz wyświetlić ustawienia tagu z nową regułą. 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ć reguł niestandardowych z logiką warunkową opartą na nazwie zdarzenia (lub innej zmiennej) albo dodać wyjątki reguł. Więcej informacji o wywoływaniu reguł i wyjątkach reguł.

Wyświetlanie podglądu kontenera

Zanim opublikujesz zmiany, możesz wyświetlić podgląd kontenera serwera i debugować go w Menedżerze tagów Google. 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 z aplikacji wywoływały konfigurację podglądu, musisz:

1. W kontenerze serwera Menedżera tagów Google kliknąć Podgląd.
2. W prawym górnym rogu kliknąć ikonę Więcej działań ⋮ i wybrać Wysyłaj żądania z aplikacji.

3. Wpisać identyfikator aplikacji i kliknąć Wygeneruj kod QR.

   Uwaga: identyfikator aplikacji musi zaczynać się od litery. Możesz też użyć dowolnego unikalnego identyfikatora, który zaczyna się od litery, o ile pasuje on do identyfikatora użytego w pliku Info.plist lub AndroidManifest.xml.

   

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 sprawdzeniu zmian opublikuj kontener, aby zmiany zaczęły obowiązywać w przypadku całego ruchu. Więcej informacji 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 włączyć wysyłanie danych pomiarowych przez pakiet SDK 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. Znajdziesz go w Menedżerze tagów Google, klikając kolejno Administracja > Ustawienia kontenerów > Adresy URL kontenerów serwera.

   3. Wybierz odsetek ruchu, który chcesz kierować do kontenera serwera. Możesz wybrać opcję poniżej 100%, aby sprawdzić konfigurację serwera, zanim zaczniesz używać tagowania po stronie serwera w przypadku całego ruchu.

      Uwaga: użyj opcji Tylko urządzenia do debugowania, aby włączyć wysyłanie danych do serwera tylko przez aplikacje otwierane w trybie podglądu.

   

6. Kliknij Zapisz. Pakiet SDK pobierze zaktualizowany adres URL kontenera serwera i będzie kierować do niego dane pomiarowe.

Znane ograniczenia

• W przypadku aplikacji na Androida:

  • Automatycznie rejestrowane zakupy w aplikacji zależą od integracji z backendem Google Play i nie będą wysyłane do serwera kontenera.
  • Zdarzenie app_remove nie będzie raportowane na Androidzie.

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

Uwaga: pakiet SDK Google Analytics dla Firebase jest zaprojektowany i zoptymalizowany pod kątem wysyłania danych do Google Analytics 4. Google Analytics 4 można następnie połączyć z Google Ads na potrzeby raportowania konwersji, tworzenia list odbiorców, optymalizacji kampanii i modelowania. Dotyczy to też tagowania po stronie serwera w aplikacjach. Zachęcamy klientów do korzystania z integracji Google Analytics z tagowaniem po stronie serwera w Menedżerze tagów Google.

Interfejs API

Aby uzyskać dostęp do danych konfiguracyjnych Menedżera tagów, możesz użyć interfejsu REST API Menedżera tagów. Więcej informacji o interfejsie API:

• Aby dowiedzieć się, jak korzystać z interfejsu 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.