Diese Seite wurde von der Cloud Translation API übersetzt.

Google Ads mit Google Analytics für benutzerdefinierte Firebase-Ereignisse – Android

1. Einleitung

Letzte Aktualisierung: 14.12.2020

Was Sie bauen werden

In diesem Codelab erfahren Sie, wie Sie Ereignisse mit Google Analytics für Firebase (GA4F) implementieren und Aktionskampagnen über Google Ads starten.

Dieses Codelab konzentriert sich auf die Implementierung von Ereignissen mit GA4F und den Import der Ereignisse in Google Ads. Wenn Sie erfahren möchten, wie Sie mit Firebase eine Android-App erstellen, lesen Sie bitte den Firebase Android Codelab-Build Friendly Chat .

Was Sie lernen werden

So erstellen Sie ein Firebase-Projekt
So implementieren Sie das Firebase SDK in der Android-App
So erstellen Sie Ereignisse und Parameter.
So importieren Sie Ereignisse von Firebase in Google Ads
Starten Sie Google Ads-Aktionskampagnen mit benutzerdefinierten Ereignissen.

Was du brauchen wirst

Android Studio 3.6 oder höher
Firebase-Konto
Google Ads-Konto

2. Erstellen und richten Sie ein Firebase-Projekt ein

Um mit Firebase zu beginnen, müssen Sie ein Firebase-Projekt erstellen und einrichten.

Erstellen Sie ein Firebase-Projekt

Melden Sie sich bei Firebase an.

Klicken Sie in der Firebase-Konsole auf „Projekt hinzufügen“ (oder „Projekt erstellen“) und benennen Sie Ihr Firebase-Projekt nach Ihren Wünschen.

Klicken Sie sich durch die Projekterstellungsoptionen. Akzeptieren Sie die Firebase-Bedingungen, wenn Sie dazu aufgefordert werden. Sie sollten Google Analytics für dieses Projekt aktivieren, da Sie Google Analytics-Ereignisse zum Verfolgen von Aktionsereignissen und Conversions benötigen.

Weitere Informationen zu Firebase-Projekten finden Sie unter Grundlegendes zu Firebase-Projekten .

Wählen Sie ein Google Analytics-Konto. Wenn Sie eines haben, wählen Sie dieses aus oder erstellen Sie ein neues. Klicken Sie auf die Schaltfläche Projekt erstellen.

Jetzt ist der Build des Firebase-Projekts abgeschlossen!

Im nächsten Schritt erfahren Sie, wie Sie Firebase zu Ihrer Android-App hinzufügen.

3. Fügen Sie Firebase zu Ihrer Android-App hinzu

App registrieren

Wählen Sie in der Firebase-Konsole im linken Navigationsbereich „Projektübersicht“ aus und klicken Sie dann unter „Erste Schritte durch Hinzufügen von Firebase zu Ihrer App“ auf die Android-Schaltfläche.

Füllen Sie die erforderlichen Informationen aus.

Für den Namen des Android-Pakets gehen Sie im Android Studio in das App-Verzeichnis und öffnen eine Datei mit dem Namen 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.

