Google Tag Manager für Android

Als Entwickler können Sie mit Google Tag Manager Analyse-Tags und ‑Pixel in Ihren mobilen Anwendungen implementieren und verwalten, ohne die Binärdateien der Anwendung neu erstellen und noch einmal bei App-Marktplätzen einreichen zu müssen. Entwickler, die mit dem Google Analytics for Firebase SDK arbeiten, können Tag Manager ganz einfach hinzufügen, um die Implementierung zu verwalten und Änderungen daran vorzunehmen, auch nachdem die App veröffentlicht wurde.

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

Vorbereitung

Bevor Sie beginnen:

In den folgenden Abschnitten werden die Schritte zum Konfigurieren und Verwenden von Google Tag Manager in Ihrer Android-App beschrieben.

1. Google Tag Manager zu Ihrem Projekt hinzufügen

  1. Fügen Sie 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.3.0'
}

  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 gewünschte Containerversion.

  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 Ereignisse, Parameter und Nutzereigenschaften verwendet, die vom Google Analytics for Firebase SDK protokolliert werden, um Tags auszulösen und zu erstellen, die Sie in Google Tag Manager konfiguriert haben.

In der Firebase-Entwicklerdokumentation finden Sie Anleitungen zum Protokollieren von Ereignissen und zum Festlegen von Nutzereigenschaften.

Variablen in Tag Manager konfigurieren

Wenn Sie den Wert von Ereignisparametern und Nutzereigenschaften für die Verwendung in Google Tag Manager erfassen möchten, können Sie in der Tag Manager-Oberfläche Variablen konfigurieren.

Sie könnten beispielsweise das folgende benutzerdefinierte Ereignis in Ihrer App erfassen:

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: Image-Name
  • Variablentyp: Ereignisparameter
  • Schlüsselname des Ereignisparameters: image_name

und:

  • Variablenname: Volltext
  • Variablentyp: Ereignisparameter
  • Schlüsselname des Ereignisparameters: full_text

In Ihrer App können Sie die folgende Nutzereigenschaft 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
  • 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. Wenn Sie Ereignisse ändern, können Sie die Werte von Ereignisparametern hinzufügen, entfernen oder ändern oder Ereignisnamen anpassen, ohne App-Updates durchzuführen. 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 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 geprüft, 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. Vorschau, Fehlerbehebung und Veröffentlichung des Containers

Bevor Sie eine Version Ihres Containers veröffentlichen, sollten Sie sie in der Vorschau ansehen, um sicherzustellen, dass sie wie gewünscht funktioniert. In Google Tag Manager können Sie sich eine Vorschau der Versionen Ihres Containers ansehen. Dazu generieren Sie in der Weboberfläche Links und QR-Codes und öffnen damit Ihre Anwendung. Sie können auch einen ausführlichen Logging-Modus aktivieren, um unerwartetes Verhalten zu beheben.

Vorschaucontainer

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

Vorschau-URLs sind im Vorschaufenster der Tag Manager-Weboberfläche verfügbar.
Abbildung 1: Vorschau-URL über die Tag Manager-Weboberfläche abrufen

So rufen Sie eine Vorschau Ihres Containers auf (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 bei der Containerversion, die Sie sich ansehen möchten, auf Aktionen > Vorschau.
    5. Geben Sie den Paketnamen Ihrer App ein.
    6. Klicken Sie auf Link für Vorschau generieren.

  4. Beenden Sie Ihre Anwendung und verwenden Sie den generierten Vorschaulink oder QR-Code, um Ihre Anwendung zu starten.

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

Container debuggen

Aktivieren Sie das ausführliche Logging, um Probleme mit Ihrer Containerimplementierung zu beheben:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Container veröffentlichen

Nachdem Sie sich Ihren Container in der Vorschau angesehen und überprüft haben, ob er funktioniert, können Sie ihn veröffentlichen. Nachdem Sie Ihren Container veröffentlicht haben, sind Ihre Tag-Konfigurationen für Nutzer der mobilen App verfügbar.

Nächste Schritte

Lesen Sie den Abschnitt Erweiterte Konfiguration.