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 ganz einfach Tag Manager hinzufügen, um die Implementierung zu verwalten und Änderungen an der Implementierung 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
Vorbereitung:
- 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 erfahren Sie, wie Sie Google Tag Manager in Ihrer Android-App konfigurieren und verwenden.
1. Google Tag Manager zum Projekt hinzufügen
Füge in der Gradle-Datei des 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.0.4' }
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 vom Google Analytics for Firebase SDK erfasste Ereignisse, Parameter und Nutzereigenschaften verwendet, um in Google Tag Manager konfigurierte Tags auszulösen und zu erstellen.
In der Firebase-Entwicklerdokumentation finden Sie eine Anleitung zum Protokollieren von Ereignissen und zum Festlegen von Nutzereigenschaften.
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 Benutzeroberfläche von Tag Manager 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
Ebenso 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 Variable für Firebase-Nutzereigenschaften 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.
Über das Google Analytics for Firebase SDK werden außerdem einige Ereignisse und Nutzereigenschaften automatisch protokolliert. 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
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 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 in der Vorschau ansehen, Fehler beheben und veröffentlichen
Bevor Sie eine Version Ihres Containers veröffentlichen, sollten Sie sich eine Vorschau ansehen, um zu prüfen, ob er wie vorgesehen funktioniert. Mit Google Tag Manager haben Sie die Möglichkeit, eine Vorschau der Containerversionen anzuzeigen. Dazu werden in der Weboberfläche Links und QR-Codes generiert und zum Öffnen Ihrer App verwendet. Sie können auch einen Modus für ausführliches Logging aktivieren, um unerwartetes Verhalten zu beheben.
Vorschaucontainer
Bevor Sie sich einen Container in der Vorschau ansehen, generieren Sie eine Vorschau-URL in der Weboberfläche von Google Tag Manager. Wählen Sie dazu die Version des Containers aus, für den Sie sich die Vorschau ansehen möchten, und dann auf Vorschau. Speichern Sie diese Vorschau-URL für später.
So rufen Sie eine Vorschau des Containers auf (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, sodass sie den Paketnamen Ihrer Anwendung enthält:
<data android:scheme="tagmanager.c.com.example.app"/>
Erstellen 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 in der 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 Ihre 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 Link zum Ende der Vorschau generieren generiert wurde.
Fehlerbehebung für Container
Aktivieren Sie das ausführliche Logging, um Fehler in der Containerimplementierung zu beheben:
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
Container veröffentlichen
Nachdem Sie den Container in der Vorschau angezeigt und überprüft haben, ob er funktioniert, können Sie ihn veröffentlichen. Nachdem Sie den Container veröffentlicht haben, sind die Tag-Konfigurationen für Nutzer mobiler Apps verfügbar.
Nächste Schritte
Weitere Informationen finden Sie unter Erweiterte Konfiguration.