Google Tag Manager für Android

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

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. Dazu gehört auch, Google Analytics in Ihrem Firebase-Projekt zu aktivieren und Ihrer App das Google Analytics for Firebase SDK hinzuzufügen.
• 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 zum Projekt hinzufügen

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

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

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 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:

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

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:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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 Google Tag Manager können Sie eine Vorschau der Versionen Ihres Containers anzeigen, indem Sie Links und QR-Codes in der Weboberfläche generieren und zum Öffnen Ihrer Anwendung verwenden. Sie können auch den ausführlichen Logging-Modus aktivieren, um unerwartetes Verhalten zu beheben.

Vorschaucontainer

Bevor Sie sich einen Container als Vorschau ansehen, generieren Sie auf der Weboberfläche von Google Tag Manager eine Vorschau-URL. Wählen Sie dazu die Version des Containers und dann Vorschau aus. Speichern Sie diese Vorschau-URL für spätere Schritte.

Abbildung 1 : Vorschau-URL auf der Tag Manager-Weboberfläche abrufen

So rufen Sie eine Vorschau des 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. Ändern Sie diese Zeile so, dass sie den Paketnamen Ihrer App enthält:

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

3. Erstellen Sie auf der Weboberfläche des Google Tag Managers 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 Link zum Starten der Vorschau erstellen.

4. Beenden Sie Ihre Anwendung und starten Sie sie über den generierten Vorschaulink oder QR-Code.

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

Fehlerbehebungscontainer

Aktivieren Sie das ausführliche Logging, um Fehler an der Containerimplementierung zu beheben:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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.

Hinweis: Für mobile Container wird ein Standardcontainer verwendet, um anfängliche Tag-Konfigurationen festzulegen, bis zum ersten Mal ein Container heruntergeladen wird. Sobald die Anwendung eine Verbindung zum Internet hergestellt und einen Container heruntergeladen hat, wird der Standardcontainer nicht mehr verwendet. Anwendungen prüfen in regelmäßigen Abständen, ob Containerupdates verfügbar sind, in der Regel alle zwölf Stunden.

Nächste Schritte

Weitere Informationen finden Sie unter Erweiterte Konfiguration.