Jako deweloper możesz za pomocą Menedżera tagów Google wdrażać i zarządzać tagów pomiarowych i pikseli w aplikacjach mobilnych bez konieczności na nowo skompilować pliki binarne aplikacji i przesłać je ponownie do sklepów z aplikacjami. Deweloperzy, którzy używając pakietu SDK Google Analytics dla Firebase, możesz łatwo dodać Menedżera tagów do pomagać w zarządzaniu implementacją i wprowadzaniu w niej zmian, nawet gdy aplikacja wysłano.
Programiści mogą rejestrować ważne zdarzenia i później decydować, które tagi lub piksele zostanie uwolniony.
Wymagania wstępne
- W konsoli Firebase dodaj swoją aplikację do projektu Firebase.
- Skonfiguruj Google Analytics dla swojej aplikacji, w tym włącz Google Analytics. w projekcie Firebase oraz dodając do do aplikacji.
- Utwórz konto Menedżera tagów.
- Skonfiguruj kontener Menedżera tagów.
Sekcje poniżej przeprowadzą Cię przez proces konfigurowania i używania usług Google Menedżer tagów w aplikacji na iOS.
1. Dodawanie Menedżera tagów do projektu
Dodaj pakiet Menedżera tagów:
CocoaPods
Aby dodać Menedżera tagów za pomocą CocoaPods:
W terminalu uruchom to polecenie:
$ sudo gem install cocoapods
Przejdź do katalogu projektu.
Uruchom to polecenie, aby utworzyć plik o nazwie
Podfile
:$ pod init
W polu
Podfile
dodaj:pod 'GoogleTagManager', '~> 6.0'
Aby pobrać i zainstalować Menedżera tagów, uruchom to polecenie: zależności w projekcie:
$ pod install
Menedżer pakietów Swift
Aby dodać Menedżera tagów za pomocą menedżera pakietów Swift:
- W przypadku migracji z projektu opartego na CocoaPods uruchom polecenie
pod deintegrate
usuń CocoaPods z projektu Xcode. Wygenerowane przez CocoaPods.xcworkspace
plik można bezpiecznie usunąć później. Jeśli dodajesz z Firebase do projektu po raz pierwszy, możesz pominąć ten krok. - W Xcode 12 zainstaluj bibliotekę Menedżera tagów. W tym celu otwórz Plik > Pakiety Menedżera tagów > Dodaj zależność pakietu...
W wyświetlonym oknie wpisz Menedżera tagów GitHub. repozytorium:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Wybierz wersję Menedżera tagów, której chcesz używać. Nowe zalecamy używanie najnowszej wersji Menedżera tagów.
Dodaj
-ObjC
do Innych flag łączących w Ustawieniach kompilacji w do swojego projektu.
Utwórz kontener iOS, jeśli nie masz go na koncie Menedżera tagów:
- Zaloguj się na konto Menedżera tagów.
- Na karcie Konta wybierz kontener iOS.
- Na górnym pasku nawigacyjnym kliknij Administracja.
- W kolumnie CONTAINER kliknij przycisk „+”. aby utworzyć kontener.
- Wpisz nazwę kontenera.
- Wybierz kontener iOS.
- Kliknij Utwórz.
Pobierz kontener:
- Zaloguj się na konto Menedżera tagów.
- Na karcie Konta wybierz kontener iOS.
- Kliknij Wersje na górnym pasku nawigacyjnym.
- Wybierz wersję kontenera, którą chcesz pobrać.
Kliknij Pobierz.
Dodaj pobrany kontener do projektu:
- Skopiuj pobrany plik do folderu o nazwie
container
w XCode. główny projekt (zwyklePROJECT_ROOT/container/GTM-XXXXXX.json
). - Otwórz Xcode.
- W menu Plik wybierz Dodaj pliki do...
- Wybierz folder
container
. - Kliknij Options (Opcje) i upewnij się, że Tworzenie odwołań do folderów ma wartość zaznaczono.
- Kliknij Zakończ.
- Skopiuj pobrany plik do folderu o nazwie
2. Zdarzenia i zmienne logu
Menedżer tagów wykorzystuje zdarzenia, parametry i właściwości użytkownika zarejestrowanych przez Google pakietu SDK Analytics dla Firebase do uruchamiania i tworzenia skonfigurowanych tagów; Menedżer tagów Google.
Instrukcje znajdziesz w dokumentacji dla deweloperów Firebase. Zdarzenia z dziennika i ustawianie właściwości użytkownika.
Konfigurowanie zmiennych w Menedżerze tagów
Aby rejestrować wartość parametrów zdarzeń i właściwości użytkownika na potrzeby Google Zmienne możesz konfigurować w interfejsie Menedżera tagów.
Możesz na przykład zarejestrować w aplikacji to zdarzenie niestandardowe:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
Następnie możesz skonfigurować w Menedżerze tagów nowe zmienne parametru zdarzenia jako:
to, aby przechwycić 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
W podobny sposób możesz ustawić w aplikacji tę właściwość użytkownika:
Analytics.setUserProperty(food, forName: "favorite_food")
Następnie możesz skonfigurować w tagu Google nową zmienną właściwości użytkownika Firebase
Menedżer do przechwytywania wartości favorite_food
:
- Nazwa zmiennej: Ulubione jedzenie
- 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 pakietu SDK Google Analytics dla Firebase. Modyfikowanie zdarzeń może pomóc Ci dodawać, usuwać zmieniać wartości parametrów zdarzeń lub dostosowywać nazwy zdarzeń bez aktualizacji aplikacji. Niezablokowane zdarzenia będą rejestrowane przez Google Analytics dla Firebase SDK.
Pakiet SDK Google Analytics dla Firebase automatycznie rejestruje też niektóre zdarzenia oraz właściwości użytkownika. Zdarzeń i usług zbieranych automatycznie możesz używać w tych usługach: Menedżera tagów bez konieczności dodawania kodu. Nie możesz jednak ich zablokować.
3. Wysyłaj zdarzenia
Zmienne nazw zdarzeń Firebase, zmienne parametrów zdarzenia Firebase i inne zmiennych służą do konfigurowania reguł. Warunki aktywatora są oceniane za każdym razem, gdy rejestrujesz zdarzenie Firebase. Domyślnie Google Analytics dla Firebase zdarzeń. Można dodać Google Analytics dla Firebase w Menedżerze tagów, 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 wszystko działa zgodnie z oczekiwaniami. Menedżer tagów umożliwia wyświetlenie podglądu wersji przez wygenerowanie linków i kodów QR w interfejsie internetowym Menedżera tagów. przy użyciu tych przycisków do otwierania aplikacji.
Wyświetl podgląd kontenera
Aby wyświetlić podgląd kontenera, wygeneruj adres URL podglądu na stronie Menedżera tagów interfejs:
- Zaloguj się na konto Menedżera tagów.
- Wybierz kontener mobilny.
- Kliknij Wersje na górnym pasku nawigacyjnym.
- Kliknij kolejno Działania > Wyświetl podgląd wersji kontenera, której podgląd chcesz wyświetlić.
- Wpisz nazwę pakietu aplikacji.
Kliknij Wygeneruj link do rozpoczęcia podglądu.
Rysunek 1. Pobieranie adresu URL podglądu z tagu Interfejs internetowy Menedżera tagów. Zapisz ten adres URL podglądu na potrzeby późniejszych czynności.
Aby włączyć podglądy kontenerów, musisz zdefiniować schemat adresu URL podglądu Menedżera tagów na liście właściwości projektu. W sekcji Typy adresów URL właściwości aplikacji , zarejestruj następujący identyfikator adresu URL i schemat adresu URL:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
![Zarejestruj schemat adresu URL podglądu menedżera tagów w pliku
z listą właściwości.](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/plist.png?authuser=4&hl=pl)
Zatrzymaj aplikację i otwórz adres URL podglądu w emulatorze lub na urządzeniu fizycznym aby wyświetlić podgląd wersji roboczej kontenera w aplikacji.
Kontener debugowania
Gdy uruchomisz aplikację w symulatorze lub w trybie podglądu, automatycznie zmienia tryb logowania na szczegółowy.
Publikowanie kontenera
Po wyświetleniu podglądu kontenera i sprawdzeniu, czy działa, możesz: opublikuj go. Po opublikowaniu kontenera możesz skonfigurować tagi będą dostępne dla użytkowników aplikacji mobilnych.
Przydatne materiały
Zapoznaj się z sekcją Konfiguracja zaawansowana.