Diese Seite wurde von der Cloud Translation API übersetzt.

Google Ads mit benutzerdefinierten Google Analytics for Firebase-Ereignissen – Android

1. Einführung

Zuletzt aktualisiert:14.12.2020

Umfang

In diesem Codelab erfahren Sie, wie Sie Ereignisse mit Google Analytics for Firebase(GA4F) implementieren und Action-Kampagnen über Google Ads starten.

In diesem Codelab geht es hauptsächlich darum, Ereignisse mit GA4F zu implementieren und in Google Ads zu importieren. Weitere Informationen zum Erstellen einer Android-App mit Firebase finden Sie im Firebase Android Codelab „Build Friendly Chat“.

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

Wenn Sie mit Firebase beginnen möchten, müssen Sie ein Firebase-Projekt erstellen und einrichten.

Firebase-Projekt erstellen

Melden Sie sich in Firebase an.

Klicken Sie in der Firebase Console auf „Projekt hinzufügen“ (oder „Projekt erstellen“) und geben Sie einen Namen für Ihr Firebase-Projekt ein.

Klicken Sie sich durch die Optionen für die 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 finden Sie unter Firebase-Projekte verstehen.

Wählen Sie ein Google Analytics-Konto aus. Wählen Sie einen vorhandenen Kanal aus oder erstellen Sie einen neuen. Klicken Sie auf die Schaltfläche „Projekt erstellen“.

Der Build des Firebase-Projekts ist jetzt abgeschlossen.

Im nächsten Schritt erfahren Sie, wie Sie Firebase 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 die Option „Projektübersicht“ aus und klicken Sie dann unter „Fügen Sie Firebase zu Ihrer App hinzu, um zu beginnen“ auf die Schaltfläche „Android“.

Geben Sie die erforderlichen Informationen ein.

Rufen Sie in Android Studio das App-Verzeichnis auf und öffnen Sie die Datei build.gradle. Suchen Sie in der Datei nach applicationId. Dieser Wert ist der Android-Paketname. Kopieren Sie diesen Wert und fügen Sie ihn ein.

Der SHA-1-Schlüssel ist hier nicht erforderlich, es sei denn, Sie möchten Google Sign In oder Firebase Dynamic Links verwenden. Hinweis: Diese Funktionen sind nicht Teil dieses Codelabs. 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.

Rufen Sie in Android Studio das Verzeichnis app auf und verschieben Sie die Datei google-services.json, die Sie oben heruntergeladen haben, in das Verzeichnis app. Klicken Sie in der Firebase Console 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 google-services.json-Datei zu lesen.
Öffnen Sie in Android Studio <project>/build.gradle 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 jetzt Ihrer Android-App hinzugefügt.

Im nächsten Schritt erfahren Sie, wie Sie Ihrer App das Firebase SDK hinzufügen.

4. Firebase SDK zu Ihrer 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 Versionen der Firebase-Bibliothek verwalten können, die Sie in Ihrer App verwenden. Dazu geben Sie die Version der Stückliste an. Welche Firebase-Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, erfahren 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'

Wie Sie sehen, müssen Sie die Version der Firebase Analytics-Bibliothek nicht angeben, wenn Sie nur die Version des BoM angeben. Wenn Sie jedoch die gewünschte Version für Ihre Firebase-Bibliothek verwenden möchten, unabhängig davon, welche Version in der BoM angegeben ist, müssen Sie die gewünschte Version 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'

Synchronisieren Sie jetzt die App, indem Sie auf die Schaltfläche Sync Now klicken.

Sie haben jetzt das Firebase SDK für Google Analytics in Ihre Android-App eingebunden.

Im nächsten Schritt erfahren Sie, wie Sie Firebase-Ereignisse in Ihrer Android-App erfassen.

5. Ereignisse mit Firebase Analytics erfassen

In diesem Schritt erfahren Sie, wie Sie Ereignisse mit Firebase Analytics in der Android-App protokollieren.

Es gibt zwei Möglichkeiten, Ereignisse zu erfassen: mit vorgeschlagenen oder benutzerdefinierten Ereignissen.

Vorgeschlagene Ereignisse verwenden

