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 die Binärdateien der Anwendung 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 und so die Implementierung verwalten und Änderungen vornehmen.

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

Voraussetzungen

Hinweise:

• 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.
• Google Tag Manager-Container konfigurieren

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 von der Tag Manager-Bibliothek hinzu:

   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 in der ausgewählten 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 vom Google Analytics for Firebase SDK protokolliert werden, zum Auslösen und Erstellen von Tags verwendet, die Sie in Google Tag Manager konfiguriert haben.

In der Firebase-Entwicklerdokumentation finden Sie eine Anleitung dazu, wie Sie Ereignisse protokollieren und Nutzereigenschaften festlegen.

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 in 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 in Tag Manager neue Variablen für Ereignisparameter 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 eine neue Firebase-Nutzereigenschaftsvariable in Google Tag Manager konfigurieren, um den favorite_food-Wert zu erfassen:

• Variablenname: 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.

Das Google Analytics for Firebase SDK protokolliert auch einige Ereignisse und Nutzereigenschaften automatisch. 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, Firebase-Ereignisparameter und andere Variablen werden zum Einrichten von Triggern verwendet. 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 ein Google Analytics for Firebase-Tag in Tag Manager 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 davon ansehen, um sicherzustellen, dass er wie vorgesehen funktioniert. Mit Google Tag Manager können Sie Versionen Ihres Containers ansehen, indem Sie in der Weboberfläche Links und QR-Codes generieren und zum Öffnen der Anwendung verwenden. Sie können auch einen ausführlichen Logging-Modus aktivieren, um unerwartete Fehler zu beheben.

Vorschau des Containers anzeigen

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

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

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 Anwendung 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 in der Containerversion, die Sie als Vorschau ansehen 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 ü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 mit der Option Ende der Vorschau generieren generiert wurde.

Debug-Container

Aktivieren Sie die ausführliche Protokollierung, um Fehler bei der Containerimplementierung zu beheben:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Container veröffentlichen

Nachdem Sie die Vorschau des Containers aufgerufen und seine Funktion überprüft haben, können Sie ihn veröffentlichen. Nachdem Sie den Container veröffentlicht haben, sind die Tag-Konfigurationen für Nutzer der mobilen App verfügbar.

Hinweis: Bei mobilen Containern wird ein Standardcontainer verwendet, um Erstkonfigurationen von Tags festzulegen, bis erstmals ein Container heruntergeladen wird. Sobald die Anwendung eine Internetverbindung hergestellt und einen Container heruntergeladen hat, wird der Standardcontainer nicht mehr verwendet. Anwendungen suchen in regelmäßigen Abständen (normalerweise alle zwölf Stunden) nach Containerupdates.

Nächste Schritte

Weitere Informationen finden Sie unter Erweiterte Konfiguration.