Wir benötigen den SHA-1-Schlüssel hier nicht, es sei denn, Sie planen die Verwendung von Google Sign In oder Firebase Dynamic Links (Beachten Sie, dass diese nicht Teil dieses Codelabs sind. 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 im Android Studio in das app Verzeichnis und verschieben Sie die Datei google-services.json (die Sie gerade oben heruntergeladen haben) in das app Verzeichnis. Klicken Sie zurück zur Firebase-Konsole auf die Schaltfläche Weiter.

Aktivieren Sie Firebase in Ihrer App

Sie benötigen das Google Services Gradle-Plugin, um die von Firebase generierte Datei google-services.json zu lesen.
Öffnen Sie in Android Studio <project>/build.gradle und fügen Sie dann die folgenden Zeilen in die Datei ein:

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 dann die folgenden Zeilen in die Datei ein:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Jetzt haben Sie Firebase zu Ihrer Android-App hinzugefügt!

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

4. Fügen Sie das Firebase SDK zu Ihrer App hinzu

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, die Sie in Ihrer App verwenden, verwalten können, indem Sie die Version der Stückliste angeben. Um zu erfahren, welche Firebase-Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, lesen Sie die Versionshinweise für diese BoM-Version.

Öffnen Sie <project>/<app-module>/build.gradle und fügen Sie dann die folgenden Zeilen in die Datei ein:

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 durch Angabe nur der Stücklistenversion nicht die Version der Firebase-Analysebibliothek angeben. Wenn Sie jedoch die gewünschte Version für Ihre Firebase-Bibliothek verwenden möchten, unabhängig davon, welche Version in der Stückliste angegeben ist, müssen Sie nur die gewünschte Version wie folgt 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 nun Ihre App, indem Sie auf die Schaltfläche Sync Now klicken.

Jetzt haben Sie das Firebase SDK für Google Analytics zu Ihrer Android-App hinzugefügt!

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

5. Protokollieren Sie Ereignisse mit Firebase Analytics

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

Es gibt zwei Möglichkeiten, Ereignisse zu protokollieren: Verwendung vorgeschlagener Ereignisse oder benutzerdefinierter Ereignisse.

Verwendung vorgeschlagener Ereignisse

Das Firebase Analytics SDK definiert eine Reihe vorgeschlagener Ereignisse, die in verschiedenen Arten von Apps wie Spielen, Einzelhandel, Reisen und E-Commerce verwendet werden können. Außerdem gibt es einige vorgeschlagene Ereignisse, die die vorgeschriebenen Parameter erfordern. Mit diesen Parametern können Sie die verfügbaren Details in Ihren Firebase-Berichten maximieren. ( Empfohlene Veranstaltungsreferenz )

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() . Der folgende Code protokolliert ein PURCHASE- Ereignis, wenn ein Benutzer einen oder mehrere 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 die vorgeschlagenen Ereignisse abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Ereignisse mit benutzerdefinierten Parametern protokollieren:

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

Debug-Ereignisse

Sie können aggregierte Daten und Berichte zu Ihren Ereignissen in der Firebase-Konsole anzeigen. Die Aktualisierungen finden jedoch regelmäßig über den Tag verteilt statt. Sie können diese Ereignisse nicht sofort sehen, nachdem Sie sie in Ihrer App angemeldet haben.

Für unmittelbare Test- und Debugging-Zwecke können Sie Firebase Debugview verwenden. Mit DebugView können Sie von Ihrer App protokollierte Ereignisdaten nahezu in Echtzeit auf Entwicklungsgeräten anzeigen. Informationen zu DebugView finden Sie im Abschnitt Debugging-Ereignis .

Jetzt haben Sie die Protokollierung von Ereignissen in Ihrer Android-App abgeschlossen!

Im nächsten Schritt erfahren Sie, wie Sie diese Ereignisse in Google Ads importieren.

6. Importieren Sie Firebase-Ereignisse in Google Ads

Ihre Firebase-Android-Einrichtung ist abgeschlossen und Sie können die App-Kampagne mit protokollierten Aktionsereignissen starten. Zunächst verknüpfen Sie Firebase mit Google Ads. Durch die Verknüpfung von Firebase mit Google Ads können App-Kampagnen mehr über Zielgruppen erfahren und die Erkenntnisse aus App-Kampagnen steigern, was normalerweise zu einer besseren Leistung und Conversions führt.

Verknüpfen Sie Firebase und Google Ads

Gehen Sie zu den Firebase-Einstellungen, indem Sie auf die Schaltfläche direkt neben „Projektübersicht“ klicken.

Auf der Registerkarte „Integrationen“ sehen Sie Google Ads und eine Link-Schaltfläche. Klicken Sie auf „Verknüpfen und fortfahren“.

Wählen Sie das Google Ads-Konto aus, das Sie verknüpfen möchten.

Jetzt ist die Verknüpfung von Firebase und Google Ads abgeschlossen. Lassen Sie uns Firebase-Ereignisse in Google Ads importieren.

Firebase-Ereignisse importieren

Gehen Sie in der Firebase-Konsole zum Menü „Ereignisse“ und markieren Sie das Ereignis, das Sie als Konvertierung importieren möchten.

Gehen Sie nun zu Google Ads und melden Sie sich bei dem Konto an, das Sie mit Firebase verknüpfen.
Gehen Sie in Google Ads zu Tools → Messung → Conversions
Klicken Sie auf die Schaltfläche +
Wählen Sie App → Google Analytics 4-Eigenschaften (Firebase) und klicken Sie auf Weiter.
Sie können alle Analyseereignisse sehen, die als Conversions markiert sind. Suchen Sie das Ereignis, das Sie importieren möchten. Wählen Sie in diesem Fall das Ereignis delete_item aus, das wir zuvor implementiert haben. Klicken Sie auf die Schaltfläche „Importieren und fortfahren“.
Sie haben erfolgreich ein Conversion-Ereignis aus der Firebase importiert.

Jetzt haben Sie den Import von Firebase-Ereignissen in Google Ads abgeschlossen.

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

7. Starten von App-Aktionskampagnen mit importierten Ereignissen

Gehen Sie in Ihrem aktuellen Google Ads-Konto zur Registerkarte „App-Kampagnen“ und starten Sie eine neue Kampagne, indem Sie auf die Schaltfläche „+“ klicken.

Wir werden eine App-Werbekampagne mit der Option „App-Installationen“ starten. Wählen Sie unten die App aus, die Sie bewerben möchten, und klicken Sie auf „Weiter“.
Wenn Sie im Abschnitt „Gebote“ im Dropdown-Menü „In-App-Aktionen“ auswählen, können Sie Ereignisse anzeigen. Wählen Sie ein oder mehrere Ereignisse aus, auf die Sie sich konzentrieren möchten.

Legen Sie die restlichen Kampagneneinstellungen fest und fertig.

8. Herzlichen Glückwunsch

Herzlichen Glückwunsch, Sie haben Ihre Firebase und Google Ads erfolgreich integriert! Dies wird Ihnen helfen, die Leistung Ihrer Kampagne zu steigern.

Du hast gelernt

So konfigurieren Sie Firebase Analytics für Android
So protokollieren Sie Ereignisse mit Firebase Analytics in einer Android-App.
So importieren Sie Events und nutzen sie für Aktionskampagnen.