Google Tag Manager für iOS

Als Entwickler können Sie mit Google Tag Manager Mess-Tags und Pixel in Ihren mobilen Apps verwenden, ohne die Binärdateien der Anwendung neu erstellen und erneut an die App-Marktplätze senden. Entwickler, die Wenn Sie das Google Analytics for Firebase SDK verwenden, können Sie Sie bei der Verwaltung und Änderung der Implementierung unterstützen, auch nachdem die App versendet.

Entwickler können wichtige Ereignisse protokollieren und später entscheiden, welche Tags oder Pixel ausgelöst werden.

Vorbereitung

• Fügen Sie die App in der Firebase Console Ihrem Firebase-Projekt hinzu.
• Richten Sie Google Analytics für Ihre App ein und aktivieren Sie Google Analytics. in Ihrem Firebase-Projekt erstellen und das Google Analytics for Firebase SDK für Ihre App.
• Erstellen Sie ein Tag Manager-Konto.
• Konfigurieren Sie einen Tag Manager-Container.

In den folgenden Abschnitten zeigen wir Ihnen Schritt für Schritt, wie Sie Google Tag Manager in Ihrer iOS-App.

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 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 herunterzuladen und zu installieren zu Ihrem Projekt hinzufügen:

      $ 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, CocoaPods aus Ihrem Xcode-Projekt entfernen. Die von CocoaPods generierten .xcworkspace Datei kann anschließend sicher gelöscht werden. Wenn Sie Firebase zum ersten Mal mit einem Projekt verknüpfen, 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...

   3. Geben Sie in der daraufhin angezeigten Eingabeaufforderung den GitHub-Code von Tag Manager ein. Repository:

      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 Projekten arbeiten, empfehlen wir, die neueste Version von Tag Manager zu verwenden.

   5. Fügen Sie -ObjC in den Build-Einstellungen unter Other Linker Flags (Andere Verknüpfungs-Flags) hinzu. für Ihr Projekt.

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 einer .json Erweiterung.

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

   1. Kopieren Sie die heruntergeladene Datei in den XCode-Ordner mit dem Namen container. 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 Ordnerverweise erstellen aktiviert ist. ausgewählt.
   6. Klicken Sie auf Fertig.

2. Ereignisse und Variablen protokollieren

In Tag Manager werden Ereignisse, Parameter und Nutzereigenschaften verwendet, die von der Analytics for Firebase SDK zum Auslösen und Erstellen von Tags, die Sie in den Google Tag Manager

In der Firebase-Entwicklerdokumentation finden Sie eine Anleitung zur Protokollereignisse und Nutzereigenschaften festlegen

Variablen in Tag Manager konfigurieren

Um den Wert von Ereignisparametern und Nutzereigenschaften zur Verwendung in Google zu erfassen In Tag Manager können Sie über die Benutzeroberfläche von Tag Manager 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 Variablen für Ereignisparameter in Tag Manager so konfigurieren: verwendet, 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 eine neue Variable für Firebase-Nutzereigenschaften im Google-Tag konfigurieren. Manager zum Erfassen des favorite_food-Werts:

• 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 Wenn Sie Ereignisse ändern, können Sie ohne App-Updates die Werte von Ereignisparametern zu ändern oder Ereignisnamen anzupassen. Nicht blockierte Ereignisse werden von Google Analytics for Firebase protokolliert SDK.

Das Google Analytics for Firebase SDK protokolliert auch 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

Variablen für Firebase-Ereignisnamen, Variablen für Firebase-Ereignisparameter und andere Variablen werden zum Einrichten von Triggern verwendet. Triggerbedingungen werden ausgewertet wenn Sie ein Firebase-Ereignis protokollieren. Standardmäßig werden in Google Analytics for Firebase automatisch ausgelöst. Es ist möglich, ein Google Analytics for Firebase-Konto -Tag in Tag Manager, um zu verhindern, dass Ereignisse an Google Analytics gesendet werden.

4. Container als Vorschau ansehen, Fehler beheben und Container veröffentlichen

Bevor Sie einen Container veröffentlichen, sollten Sie sich eine Vorschau ansehen, um sicherzustellen, dass es wie gewünscht funktioniert. Mit dem Tag Manager können Sie eine Vorschau Ihrer indem Sie in der Weboberfläche von Tag Manager Links und QR-Codes generieren. damit Ihre Anwendung geöffnet wird.

Vorschaucontainer

Wenn Sie die Vorschau eines Containers ansehen möchten, müssen Sie eine Vorschau-URL in Tag Manager für das Web generieren Schnittstelle:

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 auf Aktionen > Sehen Sie sich eine Vorschau der gewünschten Containerversion an.
5. Geben Sie den Paketnamen Ihrer App ein.

6. Klicken Sie auf Link zum Starten der Vorschau erstellen.

   

   Abbildung 1 : Vorschau-URL aus der über die Weboberfläche von Tag Manager.

   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 definieren in der Property-Liste Ihres Projekts. Wählen Sie unter URL-Typen der Datei Eigenschaftenlistendatei die folgende URL-Kennung und das folgende URL-Schema registrieren:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_

Abbildung 2: Tag Manager-Vorschau-URL-Schema hinzufügen in die Eigenschaftenlistendatei Ihrer Anwendung ein.

Hinweis: your.package.name muss mit dem Namen der App übereinstimmen, die zum Generieren des Vorschau-URL (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 automatisch in ausführliche Benachrichtigungen.

Container veröffentlichen

Nachdem Sie den Container in der Vorschau angesehen haben, können Sie Folgendes tun: veröffentlichen Sie es. Nachdem Sie den Container veröffentlicht haben, für Nutzer der mobilen App verfügbar.

Hinweis: Für mobile Container wird ein Standardcontainer verwendet, um das anfängliche Tag festzulegen. bis ein Container zum ersten Mal heruntergeladen wird. Sobald die App mit dem Internet verbunden und einen Container heruntergeladen haben, Standardcontainers wieder. Anwendungen prüfen regelmäßig Container-Updates. normalerweise alle 12 Stunden.

Weitere Informationen

Weitere Informationen finden Sie unter Erweiterte Konfiguration.