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 darum, Ereignisse mit GA4F zu implementieren und die Ereignisse in Google Ads zu importieren. Wenn Sie wissen möchten, wie Sie eine Android-App mit Firebase erstellen, lesen Sie bitte das Firebase Android-Codelab – Friendly Chat erstellen.

Lerninhalte

  • Firebase-Projekt erstellen
  • Firebase SDK in Android-App implementieren
  • So erstellen Sie Ereignisse und Parameter.
  • 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 mit Firebase zu beginnen, müssen Sie ein Firebase-Projekt erstellen und einrichten.

Firebase-Projekt erstellen

  1. Melden Sie sich mit Ihrem Google-Konto in der Firebase Console an.
  2. Klicken Sie auf die Schaltfläche zum Erstellen eines neuen Projekts und geben Sie einen Projektnamen ein (z. B. FriendlyChat).
  3. Klicken Sie auf Weiter.
  4. Lesen und akzeptieren Sie bei Aufforderung die Firebase-Nutzungsbedingungen und klicken Sie dann auf Weiter.
  5. (Optional) Aktivieren Sie die KI-Unterstützung in der Firebase Console (als „Gemini in Firebase“ bezeichnet).
  6. Für dieses Codelab benötigen Sie Google Analytics, um Aktionsereignisse und Conversions zu erfassen. Lassen Sie die Ein/Aus-Schaltfläche für die Google Analytics-Option also aktiviert. Folgen Sie der Anleitung auf dem Bildschirm, um Google Analytics einzurichten.
  7. Klicken Sie auf Projekt erstellen, warten Sie, bis Ihr Projekt bereitgestellt wurde, und klicken Sie dann auf Weiter.

Weitere Informationen zu Firebase-Projekten

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 „Fügen Sie Firebase zu Ihrer App hinzu, um zu beginnen“ auf die Schaltfläche „Android“.

6cbb33ad3e7c9132.png

  1. Geben Sie die erforderlichen Informationen ein.

3b7d3b33d81fe8ea.png

Rufen Sie in Android Studio das App-Verzeichnis auf und öffnen Sie die Datei build.gradle, um den Android-Paketnamen zu finden. 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 möchten Google Sign-in oder Firebase Dynamic Links verwenden. Diese sind jedoch nicht Teil dieses Codelabs. Weitere Informationen zum SHA-1-Schlüssel finden Sie in diesem Dokument.

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

52f08aa18c8d59d0.png

  1. Wechseln Sie in Android Studio zum Verzeichnis app und verschieben Sie die Datei google-services.json, die Sie gerade heruntergeladen haben, in das Verzeichnis app. Klicken Sie in der Firebase Console 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 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
      ...
      }
   }
}
  1. Ö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 erfolgreich zu Ihrer Android-App hinzugefügt.

Im nächsten Schritt erfahren Sie, wie Sie das Firebase SDK in Ihre App einfü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 BoM, mit der Sie die Versionen der Firebase-Bibliotheken, die Sie in Ihrer App verwenden, durch Angabe der BoM-Version verwalten können. 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'

Wie Sie sehen, müssen Sie die Version der Firebase Analytics-Bibliothek nicht angeben, wenn Sie nur die Version der 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'
  1. Synchronisieren Sie die App jetzt, indem Sie auf die Schaltfläche Sync Now klicken. 937206076c88ae5c.png

Sie haben 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 protokollieren.

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

Im Firebase Analytics SDK sind eine Reihe von empfohlenen Ereignissen definiert, die in verschiedenen Arten von Apps wie Spiele, Einzelhandel, Reisen und E-Commerce verwendet werden können. Außerdem gibt es einige vorgeschlagene Ereignisse, 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)

  1. Deklarieren Sie das FirebaseAnalytics-Objekt oben in der Aktivität:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Initialisieren Sie das Objekt in der Methode onCreate():
firebaseAnalytics = Firebase.analytics
  1. Beginnen Sie mit der Protokollierung von Ereignissen mit der Methode logEvent(). Mit dem folgenden Code wird ein PURCHASE-Ereignis 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 Ihre eigenen benutzerdefinierten 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 sich aggregierte Daten und Berichte zu Ihren Ereignissen ansehen. Die Aktualisierungen erfolgen jedoch regelmäßig über den Tag verteilt. Du kannst diese Ereignisse also nicht sofort nach der Protokollierung in deiner App sehen.

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

Sie haben jetzt Ereignisse für Ihre 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. Wenn Sie Firebase mit Google Ads verknüpfen, können Sie mehr über Zielgruppen erfahren und die Daten für App-Kampagnen optimieren. Das führt in der Regel zu einer besseren Leistung und mehr Conversions.

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

412830708c61fdc0.png

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

796c921fb2b873ae.png

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

Sie haben Firebase und Google Ads jetzt verknüpft. Wir importieren 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.

a5f302ba01a1863c.png

  1. Rufen Sie nun Google Ads auf und melden Sie sich in dem Konto an, das Sie mit Firebase verknüpfen.
  2. Rufen Sie in Google Ads „Tools“ → „Analyse“ → „Conversions“ auf. 7acf268d7e799a7e.png
  3. Klicken Sie auf das Pluszeichen d0eed72946d038d8.png.
  4. Wählen Sie „App“ → „Google Analytics 4-Properties (Firebase)“ aus und klicken Sie auf „Weiter“. 983f06edb15724de.png
  5. Sie sehen alle Analytics-Ereignisse, die als Conversions markiert sind. Suchen Sie nach der Veranstaltung, die Sie importieren möchten. Wählen Sie in diesem Fall das Ereignis delete_item aus, das wir zuvor implementiert haben. Klicken Sie auf „Importieren und fortfahren“. f9bdee80c0d40999.png
  6. Sie haben ein Conversion-Ereignis aus Firebase importiert. be75f6a11913236.png

Sie haben jetzt Firebase-Ereignisse in Google Ads importiert.

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

7. App-Aktionskampagnen mit importierten Ereignissen starten

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

19856a65ab999ad7.png

  1. Wir starten eine App-Werbekampagne mit der Option „App-Installationen“. Wählen Sie unten die App aus, die Sie bewerben möchten, und klicken Sie auf „Weiter“. 8146b5a7a4f961bd.png
  2. Wenn Sie im Bereich „Gebote“ die Option „In-App-Aktionen“ im Drop-down-Menü auswählen, können Sie Ereignisse aufrufen. Wählen Sie ein oder mehrere Ereignisse aus, auf die Sie sich konzentrieren möchten.

b75e410c7dbdfec8.png

  1. Legen Sie die restlichen Kampagneneinstellungen fest.

8. Glückwunsch

Herzlichen Glückwunsch! Sie haben Firebase und Google Ads erfolgreich verknüpft. So können Sie die Kampagnenleistung steigern.

Sie haben gelernt

  • Firebase Analytics für Android konfigurieren
  • So protokollieren Sie Ereignisse mit Firebase Analytics in einer Android-App.
  • Ereignisse importieren und für aktionsfördernde Kampagnen verwenden