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

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 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

Um Firebase zu nutzen, müssen Sie zuerst ein Firebase-Projekt erstellen und einrichten.

Firebase-Projekt erstellen

1. 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.

2. 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

3. 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“.

4. 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

1. 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.

2. 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.

Tipp: Weitere Informationen zu Paket- und Anwendungs-IDs finden Sie unter Anwendungs-ID festlegen.

3. Klicken Sie auf die Schaltfläche „App registrieren“.

Konfigurationsdatei herunterladen

1. Klicken Sie auf die Schaltfläche „google-services.json herunterladen“, um die Konfigurationsdatei google-services.json herunterzuladen.

2. 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. Kehren Sie zur Firebase Console zurück und klicken Sie auf die Schaltfläche „Weiter“.

Firebase in Ihrer App aktivieren

1. Sie benötigen das Gradle-Plug-in für Google-Dienste, um die von Firebase generierte google-services.json-Datei zu lesen.
2. Ö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
      ...
      }
   }
}

3. Ö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 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.

1. Ö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 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'

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

Sie haben Ihrer Android-App jetzt das Firebase SDK für Google Analytics hinzugefügt.

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 vorgeschlagenen Ereignissen)

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

private lateinit var firebaseAnalytics: FirebaseAnalytics

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

firebaseAnalytics = Firebase.analytics

3. Starten Sie das Logging 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 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)
}

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 also 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. Weitere 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 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

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

2. Auf dem Tab „Integrationen“ sehen Sie Google Ads und die Schaltfläche „Verknüpfen“. Klicken Sie auf „Verknüpfen und fortfahren“.

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

Sie haben Firebase jetzt mit Google Ads verknüpft. Importieren Sie die Firebase-Ereignisse in Google Ads.

Firebase-Ereignisse importieren

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

Achtung:Wenn das Zielereignis nicht als Conversion markiert ist, kann es nicht in Google Ads importiert werden. Prüfen Sie, ob das Ereignis korrekt als Conversion markiert ist.

2. Melden Sie sich nun in Google Ads in dem Konto an, das Sie mit Firebase verknüpfen.
3. Klicken Sie in Google Ads auf „Tools“ > „Messung“ > „Conversions“.
4. Klicken Sie auf die Schaltfläche .
5. Wählen Sie „App“ → „Google Analytics 4-Properties (Firebase)“ aus und klicken Sie auf „Weiter“.
6. Hier sehen Sie 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“.
7. 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

Wichtig: Wenn Sie eine App-Kampagne starten möchten, benötigen Sie eine App auf Produktionsebene bei Google Play. Wenn Sie die App noch nicht veröffentlichen möchten, lassen Sie diesen Schritt vorerst.

1. 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.

2. 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“.
3. Wenn Sie im Bereich „Gebote“ die Option „In-App-Aktionen“ auswählen, können Sie Ereignisse aufrufen. Wählen Sie die Ereignisse aus, auf die Sie sich konzentrieren möchten.

4. Nehmen Sie die restlichen Kampagneneinstellungen vor.

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 Aktionskampagnen verwenden