Das Firebase Analytics SDK definiert eine Reihe von vorgeschlagenen Ereignissen, die in verschiedenen Arten von Apps wie Gaming, Einzelhandel, Reisen und E-Commerce verwendet werden können. Außerdem gibt es einige vorgeschlagene Ereignisse, für die die vorgeschriebenen Parameter erforderlich sind. Mit diesen Parametern können Sie die verfügbaren Details in Ihren Firebase-Berichten maximieren. ( Referenz zu empfohlenen Ereignissen)

Deklarieren Sie das FirebaseAnalytics-Objekt oben in der Aktivität:

private lateinit var firebaseAnalytics: FirebaseAnalytics

Initialisieren Sie das Objekt in der onCreate()-Methode:

firebaseAnalytics = Firebase.analytics

Beginnen Sie mit der Protokollierung von Ereignissen mit der Methode logEvent(). Im folgenden Code wird das Ereignis KAUF protokolliert, wenn ein Nutzer 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 von den vorgeschlagenen Ereignissen abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse mit benutzerdefinierten Parametern erfassen:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Debug-Ereignisse

In der Firebase Console können Sie zusammengefasste Daten und Berichte zu Ihren Ereignissen aufrufen. Die Aktualisierungen erfolgen jedoch mehrmals täglich. Sie können diese Ereignisse nicht sofort nach dem Aufzeichnen in Ihrer App aufrufen.

Für sofortige Tests und Fehlerbehebungen können Sie Firebase Debugview verwenden. Mit DebugView können Sie sich Ereignisdaten ansehen, die von Ihrer App auf Entwicklungsgeräten nahezu in Echtzeit protokolliert werden. Informationen zu DebugView finden Sie im Abschnitt Debugging-Ereignis.

Sie haben jetzt Ereignisse in Ihrer Android-App protokolliert.

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 aufgezeichneten Aktionsereignissen starten. Verknüpfen Sie zuerst Firebase mit Google Ads. Wenn Sie Firebase mit Google Ads verknüpfen, können Sie mehr über Zielgruppen erfahren und die Erkenntnisse aus App-Kampagnen verbessern. Das führt in der Regel zu einer besseren Leistung und mehr Conversions.

Firebase mit Google Ads verknüpfen

Klicken Sie auf die Schaltfläche direkt neben „Projektübersicht“, um die Firebase-Einstellungen aufzurufen.

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 Firebase jetzt mit Google Ads verknüpft. Importieren wir jetzt Firebase-Ereignisse in Google Ads.

Firebase-Ereignisse importieren

Klicken Sie in der Firebase Console auf das Menü „Ereignisse“ und markieren Sie das Ereignis, das Sie importieren möchten, als Conversion.

Rufen Sie jetzt Google Ads auf und melden Sie sich in dem Konto an, das Sie mit Firebase verknüpft haben.
Klicken Sie in Google Ads auf „Tools“ > „Analyse“ > „Conversions“.
Klicken Sie auf das Pluszeichen .
Wählen Sie „App“ → „Google Analytics 4-Properties (Firebase)“ aus und klicken Sie auf „Weiter“.
Sie sehen alle Analytics-Ereignisse, die als Conversions markiert sind. Suchen Sie die Veranstaltung, die 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 jetzt den Import von Firebase-Ereignissen in Google Ads abgeschlossen.

Im nächsten Schritt erfahren Sie, wie Sie eine Aktionskampagne mit dem gerade importierten Ereignis starten.

7. App-Aktionskampagnen mit importierten Ereignissen starten

Rufen Sie in Ihrem aktuellen Google Ads-Konto den Tab „App-Kampagnen“ auf und klicken Sie auf das Pluszeichen, um eine neue Kampagne zu erstellen.

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“ im Drop-down-Menü „In-App-Aktionen“ auswählen, können Sie sich Ereignisse ansehen. Wählen Sie die Ereignisse aus, auf die Sie sich konzentrieren möchten.

Legen Sie die restlichen Kampagneneinstellungen fest.

8. Glückwunsch

Herzlichen Glückwunsch, Sie haben Firebase und Google Ads erfolgreich eingebunden. 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 aktionsfördernde Kampagnen verwenden