1. Einführung
Zuletzt aktualisiert:14.12.2020
Inhalt
In diesem Codelab erfahren Sie, wie Sie Ereignisse mit Google Analytics for Firebase(GA4F) implementieren und Aktionskampagnen über Google Ads starten.
In diesem Codelab erfahren Sie, wie Sie Ereignisse mit GA4F implementieren und in Google Ads importieren. Wie Sie eine Android-App mit Firebase erstellen, erfahren Sie im Artikel Firebase-Android-Codelab – Einfache Chat-Erstellung.
Aufgaben in diesem Lab
- Firebase-Projekt erstellen
- Firebase SDK in einer Android-App implementieren
- Ereignisse und Parameter erstellen
- Ereignisse aus Firebase in Google Ads importieren
- Google Ads-Aktionskampagnen mit benutzerdefinierten Ereignissen starten
Voraussetzungen
- Android Studio 3.6 oder höher
- Firebase-Konto
- Google Ads-Konto
2. Firebase-Projekt erstellen und einrichten
Um Firebase zu nutzen, müssen Sie zuerst ein Firebase-Projekt erstellen und einrichten.
Firebase-Projekt erstellen
Klicken Sie in der Firebase Console auf Projekt hinzufügen oder Projekt erstellen und geben Sie Ihrem Firebase-Projekt einen gewünschten Namen.
- Klicken Sie sich durch die Optionen zur Projekterstellung. Akzeptieren Sie die Firebase-Nutzungsbedingungen, wenn Sie dazu aufgefordert werden. Sie sollten Google Analytics für dieses Projekt aktivieren, da Sie Google Analytics-Ereignisse zum Erfassen von Aktionsereignissen und Conversions benötigen.
Weitere Informationen zu Firebase-Projekten
- Wählen Sie „Google Analytics-Konto“ aus. Wenn Sie ein Konto haben, wählen Sie dieses aus oder erstellen Sie einen neuen. Klicken Sie auf die Schaltfläche „Projekt erstellen“.
- Der Firebase-Projekt-Build ist jetzt abgeschlossen.
Im nächsten Schritt erfahren Sie, wie Sie Firebase zu Ihrer Android-App hinzufügen.
3. Firebase zu meiner Android-App hinzufügen
App registrieren
- Wählen Sie in der Firebase Console im linken Navigationsbereich Projektübersicht aus und klicken Sie dann unter "Jetzt Firebase zu Ihrer App hinzufügen" auf die Android-Schaltfläche.
- Geben Sie die erforderlichen Informationen ein.
Als Android-Paketnamen rufen Sie in Android Studio das App-Verzeichnis auf und öffnen die Datei build.gradle
. Suchen Sie in der Datei nach applicationId
. Dieser Wert ist der Name des Android-Pakets. Kopieren Sie diesen Wert und fügen Sie ihn ein.
Der SHA-1-Schlüssel wird hier nicht benötigt, es sei denn, Sie möchten Google Log-in oder Firebase Dynamic Links verwenden. Diese Tools sind nicht Teil dieses Codelab. Weitere Informationen zum SHA-1-Schlüssel finden Sie in diesem Dokument.
- Klicken Sie auf die Schaltfläche App registrieren.
Konfigurationsdatei herunterladen
- Klicken Sie auf die Schaltfläche „google-services.json herunterladen“, um die Konfigurationsdatei
google-services.json
herunterzuladen.
- Gehen Sie in Android Studio zum Verzeichnis
app
und verschieben Sie die Dateigoogle-services.json
, die Sie gerade heruntergeladen haben, in das Verzeichnisapp
. Kehren Sie zur Firebase Console zurück und klicken Sie auf die Schaltfläche „Weiter“.
Firebase in Ihrer App aktivieren
- Sie benötigen das Gradle-Plug-in für Google-Dienste, um die von Firebase generierte Datei
google-services.json
zu lesen. - Öffnen Sie
<project>/build.gradle
in Android Studio und fügen Sie der Datei die folgenden Zeilen hinzu:
buildscript {
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
}
dependencies {
...
// Add this line
classpath 'com.google.gms:google-services:4.3.4'
}
}
allprojects {
...
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
...
}
}
}
- Öffnen Sie
<project>/<app-module>/build.gradle
und fügen Sie der Datei die folgenden Zeilen hinzu:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Sie haben Firebase zu Ihrer Android-App hinzugefügt.
Im nächsten Schritt erfahren Sie, wie Sie Ihrer App das Firebase SDK hinzufügen.
4. Firebase SDK zur App hinzufügen
In diesem Schritt fügen Sie das Firebase SDK hinzu, insbesondere das Firebase SDK für Google Analytics.
Wir verwenden die Firebase Android-Stückliste, mit der Sie die in Ihrer App verwendeten Firebase-Bibliotheksversionen verwalten können, indem Sie die BoM-Version angeben. Informationen dazu, welche Firebase-Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, finden Sie in den Versionshinweisen für diese BoM-Version.
- Öffnen Sie
<project>/<app-module>/build.gradle
und fügen Sie der Datei die folgenden Zeilen hinzu:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx'
Wenn Sie nur die BoM-Version angeben, müssen Sie die Version der Firebase Analytics-Bibliothek nicht angeben. Wenn Sie jedoch unabhängig von der in der BoM angegebenen Version die gewünschte Version für Ihre Firebase-Bibliothek verwenden möchten, müssen Sie die gewünschte Version nur so angeben:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
- Synchronisiere jetzt deine App, indem du auf die Schaltfläche
Sync Now
klickst.
Sie haben Ihrer Android-App nun das Firebase SDK für Google Analytics hinzugefügt.
Im nächsten Schritt erfahren Sie, wie Sie Firebase-Ereignisse in Ihrer Android-App protokollieren.
5. Ereignisse mit Firebase Analytics erfassen
In diesem Schritt erfahren Sie, wie Sie mit Firebase Analytics Ereignisse in der Android-App protokollieren.
Ereignisse können auf zwei Arten protokolliert werden: über vorgeschlagene Ereignisse oder benutzerdefinierte Ereignisse.
Vorgeschlagene Ereignisse verwenden
Das Firebase Analytics SDK definiert eine Reihe von vorgeschlagenen Ereignissen, die in verschiedenen Arten von Apps verwendet werden können, z. B. Gaming, Einzelhandel, Reisen und E-Commerce. Außerdem werden einige vorgeschlagene Ereignisse vorgeschlagen, für die die zugehörigen Parameter erforderlich sind. Mit diesen Parametern können Sie die verfügbaren Details in Ihren Firebase-Berichten maximieren. ( Referenz zu vorgeschlagenen Ereignissen)
- Deklarieren Sie oben in der Aktivität das FirebaseAnalytics-Objekt:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Initialisieren Sie das Objekt in der Methode
onCreate()
:
firebaseAnalytics = Firebase.analytics
- Starten Sie das Logging von Ereignissen mit der Methode
logEvent()
. Mit dem folgenden Code wird ein PURCHASE-Ereignis protokolliert, wenn ein Nutzer einen Artikel in der App kauft:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Benutzerdefinierte Ereignisse verwenden
Wenn Sie Ereignisse benötigen, die nicht durch vorgeschlagene Ereignisse abgedeckt sind, können Sie eigene benutzerdefinierte Ereignisse mit benutzerdefinierten Parametern protokollieren:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Fehler bei Ereignissen beheben
In der Firebase Console können Sie zusammengefasste Daten und Berichte zu Ihren Ereignissen aufrufen. Die Updates finden jedoch im Laufe des Tages regelmäßig statt. Sie können diese Ereignisse nicht sofort sehen, nachdem Sie sie in Ihrer App angemeldet haben.
Zum unmittelbaren Testen und Debuggen können Sie Firebase Debugview verwenden. Mit DebugView können Sie sich die von Ihrer App protokollierten Ereignisdaten auf Entwicklungsgeräten nahezu in Echtzeit ansehen. Weitere Informationen zu DebugView finden Sie im Abschnitt Debugging-Ereignis.
Damit haben Sie die Protokollierung der Ereignisse in Ihrer Android-App abgeschlossen.
Im nächsten Schritt erfahren Sie, wie Sie diese Ereignisse in Google Ads importieren.
6. Firebase-Ereignisse in Google Ads importieren
Die Firebase-Android-Einrichtung ist abgeschlossen und Sie können die App-Kampagne mit protokollierten Aktionsereignissen starten. Verknüpfen Sie zuerst Firebase mit Google Ads. Durch die Verknüpfung von Firebase mit Google Ads können App-Kampagnen mehr über Zielgruppen erfahren und die Erkenntnisse der App-Kampagnen optimieren, was in der Regel zu einer besseren Leistung und mehr Conversions führt.
Firebase mit Google Ads verknüpfen
- Rufen Sie die Firebase-Einstellungen auf, indem Sie auf die Schaltfläche rechts neben der Projektübersicht klicken.
- Auf dem Tab „Integrationen“ sehen Sie Google Ads und die Schaltfläche „Verknüpfen“. Klicken Sie auf „Verknüpfen und fortfahren“.
- Wählen Sie das Google Ads-Konto aus, das Sie verknüpfen möchten.
Sie haben die Verknüpfung von Firebase und Google Ads abgeschlossen. Importieren Sie die Firebase-Ereignisse in Google Ads.
Firebase-Ereignisse importieren
- Rufen Sie in der Firebase Console das Menü „Ereignisse“ auf und markieren Sie das Ereignis, das Sie als Conversion importieren möchten.
- Melden Sie sich nun in Google Ads in dem Konto an, das Sie mit Firebase verknüpfen.
- Wählen Sie in Google Ads „Tools“ → „Messung“ → „Conversions“ aus.
- Klicken Sie auf die Schaltfläche
.
- Wählen Sie „App“ → „Google Analytics 4-Properties (Firebase)“ aus und klicken Sie auf „Weiter“.
- Hier sehen Sie alle Analytics-Ereignisse, die als Conversions markiert sind. Suchen Sie den Termin, den Sie importieren möchten. Wählen Sie in diesem Fall das Ereignis
delete_item
aus, das wir bereits implementiert haben. Klicken Sie auf die Schaltfläche Importieren und fortfahren. - Sie haben ein Conversion-Ereignis aus Firebase importiert.
Sie haben den Import von Firebase-Ereignissen in Google Ads abgeschlossen.
Im nächsten Schritt erfahren Sie, wie Sie mit dem soeben importierten Ereignis eine Aktionskampagne starten.
7. App-Aktionskampagnen mit importierten Ereignissen starten
- Wechseln Sie in Ihrem aktuellen Google Ads-Konto zum Tab „App-Kampagnen“ und starten Sie eine neue Kampagne, indem Sie auf die Schaltfläche „+“ klicken.
- Wir starten eine App-Werbekampagne mit der Option „App-Installationen“. Wählen Sie unten die App aus, für die Sie werben möchten, und klicken Sie auf „Weiter“.
- Wenn Sie im Bereich „Gebote“ die Option „In-App-Aktionen“ auswählen, können Sie Ereignisse aufrufen. Wählen Sie mindestens ein Ereignis aus, auf das Sie sich konzentrieren möchten.
- Nehmen Sie die restlichen Kampagneneinstellungen vor.
8. Glückwunsch
Sie haben Firebase und Google Ads erfolgreich integriert. So lässt sich die Kampagnenleistung steigern.
Sie haben gelernt,
- Firebase Analytics für Android konfigurieren
- Ereignisse mit Firebase Analytics in einer Android-App protokollieren
- Ereignisse importieren und für Aktionskampagnen verwenden