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ärprogramme neu erstellen und an App-Marktplätze senden zu müssen. Entwickler, die mit dem Google Analytics for Firebase SDK arbeiten, können ganz einfach Tag Manager hinzufügen. Damit lassen sich Implementierungen leichter verwalten und Änderungen vornehmen, auch nachdem die App versendet wurde.

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

Voraussetzungen

Bevor du beginnst:

• Fügen Sie die App in der Firebase Console Ihrem Firebase-Projekt hinzu.
• Richten Sie Google Analytics für Ihre App ein, einschließlich der Aktivierung von Google Analytics in Ihrem Firebase-Projekt und dem Hinzufügen 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 wird beschrieben, wie Sie Google Tag Manager in Ihrer Android-App konfigurieren und verwenden.

1. Google Tag Manager zu Ihrem Projekt hinzufügen

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

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

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 für die ausgewählte Containerversion auf Aktionen > Herunterladen.

   

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

2. Protokollereignisse und Variablen

In Tag Manager werden Ereignisse, Parameter und Nutzereigenschaften, die mit dem Google Analytics for Firebase SDK protokolliert werden, zum Auslösen und Erstellen von Tags verwendet, die Sie in Google Tag Manager konfiguriert haben.

Eine Anleitung zum Aufzeichnen 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 Variablen in der Tag Manager-Oberfläche konfigurieren.

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 Ereignisparameter-Variablen 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: Volltext
• Variablentyp: Ereignisparameter
• Schlüsselname des Ereignisparameters: full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

• Variable Name: Lieblingsessen
• 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 ohne App-Updates anpassen. Nicht blockierte Ereignisse werden vom Google Analytics for Firebase SDK protokolliert.

Mit dem Google Analytics for Firebase SDK werden auch einige Ereignisse und Nutzereigenschaften automatisch protokolliert. Sie können in Google Tag Manager automatisch erfasste Ereignisse und Eigenschaften verwenden, ohne Code hinzufügen zu müssen. Sie können sie jedoch nicht blockieren.

3. Ereignisse senden

Mit Variablen für Firebase-Ereignisnamen, Firebase-Ereignisparameter und anderen Variablen können Sie Trigger einrichten. 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 einfü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 eine Vorschau aufrufen, um sicherzustellen, dass sie wie vorgesehen funktioniert. Mit Google Tag Manager können Sie Versionen Ihres Containers in der Vorschau ansehen, indem Sie Links und QR-Codes auf der Weboberfläche generieren und zum Öffnen der Anwendung verwenden. Sie können auch den ausführlichen Logging-Modus aktivieren, um unerwartetes Verhalten zu beheben.

Container als Vorschau ansehen

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

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

Wenn Sie eine Vorschau Ihres Containers sehen (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. Ändern Sie diese Zeile so, dass der Paketname Ihrer Anwendung enthalten ist:

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

3. Generieren Sie auf der Weboberfläche von Google Tag Manager 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 für die Containerversion, für die Sie eine Vorschau aufrufen möchten, auf Aktionen > Vorschau.
   5. Geben Sie den Paketnamen Ihrer Anwendung ein.
   6. Klicken Sie auf Link zum Erstellen der Vorschau erstellen.

4. Beenden Sie die Anwendung und starten Sie sie mit dem generierten Vorschaulink oder QR-Code.

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

Debug-Container

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Container veröffentlichen

Wenn Sie sich die Vorschau des Containers angesehen und überprü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 der mobilen App verfügbar.

Hinweis: Bei mobilen Containern wird ein Standardcontainer verwendet, um erste Tag-Konfigurationen festzulegen, bis der Container zum ersten Mal heruntergeladen wird. Sobald die Anwendung mit dem Internet verbunden und einen Container heruntergeladen wurde, wird der Standardcontainer nie wieder verwendet. Die Anwendungen suchen regelmäßig nach Containerupdates, in der Regel alle 12 Stunden.

Nächste Schritte

Lesen Sie den Artikel Erweiterte Konfiguration.