Menedżer tagów Google na iOS

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

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

  1. Dodaj pakiet Menedżera tagów:

    CocoaPods

    Aby dodać Menedżera tagów za pomocą CocoaPods:

    1. W terminalu uruchom to polecenie:

      $ sudo gem install cocoapods

    2. Przejdź do katalogu projektu.

    3. Uruchom to polecenie, aby utworzyć plik o nazwie Podfile:

      $ pod init

    4. W polu Podfile dodaj:

      pod 'GoogleTagManager', '~> 6.0'

    5. 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:

    1. 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.
    2. W Xcode 12 zainstaluj bibliotekę Menedżera tagów. W tym celu otwórz Plik > Pakiety Menedżera tagów > Dodaj zależność pakietu...

    3. W wyświetlonym oknie wpisz Menedżera tagów GitHub. repozytorium:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git

    4. Wybierz wersję Menedżera tagów, której chcesz używać. Nowe zalecamy używanie najnowszej wersji Menedżera tagów.

    5. Dodaj -ObjC do Innych flag łączących w Ustawieniach kompilacji w do swojego projektu.

  2. Utwórz kontener iOS, jeśli nie masz go na koncie Menedżera tagów:

    1. Zaloguj się na konto Menedżera tagów.
    2. Na karcie Konta wybierz kontener iOS.
    3. Na górnym pasku nawigacyjnym kliknij Administracja.
    4. W kolumnie CONTAINER kliknij przycisk „+”. aby utworzyć kontener.
    5. Wpisz nazwę kontenera.
    6. Wybierz kontener iOS.
    7. Kliknij Utwórz.

  3. Pobierz kontener:

    1. Zaloguj się na konto Menedżera tagów.
    2. Na karcie Konta wybierz kontener iOS.
    3. Kliknij Wersje na górnym pasku nawigacyjnym.
    4. Wybierz wersję kontenera, którą chcesz pobrać.

    5. Kliknij Pobierz.

  4. Dodaj pobrany kontener do projektu:

    1. Skopiuj pobrany plik do folderu o nazwie container w XCode. główny projekt (zwykle PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Otwórz Xcode.
    3. W menu Plik wybierz Dodaj pliki do...
    4. Wybierz folder container.
    5. Kliknij Options (Opcje) i upewnij się, że Tworzenie odwołań do folderów ma wartość zaznaczono.
    6. Kliknij Zakończ.

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:

  1. Zaloguj się na konto Menedżera tagów.
  2. Wybierz kontener mobilny.
  3. Kliknij Wersje na górnym pasku nawigacyjnym.
  4. Kliknij kolejno Działania > Wyświetl podgląd wersji kontenera, której podgląd chcesz wyświetlić.
  5. Wpisz nazwę pakietu aplikacji.

  6. Kliknij Wygeneruj link do rozpoczęcia podglądu.

    Adresy URL podglądu są dostępne w oknie podglądu tagu Interfejs internetowy menedżera

    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.
Rys. 2. Dodawanie schematu adresu URL podglądu Menedżera tagów do pliku z listą właściwości aplikacji.
.

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.

Zapoznaj się z sekcją Konfiguracja zaawansowana.