Google Tag Manager für iOS

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

1. Fügen Sie das Tag Manager-Paket hinzu:

   CocoaPods

   So fügen Sie Tag Manager über CocoaPods hinzu:

   1. Führen Sie in einem Terminal den folgenden Befehl aus:

      $ sudo gem install cocoapods
      

   2. Wechseln Sie zu Ihrem Projektverzeichnis.

   3. Führen Sie den folgenden Befehl aus, um eine Datei mit dem Namen Podfile zu erstellen:

      $ pod init
      

   4. Fügen Sie in Podfile Folgendes hinzu:

      pod 'GoogleTagManager', '~> 6.0'
      

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

   1. 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.
   2. Installieren Sie in Xcode 12 die Tag Manager-Bibliothek, indem Sie Datei > Tag Manager-Pakete > Paketabhängigkeit hinzufügen... aufrufen.

   3. Geben Sie in der angezeigten Eingabeaufforderung das Tag Manager-GitHub-Repository ein:

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

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

   5. Fügen Sie in den Build-Einstellungen Ihres Projekts -ObjC unter Other Linker Flags (Andere Verknüpfungs-Flags) hinzu.

2. Erstellen Sie einen iOS-Container, falls in Ihrem Tag Manager-Konto noch keiner vorhanden ist:

   1. Melden Sie sich in Ihrem Tag Manager-Konto an.
   2. Wählen Sie auf dem Tab Konten Ihren iOS-Container aus.
   3. Klicken Sie oben in der Navigationsleiste auf Verwaltung.
   4. Klicken Sie in der Spalte CONTAINER auf das Pluszeichen (+), um einen Container zu erstellen.
   5. Geben Sie einen Containernamen ein.
   6. Wählen Sie den Container iOS aus.
   7. Klicken Sie auf Erstellen.

3. Laden Sie den Container herunter:

   1. Melden Sie sich in Ihrem Tag Manager-Konto an.
   2. Wählen Sie auf dem Tab Konten Ihren iOS-Container aus.
   3. Klicken Sie in der oberen Navigationsleiste auf Versionen.
   4. Wählen Sie die Version des Containers aus, den Sie herunterladen möchten.

   5. Klicken Sie auf Herunterladen.

      Hinweis: Der Name der heruntergeladenen Datei ist die Container-ID mit der Erweiterung .json.

4. Fügen Sie Ihrem Projekt den heruntergeladenen Container hinzu:

   1. Kopieren Sie die heruntergeladene Datei in einen Ordner mit dem Namen container im XCode-Projektstamm (in der Regel PROJECT_ROOT/container/GTM-XXXXXX.json).
   2. Öffnen Sie Xcode.
   3. Wählen Sie im Menü Datei die Option Dateien hinzufügen zu... aus.
   4. container-Ordner auswählen
   5. Klicken Sie auf Optionen und prüfen Sie, ob Ordnerreferenzen erstellen ausgewählt ist.
   6. Klicken Sie auf Finish (Beenden).

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:

1. Melden Sie sich in Ihrem Tag Manager-Konto an.
2. Wählen Sie einen mobilen Container aus.
3. Klicken Sie in der oberen Navigationsleiste auf Versionen.
4. Klicken Sie bei der Containerversion, die Sie sich ansehen möchten, auf Aktionen > Vorschau.
5. Geben Sie den Paketnamen Ihrer App ein.

6. 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_

Abbildung 2: Fügen Sie der Datei mit der Property-Liste Ihrer Anwendung das Tag Manager-Vorschau-URL-Schema hinzu.

Hinweis :your.package.name muss mit dem Namen der App übereinstimmen, die zum Generieren der Vorschau-URL verwendet wurde (siehe Abbildung 1).

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.

Hinweis: Für mobile Container wird ein Standardcontainer verwendet, um die anfänglichen Tag-Konfigurationen festzulegen, bis zum ersten Mal ein Container heruntergeladen wird. Sobald die Anwendung eine Verbindung zum Internet hergestellt und einen Container heruntergeladen hat, wird der Standardcontainer nie mehr verwendet. Anwendungen prüfen in der Regel alle zwölf Stunden, ob Containerupdates verfügbar sind.

Weitere Informationen

Weitere Informationen finden Sie unter Erweiterte Konfiguration.