Geschrieben von

Android mit Google Tag Manager und Google Analytics 4

Webtracking

In diesem Beitrag geht es darum, wie man auf Android den Google Tag Manager und Google Analytics 4 einbindet. Dazu werde ich mit Android Studio eine einfache Android-App erstellen. In die App wird die Firebase SDK inkl. Google Analytics eingebunden. Danach wird noch GTM installiert. Ziel ist es zu demonstrieren, wie eine Android-Einbindung funktioniert. Folgende Schritte sind notwendig:

App mit Android Studio erstellen

Unter https://developer.android.com/studio muss zunächst Android Studio heruntergeladen, installiert und gestartet werden. Dann wird ein neues Projekt angelegt:

Danach wählen wir eine leere Vorlage:

Im Anschluss kannst du einen beliebigen Namen vergeben. Den Package-Namen werden wir später brauchen, diesen kannst du dir hier notieren. Klicke auf “Finish” und warte bis Android die App erstellt hat:

Wenn alles fertig und erfolgreich ist, dann siehst du den Verzeichnisbaum mit allen Dateien:

Als nächstes kannst du dein Android-Smartphone an den Laptop anschließen und oben auf die Liste links vom grünen Play-Button klicken und dein Smartphone anschließend aus der Liste auswählen. Dadurch kannst du die Test-App auf deinem Smartphone ausführen. Wenn du kein Android-Handy hast, auch kein Problem. Wechsle dazu zunächst in den AVD Manager:

Mit einem Klick auf “Create New Virtual Device” können wir ein virtuelles Gerät erstellen:

Wähle ein Gerät aus:

Und dann eine System-Datei (ggf. muss du sie vorher herunterladen):

Wähle einen Namen und klicke auf “Finish”:

Im Anschluss siehst du dann das soeben konfigurierte virtuelle Gerät in der Liste, welches du auswählen kannst:

Wenn du es startest (Klick auf grünen Play-Button ganz rechts in der Liste), dann öffnet sich das Smartphone:

Firebase Projekt erstellen und Firebase SDK in App initialisieren

Nun erstellen wir unter https://console.firebase.google.com/ ein Firebase-Projekt:

Vergebe einen Namen und notiere dir die Projekt-ID:

Aktiviere im nächsten Schritt Google Analytics für das Projekt:

Dann ein bestehendes Google Analytics-Konto wählen oder ein neues erstellen:

Dann musst du kurz warten bis dein Projekt erstellt wurde:

Danach klickst du auf “Weiter”:

Dann muss Firebase unserem Android-Projekt hinzugefügt werden. Klicke dabei zunächst auf:

Im ersten Feld musst den anfangs erwähnten Android-Package-Namen eingeben. Falls du den nicht notiert hast, dann findest du den Namen auch unter:

Vergebe dann noch einen Namen und klicke auf “App registrieren”:

Dann die json-Datei herunterladen:

In Android Studio hierüber zu “Projekte” navigieren:

Im Anschluss öffnest du den Projekt-Ordner und dann den Ordner “app”. Hier rein ziehst du dann die json-Datei rein:

Dann wieder zurück zu Firebase und auf “Weiter” klicken. In diesem Schritt erklärt dir Google, wie du die Firebase SDK mit allen Abhängigkeiten hinzufügen kannst. Öffne dazu in deinem Android-Studio-Projekt die Datei “build.gradle”:

Innerhalb des dependencies-Blocks muss nun folgender Code hinzugefügt werden:

dependencies {
...
classpath 'com.google.gms:google-services:4.3.8'
}

Nach dem Speichern der Datei gehst du hierhin:

Hier müssen innerhalb des dependencies-Blocks nun folgende Zeilen hinzugefügt werden:

dependencies {
...
implementation platform('com.google.firebase:firebase-bom:28.1.0')
implementation 'com.google.firebase:firebase-analytics-ktx'
implementation 'com.google.android.gms:play-services-tagmanager:17.0.0'
}

Und es kommt folgende Zeile hinzu:

apply plugin: 'com.google.gms.google-services'

