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 korzystania z 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. Na pasku nawigacyjnym u góry kliknij Wersje.

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. Rejestrowanie zdarzeń i zmiennych

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 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 to zdarzenie niestandardowe:

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

Aby rejestrować wartości image_name i full_text parameter, możesz skonfigurować w Menedżerze tagów nowe zmienne Parametr zdarzenia w ten sposób:

• 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ść użytkownika Firebase, aby 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ą blokowane, 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 zablokować tych użytkowników.

3. Wysyłanie zdarzeń

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 są wywoływane 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

Zanim opublikujesz wersję kontenera, warto wyświetlić jej podgląd, aby sprawdzić, czy działa ona zgodnie z oczekiwaniami. Menedżer tagów Google umożliwia wyświetlanie wersji roboczych kontenera w podglądzie, generowanie linków i kodów QR w interfejsie internetowym oraz otwieranie aplikacji za pomocą tych linków i kodów. Możesz też włączyć tryb szczegółowego logowania, aby debugować nieoczekiwane zachowanie.

Podgląd kontenera

Przed wyświetleniem podglądu kontenera wygeneruj URL podglądu w interfejsie internetowym Menedżera tagów Google. W tym celu wybierz wersję kontenera, której podgląd chcesz wyświetlić, a następnie kliknij Podgląd. Zapisz ten URL podglądu na później.

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. Na pasku nawigacyjnym u góry kliknij Wersje.
   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.