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 erneut 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 zu verwalten und Änderungen daran vorzunehmen, auch nachdem die App bereits versendet wurde.
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, dass Sie Google Analytics in Ihrem Firebase-Projekt aktivieren und Ihrer App das Google Analytics for Firebase SDK hinzufügen.
- Erstellen Sie ein Tag Manager-Konto.
- Konfigurieren Sie einen Google Tag Manager-Container.
In den folgenden Abschnitten erfahren Sie, wie Sie Google Tag Manager konfigurieren und in Ihrer Android-App verwenden.
1. Google Tag Manager zu einem Projekt hinzufügen
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.1.0' }
Wählen Sie einen mobilen Container aus.
Klicken Sie in der oberen Navigationsleiste auf Versionen.
Klicken Sie auf die Containerversion, die Sie verwenden möchten.
Klicken Sie auf Herunterladen.
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 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 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 konfigurieren, um die Werte image_name
und full_text parameter
zu erfassen:
- Variablenname: Bildname
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
image_name
und:
- Variablenname: Volltext
- Variablentyp: Ereignisparameter
- Name des Ereignisparameterschlüssels:
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 favorite_food
-Wert 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. Wenn Sie Ereignisse ändern, können Sie Ereignisparameter hinzufügen, entfernen oder ändern oder Ereignisnamen anpassen, ohne die App zu aktualisieren. Nicht blockierte Ereignisse werden vom Google Analytics for Firebase SDK in Logs erfasst.
Das Google Analytics for Firebase SDK protokolliert außerdem automatisch einige Ereignisse und Nutzereigenschaften. 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
Firebase-Ereignisnamenvariablen, Firebase-Ereignisparametervariablen 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 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 Container veröffentlichen
Bevor Sie eine Version eines Containers veröffentlichen, sollten Sie prüfen, ob er wie vorgesehen funktioniert. Mit Google Tag Manager können Sie sich eine Vorschau der Versionen Ihres Containers anzeigen lassen. Generieren Sie dazu Links und QR-Codes in der Weboberfläche und öffnen Sie damit Ihre Anwendung. Sie können auch den Modus für die ausführliche Protokollierung aktivieren, um unerwartetes Verhalten zu beheben.
Vorschau des Containers anzeigen
Generieren Sie vor der Vorschau eines Containers auf der Weboberfläche von Google Tag Manager eine Vorschau-URL. Wählen Sie dazu die Version des Containers aus, für die Sie eine Vorschau sehen möchten, und klicken Sie dann auf Vorschau. Speichern Sie diese Vorschau-URL für spätere Schritte.
![Vorschau-URLs sind im Vorschaufenster der Weboberfläche von Tag Manager verfügbar](https://developers.google.cn/static/tag-platform/tag-manager/images/preview_example.png?authuser=1&hl=de)
So sehen Sie sich eine Vorschau des Containers an (wenn Sie Android Studio verwenden, fahren Sie mit Schritt 3 fort):
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>
Ändern Sie diese Zeile so, dass sie den Paketnamen Ihrer Anwendung enthält:
<data android:scheme="tagmanager.c.com.example.app"/>
Generieren Sie auf der Weboberfläche von Google Tag Manager einen Vorschaulink:
- Melden Sie sich in Ihrem Tag Manager-Konto an.
- Wählen Sie einen mobilen Container aus.
- Klicken Sie in der oberen Navigationsleiste auf Versionen.
- Klicken Sie bei der Containerversion, die Sie als Vorschau ansehen möchten, auf Aktionen > Vorschau.
- Geben Sie den Paketnamen Ihrer App ein.
- Klicken Sie auf Link zum Starten der Vorschau erstellen.
Beenden Sie die Anwendung und starten Sie sie über den generierten Vorschaulink oder QR-Code.
Sie können den Vorschaumodus beenden, indem Sie in der Weboberfläche auf einen Link klicken, der mit der Option Vorschaulink erstellen generiert wurde.
Fehler beim Container beheben
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 den Container in der Vorschau angesehen und geprü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 mobiler Apps verfügbar.
Nächste Schritte
Weitere Informationen finden Sie unter Erweiterte Konfiguration.