Menedżer tagów Google na Androida

Jako deweloper możesz używać Menedżera tagów Google do wdrażania tagów i pikseli pomiarowych w aplikacjach mobilnych oraz zarządzania nimi bez konieczności ponownego kompilowania i przesyłania plików binarnych aplikacji na platformy handlowe. Deweloperzy, którzy pracują z pakietem SDK Google Analytics dla Firebase, mogą łatwo dodać Menedżera tagów, aby zarządzać implementacją i wprowadzać w niej zmiany, nawet po udostępnieniu aplikacji.

Programiści mogą rejestrować ważne zdarzenia i później decydować, które tagi lub piksele mają być uruchamiane.

Wymagania wstępne

Zanim zaczniesz:

• W konsoli Firebase dodaj aplikację do projektu Firebase.
• Skonfiguruj Google Analytics w aplikacji, w tym włącz Google Analytics w projekcie w Firebase i dodaj do aplikacji (pakiet) SDK Google Analytics dla Firebase.
• Utwórz konto Menedżera tagów.
• Skonfiguruj kontener Menedżera tagów Google.

W sekcjach poniżej znajdziesz instrukcje konfigurowania i używania Menedżera tagów Google w aplikacji na Androida.

1. Dodawanie Menedżera tagów Google do projektu

1. W pliku Gradle modułu (zwykle app/build.gradle) dodaj tę zależność od biblioteki Menedżera tagów:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. Zaloguj się na konto Menedżera tagów.

3. Wybierz kontener mobilny.

4. Na górnym pasku nawigacyjnym kliknij Wersje.

5. Kliknij wersję kontenera, której chcesz użyć.

6. Kliknij Pobierz.

7. Jeśli folder app/src/main/assets/containers nie istnieje, utwórz go. Skopiuj pobrany kontener do folderu.

2. Zdarzenia i zmienne z dziennika

Menedżer tagów używa zdarzeń, parametrów i właściwości użytkownika rejestrowanych przez pakiet SDK Google Analytics dla Firebase do uruchamiania i tworzenia tagów skonfigurowanych w Menedżerze tagów Google.

Instrukcje rejestrowania zdarzeń i ustawiania właściwości użytkownika znajdziesz w dokumentacji Firebase dla deweloperów.

Konfigurowanie zmiennych w Menedżerze tagów

Aby rejestrować wartości parametrów zdarzeń i właściwości użytkowników na potrzeby Menedżera tagów Google, możesz skonfigurować zmienne w interfejsie Menedżera tagów.

Możesz na przykład zarejestrować w aplikacji takie zdarzenie niestandardowe:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Następnie możesz skonfigurować w Menedżerze tagów nowe zmienne parametrów zdarzenia, aby rejestrować wartości image_name i full_text parameter:

• Nazwa zmiennej: Nazwa obrazu
• Typ zmiennej: Parametr zdarzenia
• Nazwa klucza parametru zdarzenia: image_name

i:

• Nazwa zmiennej: Full Text
• Typ zmiennej: Parametr zdarzenia
• Nazwa klucza parametru zdarzenia: full_text

Możesz też ustawić w aplikacji tę właściwość użytkownika:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Następnie możesz skonfigurować w Menedżerze tagów Google nową zmienną właściwości użytkownika Firebase, aby rejestrować wartość favorite_food:

• Nazwa zmiennej: Ulubione danie
• Typ zmiennej: Właściwość użytkownika Firebase
• Nazwa klucza parametru zdarzenia: favorite_food

Modyfikowanie i blokowanie zdarzeń

Menedżer tagów umożliwia modyfikowanie i blokowanie zdarzeń, zanim zostaną zarejestrowane przez pakiet SDK Google Analytics dla Firebase. Modyfikowanie zdarzeń umożliwia dodawanie, usuwanie i zmienianie wartości parametrów zdarzeń oraz dostosowywanie nazw zdarzeń bez aktualizowania aplikacji. Zdarzenia, które nie są blokowane, będą rejestrowane przez pakiet SDK Google Analytics dla Firebase.

