Als Entwickler können Sie Google Tag Manager verwenden, um Mess-Tags und Pixel in Ihren mobilen Apps zu implementieren und zu verwalten, ohne die Binärdateien der Anwendung neu erstellen und erneut an App-Marktplätze senden zu müssen. Entwickler, die das Google Analytics for Firebase SDK verwenden, können Tag Manager ganz einfach hinzufügen, um die Implementierung zu verwalten und Änderungen daran vorzunehmen, auch nachdem die App bereits versendet wurde.
Entwickler können wichtige Ereignisse protokollieren und später entscheiden, welche Tags oder Pixel ausgelöst werden sollen.
Voraussetzungen
- Fügen Sie die App in der Firebase Console Ihrem Firebase-Projekt hinzu.
- Richten Sie Google Analytics für Ihre App ein. Dazu gehört auch, dass Sie Google Analytics in Ihrem Firebase-Projekt aktivieren und Ihrer App das Google Analytics for Firebase SDK hinzufügen.
- Erstellen Sie ein Tag Manager-Konto.
- Konfigurieren Sie einen Tag Manager-Container.
In den folgenden Abschnitten erfahren Sie, wie Sie Google Tag Manager konfigurieren und in Ihrer iOS-App verwenden.
1. Tag Manager zum Projekt hinzufügen
Fügen Sie das Tag Manager-Paket hinzu:
CocoaPods
So fügen Sie Tag Manager über CocoaPods hinzu:
Führen Sie in einem Terminal den folgenden Befehl aus:
$ sudo gem install cocoapods
Wechseln Sie zu Ihrem Projektverzeichnis.
Führen Sie den folgenden Befehl aus, um eine Datei mit dem Namen
Podfile
zu erstellen:$ pod init
Fügen Sie in
Podfile
Folgendes hinzu:pod 'GoogleTagManager', '~> 6.0'
Führen Sie den folgenden Befehl aus, um Tag Manager-Abhängigkeiten herunterzuladen und in Ihrem Projekt zu installieren:
$ pod install
Swift-Paketmanager
So fügen Sie Tag Manager über den Swift-Paketmanager hinzu:
- Wenn Sie von einem CocoaPods-basierten Projekt migrieren, führen Sie
pod deintegrate
aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte.xcworkspace
-Datei kann anschließend problemlos gelöscht werden. Wenn Sie Firebase zum ersten Mal zu einem Projekt hinzufügen, kann dieser Schritt ignoriert werden. - Installieren Sie in Xcode 12 die Tag Manager-Bibliothek, indem Sie Datei > Tag Manager-Pakete > Paketabhängigkeit hinzufügen... aufrufen.
Geben Sie in der angezeigten Eingabeaufforderung das Tag Manager-GitHub-Repository ein:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Wählen Sie die Version von Tag Manager aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir die aktuelle Version von Tag Manager.
Fügen Sie in den Build-Einstellungen Ihres Projekts
-ObjC
unter Other Linker Flags (Andere Verknüpfungs-Flags) hinzu.
Erstellen Sie einen iOS-Container, falls in Ihrem Tag Manager-Konto noch keiner vorhanden ist:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Wählen Sie auf dem Tab Konten Ihren iOS-Container aus.
- Klicken Sie oben in der Navigationsleiste auf Verwaltung.
- Klicken Sie in der Spalte CONTAINER auf das Pluszeichen (+), um einen Container zu erstellen.
- Geben Sie einen Containernamen ein.
- Wählen Sie den Container iOS aus.
- Klicken Sie auf Erstellen.
Laden Sie den Container herunter:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Wählen Sie auf dem Tab Konten Ihren iOS-Container aus.
- Klicken Sie in der oberen Navigationsleiste auf Versionen.
- Wählen Sie die Version des Containers aus, den Sie herunterladen möchten.
Klicken Sie auf Herunterladen.
Fügen Sie Ihrem Projekt den heruntergeladenen Container hinzu:
- Kopieren Sie die heruntergeladene Datei in einen Ordner mit dem Namen
container
im XCode-Projektstamm (in der RegelPROJECT_ROOT/container/GTM-XXXXXX.json
). - Öffnen Sie Xcode.
- Wählen Sie im Menü Datei die Option Dateien hinzufügen zu... aus.
container
-Ordner auswählen- Klicken Sie auf Optionen und prüfen Sie, ob Ordnerreferenzen erstellen ausgewählt ist.
- Klicken Sie auf Finish (Beenden).
- Kopieren Sie die heruntergeladene Datei in einen Ordner mit dem Namen
2. Ereignisse und Variablen protokollieren
In Tag Manager werden Ereignisse, Parameter und Nutzereigenschaften verwendet, die vom Google Analytics for Firebase SDK protokolliert wurden, um Tags auszulösen und zu erstellen, die Sie in Google Tag Manager konfiguriert haben.
Eine Anleitung zum Protokollieren von Ereignissen und Festlegen von Nutzereigenschaften finden Sie in der Firebase-Entwicklerdokumentation.
Variablen in Tag Manager konfigurieren
Wenn Sie den Wert von Ereignisparametern und Nutzereigenschaften zur Verwendung in Google Tag Manager erfassen möchten, können Sie in der Tag Manager-Oberfläche Variablen konfigurieren.
Sie können beispielsweise das folgende benutzerdefinierte Ereignis in Ihrer App protokollieren:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
Anschließend können Sie in Tag Manager neue Variablen für Ereignisparameter konfigurieren, um die Werte image_name
und full_text parameter
zu erfassen:
- Variablenname: Bildname
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
image_name
und:
- Variablenname: Volltext
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
full_text
Ebenso können Sie die folgende Nutzereigenschaft in Ihrer App festlegen:
Analytics.setUserProperty(food, forName: "favorite_food")
Anschließend können Sie in Google Tag Manager eine neue Variable für Firebase-Nutzereigenschaften konfigurieren, um den favorite_food
-Wert zu erfassen:
- Variablenname: Lieblingsessen
- Variablentyp: Firebase-Nutzereigenschaft
- Name des Ereignisparameterschlüssels:
favorite_food
Ereignisse ändern und blockieren
Mit Tag Manager können Sie Ereignisse ändern und blockieren, bevor sie vom Google Analytics for Firebase SDK protokolliert werden. Wenn Sie Ereignisse ändern, können Sie Ereignisparameter hinzufügen, entfernen oder ändern oder Ereignisnamen anpassen, ohne die App zu aktualisieren. Nicht blockierte Ereignisse werden vom Google Analytics for Firebase SDK in Logs erfasst.
Das Google Analytics for Firebase SDK protokolliert außerdem automatisch einige Ereignisse und Nutzereigenschaften. Sie können automatisch erfasste Ereignisse und Properties in Tag Manager verwenden, ohne Code hinzufügen zu müssen. Sie können sie jedoch nicht blockieren.
3. Ereignisse senden
Firebase-Ereignisnamenvariablen, Firebase-Ereignisparametervariablen und andere Variablen werden zum Einrichten von Triggern verwendet. Triggerbedingungen werden immer dann ausgewertet, wenn Sie ein Firebase-Ereignis protokollieren. Standardmäßig werden Google Analytics for Firebase-Ereignisse automatisch ausgelöst. Sie können in Tag Manager ein Google Analytics for Firebase-Tag hinzufügen, um zu verhindern, dass Ereignisse an Google Analytics gesendet werden.
4. Container als Vorschau ansehen, Fehler beheben und Container veröffentlichen
Bevor Sie eine Version eines Containers veröffentlichen, sollten Sie prüfen, ob er wie vorgesehen funktioniert. Mit Tag Manager können Sie sich eine Vorschau der Containerversionen ansehen. Generieren Sie dazu in der Weboberfläche von Tag Manager Links und QR-Codes und öffnen Sie damit Ihre Anwendung.
Vorschaucontainer
Generieren Sie in der Weboberfläche von Tag Manager eine Vorschau-URL, um einen Container in der Vorschau anzeigen zu lassen:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Wählen Sie einen mobilen Container aus.
- Klicken Sie in der oberen Navigationsleiste auf Versionen.
- Klicken Sie bei der Containerversion, die Sie sich ansehen möchten, auf Aktionen > Vorschau.
- Geben Sie den Paketnamen Ihrer App ein.
Klicken Sie auf Link zum Starten der Vorschau erstellen.
Abbildung 1 : Vorschau-URL von der Weboberfläche von Tag Manager abrufen Speichern Sie diese Vorschau-URL für spätere Schritte.
Wenn Sie die Containervorschau aktivieren möchten, müssen Sie das Vorschau-URL-Schema von Tag Manager in der Eigenschaftenliste Ihres Projekts definieren. Registrieren Sie unter URL-Typen der Property-Listendatei Ihrer Anwendung die folgende URL-Kennung und das folgende URL-Schema:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
![Registrieren Sie das Tag Manager-Vorschau-URL-Schema in der Eigenschaftenlistendatei Ihrer Anwendung.](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/plist.png?authuser=5&hl=de)
Beenden Sie die Anwendung und öffnen Sie die Vorschau-URL in einem Emulator oder einem physischen Gerät, um eine Vorschau des Entwurfscontainers in Ihrer Anwendung anzuzeigen.
Fehlerbehebung für Container
Wenn Sie Ihre App in einem Simulator oder Vorschaumodus ausführen, wird die Protokollierung von Tag Manager automatisch in eine ausführliche Protokollierung geändert.
Container veröffentlichen
Nachdem Sie den Container in der Vorschau angesehen und geprüft haben, ob er funktioniert, können Sie ihn veröffentlichen. Nachdem Sie den Container veröffentlicht haben, sind Ihre Tag-Konfigurationen für Nutzer mobiler Apps verfügbar.
Weitere Informationen
Weitere Informationen finden Sie unter Erweiterte Konfiguration.