Nun alles speichern. Klicke dann auf “Sync now”, damit alles heruntergeladen und installiert wird:

Wenn alles fertig installiert wurde, musst du die App starten (Klick auf grünen Play-Button):

Beim Start der App feuert auch Firebase ein erstes Event. Gehe nun zurück zur Firebase-Website, klicke auf “Weiter” und dann beim letzten Formular-Schritt auf “Weiter zur Konsole”. Innerhalb des Firebase-Projekts gehst du links unter “Analytics” auf “Realtime”. Hier sollte das soeben gefeuerte erste Event zu sehen sein:

Durch den Datenstream zu GA4 sehen wir auch, dass das Event in GA4 ankommt:

Event zu Google Analytics 4 schicken

Events werden über die Abhängigkeit von “implementation ‘com.google.firebase:firebase-analytics:17.0.1′” gefeuert. Diese haben wir vorhin implementiert und gesehen, dass beim Öffnen der App ein paar Standard-Events verschickt werden (first_open, screen_view, session_start). Jetzt wollen wir aber ein eigenes Event mitschicken. Dazu gehen wir in die Datei “MainActivity.kt” unter “/app/src/main/java/_project_/”.

Bei der MainActivity.kt-Datei es sich um Code, der ausgeführt wird, sobald die App geöffnet wird. Hier wollen wir uns dranhängen und ein Event feuern. Dazu muss zunächst folgender Code innerhalb von “class MainActivity” gesetzt werden:

private lateinit var firebaseAnalytics: FirebaseAnalytics

Nach dem Kopieren des Codes erscheint ganz links ein Tooltip-Zeichen. Hier ist es wichtig, dass du “Enter” drückst, damit das import-Kommando von Android Studio ausgeführt wird.

Falls es mit dem Enter nicht klappt und du wie bei meinem Screenshot im Code-Editor oben rechts eine Fehlermeldung kommt, dann musst du den Import manuell durchführen. Füge dazu folgenden Code hier ein:

Als nächstes müssen wir:

  • Die firebaseAnalytics-Variable innerhalb der onCreate-Methode initialisieren.
  • Die logEvent()-Methode aufrufen, damit das Event an Firebase geschickt wird. Diese Methode nimmt 2 Parameter entgegen: Den Event-Namen und zusätzliche Event-Parameter. Wir werden das Event “select_content” schicken, sobald die App geöffnet wird.

Dazu sollte folgender Code innerhalb der onCreate-Methode platziert werden:

firebaseAnalytics = FirebaseAnalytics.getInstance(this)
val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, "my_item_id")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)

Im Code-Editor sieht das wie folgt aus:

Wenn du nun die App wieder startest, dann wirst du sehen, wie das soeben konfigurierte Event “select_content” beim App-Start gefeuert wird:

Und auch in GA4 sehen wir unser Event:

Google Tag Manager installieren

Zum Schluss installieren wir noch GTM und senden ein Event an eine Mobile-App-UA-Datenansicht. Die Datenansicht muss zunächst innerhalb UA erstellt werden:

Dann erstellen wir den entsprechenden GTM-Container:

Dann erstellen wir unser Tag:

Die Event-Aktion besitzt folgende Variable:

Als Trigger wählen wir:

Dann alles speichern und den Container “Senden”. Nach der Veröffentlichung des Containers bekommen wir die JSON-Container-Datei, die nun in unsere App eingebunden werden muss. Gehe dazu zurück in Android Studio. Im linken Projekt-Navigationsbaum: Klick den Main-Ordner an unter /app/src/main/. Dann erstelle einen neuen Ordner wie folgt:

Benenne den Ordner als “assets”. Dann klicke den assets-Ordner an und erstelle wieder einen neuen Ordner namens “containers”. Du hast dann also:

Schiebe dann die json-Datei des Google Tag Manager-Containers in den containers-Ordner:

Wenn wir jetzt unsere App wieder starten, sollte das soeben konfigurierte Event über dem GTM in den Live-Bericht der erstellten Datenansicth einfließen: