Google Tag Manager für iOS

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

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

  1. Tag Manager-Paket hinzufügen:

    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 in Ihr 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 Package Manager

    So fügen Sie Tag Manager über den Swift Package Manager 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 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.
    2. Installieren Sie in Xcode 12 die Tag Manager-Bibliothek, indem Sie Datei > Tag Manager-Pakete > Paketabhängigkeit hinzufügen... auswählen.
    3. Geben Sie in die daraufhin angezeigte Eingabeaufforderung das Tag Manager-GitHub-Repository ein:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. 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.

    5. Fügen Sie -ObjC in den Build-Einstellungen des Projekts zu Other Linker Flags (Weitere Verknüpfungs-Flags) hinzu.

  2. Erstellen Sie einen iOS-Container, falls Ihr Tag Manager-Konto keinen enthält:

    1. Melden Sie sich in Ihrem Tag Manager-Konto an.
    2. Klicken Sie in der oberen Navigationsleiste auf VERWALTUNG.
    3. Klicken Sie in der Spalte CONTAINER auf das Drop-down-Menü und wählen Sie CONTAINER ERSTELLEN aus.
    4. Geben Sie einen Containernamen ein.
    5. Wählen Sie den Container iOS aus.
    6. Wählen Sie Firebase (iOS) SDK aus.
    7. Klicke auf ERSTELLEN.
  3. Laden Sie den Container herunter:

    1. Melden Sie sich in Ihrem Tag Manager-Konto an.
    2. Wählen Sie Ihren iOS-Container aus.
    3. Klicken Sie in der oberen Navigationsleiste auf Versionen.
    4. Klicken Sie für die ausgewählte Containerversion auf Aktionen > Herunterladen.

  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 (normalerweise 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 Fertig.

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:

  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 für die Containerversion, die Sie in der Vorschau ansehen möchten, auf Aktionen > Vorschau.
  5. Geben Sie den Paketnamen Ihrer App ein.
  6. Klicken Sie auf Link zum Starten der Vorschau erstellen.

    Vorschau-URLs sind im Vorschaufenster der Tag Manager-Weboberfläche verfügbar.

    Abbildung 1 : Vorschau-URL über die Tag Manager-Weboberfläche abrufen

    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_
Registrieren Sie das Tag Manager-Vorschau-URL-Schema in der Property-Listendatei Ihrer App.
Abbildung 2 : Fügen Sie der Property-Listendatei Ihrer App das Schema für die Vorschau-URL von Tag Manager hinzu.

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 finden Sie unter Erweiterte Konfiguration.