Google Tag Manager für Android

Als Entwickler können Sie Google Tag Manager verwenden, um Mess-Tags und ‑Pixel in Ihren mobilen Apps zu implementieren und zu verwalten, ohne App-Binärdateien neu erstellen und an App-Marktplätze senden zu müssen. Entwickler, die mit dem Google Analytics for Firebase SDK arbeiten, können Tag Manager ganz einfach hinzufügen, um die Implementierung zu verwalten und Änderungen daran vorzunehmen, auch nachdem die App veröffentlicht wurde.

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 ein für Ihre App, einschließlich der Aktivierung von Google Analytics in Ihrem Firebase-Projekt und des Hinzufügens des Google Analytics for Firebase SDK zu Ihrer App.
• Erstellen Sie ein Tag Manager-Konto.
• Konfigurieren Sie einen Google Tag Manager-Container.

In den folgenden Abschnitten werden die Schritte zum Konfigurieren und Verwenden von Google Tag Manager in Ihrer Android-App beschrieben.

1. Google Tag Manager Ihrem Projekt hinzufügen

1. Fügen Sie in der Gradle-Datei Ihres 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

Tag Manager verwendet Ereignisse, Parameter und Nutzereigenschaften, die vom Google Analytics for Firebase SDK protokolliert werden, 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 für die Verwendung in Google Tag Manager erfassen möchten, können Sie Variablen konfigurieren in der Tag Manager-Benutzeroberfläche.

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

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 Variablen für Ereignisparameter konfigurieren, um die Werte für image_name und full_text parameter zu erfassen:

• Variablenname: Image Name
• Variablentyp: Ereignisparameter
• Schlüsselname des Ereignisparameters: image_name

und:

• Variablenname: Full 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: Favorite Food
• Variablentyp: Firebase-Nutzereigenschaft
• Schlüsselname des Ereignisparameters: 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 anpassen, ohne die App aktualisieren zu müssen. Ereignisse, die nicht blockiert werden, werden vom Google Analytics for Firebase SDK protokolliert.

Das Google Analytics for Firebase SDK protokolliert auch automatisch einige Ereignisse und Nutzereigenschaften. Sie können automatisch erfasste Ereignisse und Eigenschaften 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 verwendet, um Trigger einzurichten. Triggerbedingungen werden immer dann geprüft, 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 in der Vorschau ansehen, Fehler beheben und veröffentlichen

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

Container in der Vorschau ansehen

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

So sehen Sie sich eine Vorschau Ihres Containers an (wenn Sie Android Studio verwenden, fahren Sie mit Schritt 3 fort):

1. Fügen Sie Ihrer AndroidManifest-Datei 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. Ändern Sie diese Zeile so, dass sie den Paketnamen Ihrer App enthält:

   <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, die Sie in der Vorschau ansehen möchten, auf Aktionen > Vorschau.
   5. Geben Sie den Paketnamen Ihrer App ein.
   6. Klicken Sie auf Vorschaulink generieren.

4. Beenden Sie Ihre App und starten Sie sie mit dem generierten Vorschaulink oder QR-Code.

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

Fehler im Container beheben

Wenn Sie Fehler bei der Containerimplementierung beheben möchten, aktivieren Sie das ausführliche Logging:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Container veröffentlichen

Nachdem Sie sich eine Vorschau Ihres Containers angesehen und geprü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 mobiler Apps verfügbar.

Nächste Schritte

Erweiterte Konfiguration lesen.