Google Tag Manager für Android

Als Entwickler können Sie mit Google Tag Manager Analyse-Tags und ‑Pixel in Ihren mobilen Apps implementieren und verwalten, ohne dass Sie App-Binärdateien neu erstellen und an App-Marktplätze senden 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 nach der Veröffentlichung der App.

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

Vorbereitung

Bevor Sie beginnen:

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

In den folgenden Abschnitten erfahren Sie, wie Sie Google Tag Manager in Ihrer Android-Anwendung konfigurieren und verwenden.

1. Google Tag Manager Ihrem Projekt hinzufügen

1. Fügen Sie in der Gradle-Datei des Moduls (in der Regel app/build.gradle) die folgende Abhängigkeit von der Tag Manager-Bibliothek hinzu:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. Melden Sie sich in Ihrem Tag Manager-Konto an.

3. Wählen Sie einen mobilen Container aus.

4. Klicken Sie in der oberen Navigationsleiste auf Versionen.

5. Klicken Sie auf die Containerversion, die Sie verwenden möchten.

6. Klicken Sie auf Herunterladen.

7. Erstellen Sie den Ordner app/src/main/assets/containers, falls er noch nicht vorhanden ist. Kopieren Sie den heruntergeladenen Container in den Ordner.

2. Ereignisse und Variablen protokollieren

In Tag Manager werden Ereignisse, Parameter und Nutzereigenschaften verwendet, die vom Google Analytics for Firebase SDK protokolliert wurden, um in Google Tag Manager konfigurierte Tags auszulösen und zu erstellen.

In der Firebase-Entwicklerdokumentation finden Sie eine Anleitung zum Erfassen von Ereignissen und zum Festlegen von Nutzereigenschaften.

Variablen in Tag Manager konfigurieren

Wenn Sie den Wert von Ereignisparametern und Nutzereigenschaften für die Verwendung in Google Tag Manager erfassen möchten, können Sie in der Tag Manager-Benutzeroberfläche Variablen konfigurieren.

Sie können beispielsweise das folgende benutzerdefinierte Ereignis in Ihrer App erfassen:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Anschließend können Sie in Tag Manager neue Ereignisparametervariablen so konfigurieren, dass die Werte image_name und full_text parameter erfasst werden:

• Variablenname: Bildname
• Variablentyp: Ereignisparameter
• Schlüsselname des Ereignisparameters: image_name

und:

• Variablenname: Vollständiger Text
• Variablentyp: Ereignisparameter
• Schlüsselname des Ereignisparameters: full_text

Ebenso können Sie die folgende Nutzereigenschaft in Ihrer App festlegen:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Anschließend können Sie in Google Tag Manager eine neue Variable für Firebase-Nutzereigenschaften konfigurieren, um den Wert für favorite_food zu erfassen:

• Variablenname: Lieblingsessen
• Variablentyp: Firebase-Nutzereigenschaft
• Schlüsselname des Ereignisparameters: favorite_food

Ereignisse ändern und blockieren

In 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 Werte von Ereignisparametern hinzufügen, entfernen oder ändern oder Ereignisnamen anpassen, ohne die App aktualisieren zu müssen. Nicht blockierte Ereignisse werden vom Google Analytics for Firebase SDK protokolliert.

Außerdem werden mit dem Google Analytics for Firebase SDK einige Ereignisse und Nutzereigenschaften automatisch protokolliert. 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

Mit Firebase-Variablen für Ereignisnamen, Firebase-Variablen für Ereignisparameter und anderen Variablen werden Trigger eingerichtet. Triggerbedingungen werden immer dann geprüft, wenn Sie ein Firebase-Ereignis protokollieren. Google Analytics for Firebase-Ereignisse werden standardmäßig 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 in der Vorschau ansehen, beheben und veröffentlichen

Bevor Sie eine Version Ihres Containers veröffentlichen, sollten Sie sich eine Vorschau ansehen, um sicherzustellen, dass sie wie vorgesehen funktioniert. In Google Tag Manager können Sie sich eine Vorschauversion Ihres Containers ansehen, indem Sie in der Weboberfläche Links und QR-Codes generieren und damit Ihre Anwendung öffnen. Sie können auch einen ausführlichen Logging-Modus aktivieren, um unerwartetes Verhalten zu beheben.

Vorschaucontainer

Bevor Sie sich eine Vorschau eines Containers ansehen, müssen Sie in der Google Tag Manager-Weboberfläche eine Vorschau-URL generieren. Wählen Sie dazu die Version des Containers aus, für die Sie eine Vorschau anzeigen möchten, und dann Vorschau. Speichern Sie diese Vorschau-URL für spätere Schritte.

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

So rufen Sie eine Vorschau Ihres Containers auf (wenn Sie Android Studio verwenden, fahren Sie mit Schritt 3 fort):

1. Fügen Sie der Datei AndroidManifest diese Vorschauaktivität hinzu:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Fügen Sie dieser Zeile den Paketnamen Ihrer Anwendung hinzu:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. Generieren Sie in der Google Tag Manager-Weboberfläche einen Vorschaulink:

   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, für die Sie eine Vorschau anzeigen möchten, auf Aktionen > Vorschau.
   5. Geben Sie den Paketnamen Ihrer Anwendung ein.
   6. Klicken Sie auf Link zum Starten der Vorschau generieren.

4. Beenden Sie die Anwendung und verwenden Sie den generierten Link oder QR-Code für die Vorschau, um die Anwendung zu starten.

5. Sie können den Vorschaumodus beenden, indem Sie auf einen Link klicken, der über die Option Link zum Beenden der Vorschau generieren in der Weboberfläche generiert wurde.

Container debuggen

Aktivieren Sie die ausführliche Protokollierung, um Probleme mit der Containerimplementierung zu beheben:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Container veröffentlichen

Nachdem Sie sich eine Vorschau des Containers angesehen und überprüft haben, ob er funktioniert, können Sie ihn veröffentlichen. Nachdem Sie Ihren Container veröffentlicht haben, sind Ihre Tag-Konfigurationen für Nutzer der mobilen App verfügbar.

Hinweis :Bei mobilen Containern wird ein Standardcontainer verwendet, um die ersten Tag-Konfigurationen festzulegen, bis ein Container zum ersten Mal heruntergeladen wird. Sobald die App eine Verbindung zum Internet hergestellt und einen Container heruntergeladen hat, wird der Standardcontainer nie wieder verwendet. Anwendungen suchen regelmäßig nach Containerupdates, in der Regel alle 12 Stunden.

Nächste Schritte

Lesen Sie den Hilfeartikel Erweiterte Konfiguration.