Als Entwickler können Sie mit Google Tag Manager Mess-Tags und -Pixel in Ihren mobilen Apps implementieren und verwalten, ohne die Binärprogramme der Anwendung neu erstellen und 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 auch nach dem Versand der App zu verwalten und Änderungen daran vorzunehmen.
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, Google Analytics in Ihrem Firebase-Projekt zu aktivieren und Ihrer App das Google Analytics for Firebase SDK hinzuzufügen.
- Erstellen Sie ein Tag Manager-Konto.
- Konfigurieren Sie einen Tag Manager-Container.
In den folgenden Abschnitten wird beschrieben, wie Sie Google Tag Manager in Ihrer iOS-App konfigurieren und verwenden.
1. Tag Manager zum Projekt hinzufügen
Tag Manager-Paket hinzufügen:
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 in Ihr 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 Package Manager
So fügen Sie Tag Manager über den Swift Package Manager 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 Datei.xcworkspace
kann anschließend sicher gelöscht werden. Wenn Sie Firebase zum ersten Mal in ein Projekt aufnehmen, können Sie diesen Schritt ignorieren. - Installieren Sie in Xcode 12 die Tag Manager-Bibliothek, indem Sie Datei > Tag Manager-Pakete > Paketabhängigkeit hinzufügen... auswählen.
Geben Sie in die daraufhin angezeigte Eingabeaufforderung das Tag Manager-GitHub-Repository ein:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Wählen Sie die Tag Manager-Version aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir, die neueste Version von Tag Manager zu verwenden.
Fügen Sie
-ObjC
in den Build-Einstellungen des Projekts zu Other Linker Flags (Weitere Verknüpfungs-Flags) hinzu.
Erstellen Sie einen iOS-Container, falls Ihr Tag Manager-Konto keinen enthält:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Klicken Sie in der oberen Navigationsleiste auf VERWALTUNG.
- Klicken Sie in der Spalte CONTAINER auf das Drop-down-Menü und wählen Sie CONTAINER ERSTELLEN aus.
- Geben Sie einen Containernamen ein.
- Wählen Sie den Container iOS aus.
- Wählen Sie Firebase (iOS) SDK aus.
- Klicke auf ERSTELLEN.
Laden Sie den Container herunter:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Wählen Sie Ihren iOS-Container aus.
- Klicken Sie in der oberen Navigationsleiste auf Versionen.
Klicken Sie für die ausgewählte Containerversion auf Aktionen > 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 (normalerweisePROJECT_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 Fertig.
- Kopieren Sie die heruntergeladene Datei in einen Ordner mit dem Namen
2. Ereignisse und Variablen protokollieren
In Tag Manager werden vom Google Analytics for Firebase SDK erfasste Ereignisse, Parameter und Nutzereigenschaften verwendet, um in Google Tag Manager konfigurierte Tags auszulösen und zu erstellen.
Eine Anleitung zum Protokollieren von Ereignissen und zum 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 auf 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 neue Ereignisparametervariablen in Tag Manager so konfigurieren, dass die Werte image_name
und full_text parameter
erfasst werden:
- Variablenname: Image-Name
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
image_name
und:
- Variablenname: Volltext
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
full_text
Entsprechend könnten 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 Firebase-Nutzereigenschaftsvariable konfigurieren, um den Wert favorite_food
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. Durch das Ändern von Ereignissen können Sie die Werte von Ereignisparametern hinzufügen, entfernen oder ändern oder Ereignisnamen ohne App-Updates anpassen. Nicht blockierte Ereignisse werden vom Google Analytics for Firebase SDK protokolliert.
Einige Ereignisse und Nutzereigenschaften werden auch automatisch vom Google Analytics for Firebase SDK protokolliert. Automatisch erfasste Ereignisse und Properties lassen sich in Tag Manager verwenden, ohne Code hinzufügen zu müssen. Sie können sie jedoch nicht blockieren.
3. Ereignisse senden
Variablen für Firebase-Ereignisnamen, Variablen für Firebase-Ereignisparameter und andere Variablen werden zum Einrichten von Triggern verwendet. Triggerbedingungen werden immer dann ausgewertet, wenn ein Firebase-Ereignis protokolliert wird. 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 veröffentlichen
Bevor Sie eine Version Ihres Containers veröffentlichen, sollten Sie in der Vorschau prüfen, ob er wie gewünscht funktioniert. Mit Tag Manager können Sie sich eine Vorschau der Versionen Ihres Containers ansehen. Dazu generieren Sie Links und QR-Codes in der Tag Manager-Weboberfläche, um damit Ihre Anwendung zu öffnen.
Vorschaucontainer
Wenn Sie einen Container als Vorschau ansehen möchten, generieren Sie auf der Tag Manager-Weboberfläche eine Vorschau-URL:
- 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 für die Containerversion, die Sie in der Vorschau ansehen möchten, auf Aktionen > Vorschau.
- Geben Sie den Paketnamen Ihrer App ein.
Klicken Sie auf Link zum Starten der Vorschau erstellen.
Speichern Sie diese Vorschau-URL für spätere Schritte.
Um die Containervorschau zu aktivieren, müssen Sie das Tag Manager-Vorschau-URL-Schema in der Property-Liste Ihres Projekts definieren. Registrieren Sie unter URL-Typen in der Property-Listendatei Ihrer Anwendung die folgende URL-Kennung und das URL-Schema:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Beenden Sie Ihre Anwendung und öffnen Sie die Vorschau-URL in einem Emulator oder auf einem physischen Gerät, um eine Vorschau des Containerentwurfs in Ihrer Anwendung anzuzeigen.
Fehler im Container beheben
Wenn Sie Ihre App in einem Simulator oder im Vorschaumodus ausführen, wird die Protokollierung in Tag Manager automatisch in ausführlicher Modus geändert.
Container veröffentlichen
Nachdem Sie sich den Container als Vorschau angesehen und sichergestellt haben, dass 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.