Menedżer tagów Google na Androida

Jako deweloper możesz używać Menedżera tagów Google do implementowania tagów i pikseli pomiarowych w aplikacjach mobilnych oraz zarządzania nimi bez konieczności ponownego kompilowania i przesyłania binarnych plików aplikacji na platformy mobilne. Deweloperzy, którzy korzystają z pakietu SDK Google Analytics dla Firebase, mogą łatwo dodać Menedżera tagów, aby ułatwić sobie zarządzanie implementacją i wprowadzanie w niej zmian, nawet po udostępnieniu aplikacji.

Deweloperzy 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 swoją aplikację do projektu Firebase.
• Skonfiguruj Google Analytics w swojej aplikacji, m.in. włączając Google Analytics w projekcie Firebase i dodając do aplikacji pakiet SDK Google Analytics dla Firebase.
• Utwórz konto Menedżera tagów.
• Skonfiguruj kontener Menedżera tagów Google.

W następnych sekcjach 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 Tag Manager:

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

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

3. Wybierz kontener mobilny.

4. Kliknij Wersje na górnym pasku nawigacyjnym.

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

6. Kliknij Pobierz.

7. Utwórz folder app/src/main/assets/containers, jeśli go nie ma. Skopiuj pobrany kontener do folderu.

2. Zdarzenia i zmienne logu

Menedżer tagów korzysta z zdarzeni, parametrów i właściwości użytkowników zarejestrowanych przez pakiet SDK Google Analytics dla Firebase, aby uruchamiać i tworzyć tagi skonfigurowane w Menedżerze tagów Google.

Więcej informacji o rejestrowaniu zdarzeń i ustawianiu właściwości użytkownika znajdziesz w dokumentacji dla deweloperów Firebase.

Konfigurowanie zmiennych w Menedżerze tagów

Aby rejestrować wartości parametrów zdarzeń i właściwości użytkownika do użycia w Menedżerze tagów Google, możesz konfigurować zmienne w interfejsie Menedżera tagów.

Możesz np. zarejestrować w aplikacji to 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 parametru zdarzenia w ten sposób, aby przechwytywać 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: pełny tekst
• Typ zmiennej: parametr zdarzenia
• Nazwa klucza parametru zdarzenia: full_text

Podobnie możesz 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, która będzie rejestrować wartość favorite_food:

• Nazwa zmiennej: Ulubione jedzenie
• Typ zmiennej: usługa 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ą one zarejestrowane przez pakiet SDK Google Analytics dla Firebase. Modyfikowanie zdarzeń może Ci pomóc w dodawaniu, usuwaniu i zmianie wartości parametrów zdarzeń oraz dostosowywaniu nazw zdarzeń bez konieczności aktualizowania aplikacji. Zdarzenia, które nie są zablokowane, będą rejestrowane przez pakiet SDK Google Analytics dla Firebase.

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

3. Wysyłaj zdarzenia

Zmienne nazwy zdarzeń Firebase, zmienne parametrów zdarzeń Firebase i inne zmienne służą do konfigurowania reguł. Warunki reguł są sprawdzane za każdym razem, gdy rejestrujesz zdarzenie Firebase. Domyślnie zdarzenia Google Analytics dla Firebase uruchamiają się automatycznie. Aby zablokować wysyłanie zdarzeń do Google Analytics, możesz dodać w Menedżerze tagów tag Google Analytics dla Firebase.

4. Podgląd, debugowanie i publikowanie kontenera

Przed opublikowaniem wersji kontenera warto wyświetlić jej podgląd, aby sprawdzić, czy działa ona zgodnie z oczekiwaniami. Menedżer tagów Google umożliwia wyświetlenie podglądu wersji kontenera przez wygenerowanie linków i kodów QR w interfejsie internetowym oraz użycie ich do otwarcia aplikacji. Możesz też włączyć tryb szczegółowego logowania, aby debugować nieoczekiwane zachowanie.

Wyświetl podgląd kontenera

Przed wyświetleniem podglądu 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 następnie kliknij Podgląd. Zapisz ten adres URL podglądu na potrzeby późniejszych czynności.

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

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

   <!--  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. Kliknij Wersje na górnym pasku nawigacyjnym.
   4. W przypadku wersji kontenera, którą chcesz wyświetlić w podglądzie, kliknij Działania > Podgląd.
   5. Wpisz nazwę pakietu aplikacji.
   6. Kliknij Wygeneruj link do rozpoczęcia podglądu.

4. Zatrzymaj aplikację i użyj wygenerowanego linku do podglądu lub kodu QR, aby ją uruchomić.

5. Tryb podglądu możesz zakończyć, klikając link wygenerowany przez opcję Generuj link do podglądu końcowego w interfejsie internetowym.

Debugowanie kontenera

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Publikowanie kontenera

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

Dalsze kroki

Przeczytaj artykuł Konfiguracja zaawansowana.