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 tworzenia i przesyłania plików binarnych aplikacji na platformy aplikacji. 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.

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 aplikację do projektu w 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. Utwórz folder app/src/main/assets/containers, jeśli jeszcze nie istnieje. Skopiuj pobrany kontener do folderu.

2. Rejestrowanie zdarzeń i zmiennych

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 wywoływania i tworzenia tagów skonfigurowanych w Menedżerze tagów Google.

W dokumentacji dla deweloperów Firebase znajdziesz instrukcje dotyczące rejestrowania zdarzeń i ustawiania właściwości użytkownika.

Konfigurowanie zmiennych w Menedżerze tagów

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

W aplikacji możesz na przykład zarejestrować 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 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: 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 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ń może pomóc w dodawaniu, usuwaniu lub zmienianiu wartości parametrów zdarzeń albo w dostosowywaniu 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ń i właściwości zbieranych automatycznie w Menedżerze tagów bez konieczności dodawania kodu. Nie możesz jednak ich zablokować.

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żesz dodać tag Google Analytics dla Firebase, aby blokować wysyłanie zdarzeń do Google Analytics.

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

Zanim opublikujesz wersję 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 oraz otwieranie aplikacji za ich pomocą. Możesz też włączyć tryb logowania szczegółowego, aby debugować nieoczekiwane zachowania.

Kontener podglądu

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 na potrzeby kolejnych kroków.

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

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

1. Dodaj to działanie 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 zawierał nazwę pakietu aplikacji:

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

3. W interfejsie internetowym Menedżera tagów Google wygeneruj link 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 w przypadku wersji kontenera, którą chcesz wyświetlić w podglądzie.
   5. Wpisz nazwę pakietu aplikacji.
   6. Kliknij Wygeneruj link do podglądu.

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

5. Aby wyjść z trybu podglądu, kliknij link wygenerowany przez opcję 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

Publikowanie kontenera

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 mobilnych.

Uwaga: w przypadku kontenerów mobilnych do ustawiania początkowych konfiguracji tagów używany jest kontener domyślny, dopóki nie zostanie pobrany pierwszy kontener. Gdy aplikacja połączy się z internetem i pobierze kontener, nigdy więcej nie użyje kontenera domyślnego. Aplikacje okresowo sprawdzają, czy są dostępne aktualizacje kontenera,

zwykle co 12 godzin.

Dalsze kroki

Przeczytaj Ustawienia zaawansowane.