Pakiet SDK Google Analytics dla Firebase automatycznie rejestruje też niektóre zdarzenia i właściwości użytkownika. Możesz używać zdarzeń zebranych automatycznie i właściwości w Menedżerze tagów bez konieczności dodawania kodu. Nie możesz jednak zablokować tych osób.

3. Wysyłanie zdarzeń

Zmienne nazwy zdarzenia Firebase, zmienne parametru zdarzenia Firebase i inne zmienne służą do konfigurowania reguł. Warunki reguł są sprawdzane przy każdym zarejestrowaniu zdarzenia Firebase. Domyślnie zdarzenia Google Analytics dla Firebase są wywoływane automatycznie. W Menedżerze tagów można dodać tag Google Analytics dla Firebase, aby zablokować wysyłanie zdarzeń do Google Analytics.

4. Wyświetlanie podglądu, debugowanie i publikowanie kontenera

Przed opublikowaniem wersji kontenera warto wyświetlić jej podgląd, aby upewnić się, że działa zgodnie z oczekiwaniami. Menedżer tagów Google umożliwia wyświetlanie podglądu wersji kontenera przez generowanie linków i kodów QR w interfejsie internetowym i używanie ich do otwierania aplikacji. Możesz też włączyć tryb logowania szczegółowego, aby debugować nieoczekiwane zachowanie.

Podgląd kontenera

Zanim wyświetlisz podgląd kontenera, wygeneruj URL podglądu w interfejsie internetowym Menedżera tagów Google. Aby to zrobić, wybierz wersję kontenera, której podgląd chcesz wyświetlić, a potem kliknij Podgląd. Zapisz ten adres URL podglądu, aby użyć go w późniejszych krokach.

Rysunek 1. Pobieranie adresu URL podglądu z interfejsu internetowego Menedżera tagów

Aby wyświetlić podgląd kontenera (jeśli używasz Android Studio, przejdź do kroku 3):

1. Dodaj tę aktywność podglądu do pliku AndroidManifest:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Zmień ten wiersz, aby uwzględnić nazwę pakietu aplikacji:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. W interfejsie internetowym Menedżera tagów Google wygeneruj link do podglądu:

   1. Zaloguj się na konto Menedżera tagów.
   2. Wybierz kontener mobilny.
   3. Na górnym pasku nawigacyjnym kliknij Wersje.
   4. Kliknij Działania > Podgląd obok wersji kontenera, którą chcesz wyświetlić.
   5. Wpisz nazwę pakietu aplikacji.
   6. Kliknij Wygeneruj link do podglądu.

4. Zatrzymaj aplikację i uruchom ją za pomocą wygenerowanego linku do podglądu lub kodu QR.

5. Aby wyjść z trybu podglądu, kliknij link wygenerowany za pomocą opcji Wygeneruj link do zakończenia podglądu w interfejsie internetowym.

Kontener debugowania

Aby rozwiązać problemy z implementacją kontenera, włącz logowanie szczegółowe:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Opublikuj kontener

Po wyświetleniu podglądu kontenera i sprawdzeniu, czy działa, możesz go opublikować. Po opublikowaniu kontenera konfiguracje tagów staną się dostępne dla użytkowników aplikacji mobilnej.

Uwaga: w przypadku kontenerów mobilnych do ustawienia początkowych konfiguracji tagów używany jest kontener domyślny, dopóki kontener nie zostanie pobrany po raz pierwszy. Gdy aplikacja połączy się z internetem i pobierze kontener, nigdy więcej nie użyje kontenera domyślnego. Aplikacje okresowo sprawdzają dostępność aktualizacji kontenera, zwykle co 12 godzin.

Dalsze kroki

Przeczytaj artykuł Konfiguracja zaawansowana.