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

1. Einführung

Letzte Aktualisierung: 19. Februar 2021

Umfang

In diesem Codelab erfahren Sie, wie Sie benutzerdefinierte Ereignisse mit GA4F iOS in der Unity-Umgebung implementieren und Aktionskampagnen über Google Ads starten.

In diesem Codelab können Sie den gesamten Prozess des App-Geschäfts kennenlernen, mit dem unsere Kunden konfrontiert sind. Wenn Sie Firebase und AdMob für iOS etwas freundlicher einführen möchten, lesen Sie den Artikel AdMob + Firebase 101 Unity: Einrichtung und Analytics-Grundlagen.

Aufgaben in diesem Lab

• GA4F (Google Analytics for Firebase) in Unity und iOS initialisieren
• Benutzerdefinierte Ereignisse und Parameter erstellen
• Ereignisse aus Firebase in Google Ads importieren
• Aktionskampagnen mit benutzerdefinierten Ereignissen starten

Voraussetzungen

• Xcode
• Unity
• Firebase-Konto
• Google Ads-Konto

2. Neues Unity-Projekt starten

Sie erstellen eine einfache Unity-App mit Vorlage. Diese einfache App ändern Sie dann, um die fertige App zu erstellen.

Unity starten

1. Wenn Sie keine offenen Projekte haben, wählen Sie „Neues Projekt erstellen“ aus.
2. Wählen Sie im Dialogfeld die 3D-Vorlagen aus.
3. Geben Sie den Projektnamen ein, z.B. Unity Firebase Custom Event.
4. Wählen Sie einen Speicherort für Ihr Projekt aus und klicken Sie auf „ERSTELLEN“.
5. Unity öffnet das neue Projekt im Arbeitsbereichsfenster.

3. Firebase-Projekt erstellen und einrichten

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

Wenn Google Analytics für ein Firebase-Projekt nicht aktiviert ist, können Sie Google Analytics auf dem Tab „Integrationen“ unter „Einstellungen“ > „Projekteinstellungen“ aktivieren. Fahren Sie mit dem Schritt zur Firebase-Konfiguration fort.

1. Melden Sie sich in Firebase an.

Klicken Sie in der Firebase Console auf „Projekt hinzufügen“ oder „Projekt erstellen“ und geben Sie dem Firebase-Projekt den Namen „Firebase-iOS-Ads“.

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 finden Sie unter Firebase-Projekte verstehen.

4. Unity-Konfiguration

1. Wählen Sie „Unity“ > „File“ > „Build Settings“ aus. Wichtig ist, die iOS-Paket-ID festzulegen, die Sie im folgenden Schritt abrufen.

Das Dialogfeld erscheint auf dem folgenden Bildschirm.

2. Öffnen Sie in Ihrem Unity-Projekt für die iOS-App das Dialogfeld „Build-Einstellungen“ (Datei > Build-Einstellungen). Wenn die Plattform nicht auf „iOS“ eingestellt ist, können Sie die iOS-Plattform auswählen und auf die Schaltfläche Plattform wechseln klicken.

3. Klicke nach dem Plattformwechsel auf die Schaltfläche „Spielereinstellungen“, um die Bundle-ID festzulegen. Sie sehen das Textfeld um den Bereich Identifikation.
4. Der Wert im Feld "Bundle Identifier" (Paket-Identifikator) ist die iOS-Bundle-ID (etwa com.yourcompany.yourproject). Kopieren Sie diesen Wert oder legen Sie den Wert fest und kopieren Sie ihn.
5. Fügen Sie im Firebase-Dialogfeld die kopierte Bundle-ID in das Feld iOS bundle ID ein.
6. Klicken Sie auf Register App (App registrieren).
7. Folgen Sie in Firebase der Anleitung, um die Konfigurationsdatei herunterzuladen.GoogleService-Info.plist
8. Öffnen Sie das Projektfenster Ihres Unity-Projekts und verschieben Sie die Konfigurationsdatei(en) in den Ordner Assets.
9. Überspringen Sie die restlichen Schritte und kehren Sie zur Hauptseite der Firebase Console zurück.

5. Firebase Analytics in Unity konfigurieren

In diesem Schritt fügen Sie Ihrem Unity-Projekt das Firebase SDK hinzu.

1. Rufen Sie die Firebase Console auf.
2. Klicken Sie in der Mitte der Projektübersichtsseite auf das Unity-Symbol ( ), um den Einrichtungsworkflow zu starten. Wenn Sie Ihrem Firebase-Projekt bereits eine App hinzugefügt haben, klicken Sie auf App hinzufügen, um die Plattformoptionen aufzurufen.
3. Wählen Sie das Build-Ziel Ihres Unity-Projekts aus, das Sie registrieren möchten. Sie können auch beide Ziele gleichzeitig registrieren.

Hinweis:Wenn Sie jetzt nur ein Build-Ziel Ihres Unity-Projekts registrieren, können Sie später jederzeit zum Einrichtungsworkflow zurückkehren, um das andere Build-Ziel zu registrieren.

4. Geben Sie die plattformspezifischen IDs Ihres Unity-Projekts ein.

• iOS: Geben Sie die iOS-ID Ihres Unity-Projekts in das Feld iOS-Bundle-ID ein.
• Android: Geben Sie die Android-ID Ihres Unity-Projekts in das Feld Android-Paketname ein. Die Begriffe Paketname und Anwendungs-ID werden häufig synonym verwendet.

5. Wo finden Sie die ID Ihres Unity-Projekts?

Hinweis: Achten Sie darauf, dass Sie die ID eingeben, die für Ihr Projekt verwendet wird. Bei dem ID-Wert wird zwischen Groß- und Kleinschreibung unterschieden. Er kann für diese Firebase-Apps nicht mehr geändert werden, nachdem sie in Ihrem Firebase-Projekt registriert wurden.

6. Optional: Geben Sie den oder die plattformspezifischen Alias für Ihr Unity-Projekt ein. Diese Aliasse sind interne, praktische Kennungen und sind nur in der Firebase Console für Sie sichtbar.
7. Klicken Sie auf App registrieren.

Firebase Analytics Unity SDKs hinzufügen

1. Klicken Sie in der Firebase Console auf Firebase Unity SDK herunterladen und entpacken Sie das SDK an einem geeigneten Ort.

• Sie können das Firebase Unity SDK jederzeit wieder herunterladen.
• Das Firebase Unity SDK ist nicht plattformspezifisch.

2. Gehen Sie in Ihrem geöffneten Unity-Projekt zu Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket).
3. Wählen Sie im entpackten SDK die unterstützten Firebase-Produkte aus, die Sie in Ihrer App verwenden möchten.

• Fügen Sie das Firebase-Paket für Google Analytics hinzu: FirebaseAnalytics.unitypackage
• Fügen Sie die Pakete für alle anderen Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Wenn Sie beispielsweise Firebase Authentication und Firebase Realtime Database verwenden möchten, fügen Sie FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage hinzu.

Unity 5.x und niedriger verwenden das .NET 3.x-Framework. Importieren Sie daher das Paket dotnet3/. Unity 2017.x und höher ermöglichen die Verwendung des .NET 4.x-Frameworks. Wenn Ihr Unity-Projekt .NET 4.x verwendet, importieren Sie das dotnet4/-Paket. Unity 2019 und höher unterstützen das .NET 3.x-Framework nicht mehr. Importieren Sie daher das Paket dotnet4/.

4. Klicken Sie im Fenster Import Unity Package (Unity-Paket importieren) auf Import (Importieren).
5. Klicken Sie in der Firebase Console im Einrichtungsworkflow auf Weiter.

Wichtig: Deaktivieren Sie beim Firebase Unity SDK für iOS nicht das Methoden-Swizzling. Für das SDK ist Swizzling erforderlich. Andernfalls funktionieren wichtige Firebase-Funktionen (z. B. die Verarbeitung von FCM-Tokens) nicht richtig.

6. Benutzerdefinierte Ereignisse mit Firebase Analytics erfassen

In diesem Schritt erfahren Sie, wie Sie benutzerdefinierte Ereignisse mit Firebase Analytics in der Unity-iOS-App erfassen.

Firebase Analytics protokolliert einige Ereignisse automatisch für Sie. Sie müssen keinen Code hinzufügen, um sie zu empfangen. Wenn in Ihrer App zusätzliche Daten erhoben werden müssen, können Sie bis zu 500 verschiedene Arten von benutzerdefinierten Analytics-Ereignissen in Ihrer App erfassen.

Ereignisse protokollieren

Nachdem Sie die FirebaseApp-Instanz konfiguriert haben, können Sie damit beginnen, Ereignisse mit der Methode logEvent() zu protokollieren.

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Ereignisse in der Xcode-Debugging-Konsole ansehen

Sie können ausführliche Protokolle aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell aufgezeichnete Ereignisse.

So aktivieren Sie die ausführliche Protokollierung:

1. Wählen Sie in Xcode Produkt > Schema > Schema bearbeiten... aus.
2. Wählen Sie im Menü auf der linken Seite Ausführen aus.
3. Wählen Sie den Tab Argumente aus.
4. Fügen Sie im Abschnitt Arguments Passed On Launch (Beim Start übergebene Argumente) -FIRAnalyticsDebugEnabled hinzu.

Wenn Sie die App das nächste Mal ausführen, werden die Ereignisse in der Xcode-Debugkonsole angezeigt. So können Sie sofort prüfen, ob Ereignisse gesendet werden.

Ereignisse im Dashboard ansehen

Das protokollierte Ereignis wird in einigen Stunden in der Firebase Console angezeigt. Sie finden sie unter „Analytics“ → „Ereignisse“. Sie können Parameterwerte auch aufrufen, indem Sie auf das Ereignis klicken.

Sie markieren „text_search“ als Conversion, indem Sie den Schieberegler „Als Conversion markieren“ nach rechts ziehen.

Auf dem Tab „Conversions“ in Firebase Analytics können Sie prüfen, ob das Ereignis als Conversion markiert ist. Wenn Sie das Ereignis als Conversion markieren, kann es auch in Google Ads als Conversion importiert werden.

7. Analytics-Ereignisse in Google Ads importieren

Die Firebase-iOS-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 Erkenntnisse aus App-Kampagnen verbessern. 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.
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 ein Google Ads-Konto aus.

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.

Der Firebase-Teil ist jetzt fertig.

Gehen Sie jetzt zu Google Ads und melden Sie sich an.

1. Rufen Sie Google Ads auf, melden Sie sich an und klicken Sie auf „Tools und Einstellungen“ → „Messung“ → „Conversions“, um benutzerdefinierte Ereignisse als Conversions zu importieren.
2. Klicken Sie auf das Pluszeichen, um eine neue Conversion-Aktion hinzuzufügen.

3. Wählen Sie „Google Analytics 4-Properties (Firebase)“ aus und klicken Sie auf „Weiter“.

4. Sie sehen alle Analytics-Ereignisse, die als Conversions markiert sind. Suchen Sie nach dem clicked_counter-Ereignis, das wir zuvor implementiert haben.

5. Klicken Sie auf die Schaltfläche Importieren und fortfahren.

Nachdem Sie „text_search“ als Conversion-Aktion festgelegt haben, ist es an der Zeit, eine Kampagne zu starten, die auf Nutzer ausgerichtet ist, bei denen wahrscheinlich text_search-Ereignisse ausgelöst werden.

8. App-Aktionskampagnen mit importierten Ereignissen starten

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

6. Wechseln Sie in Ihrem aktuellen Konto zum Tab „Kampagnen“ und starten Sie eine neue Kampagne, indem Sie auf die Schaltfläche „+“ klicken. Klicken Sie auf die neue Kampagne und fahren Sie fort.
7. Wir starten eine App-Werbekampagne mit der Option „App-Installationen“.

8. Geben Sie den Namen der App, den Paketnamen oder den Publisher an, um Ihre App zu finden.
9. Wählen Sie im Bereich „Gebote“ im Drop-down-Menü „Anzeigen“ die Option „In-App-Aktionen“ aus, um den Schwerpunkt auf Aktionen zu legen.
10. Sie finden Ihre benutzerdefinierten Ereignisse in der Liste. Legen Sie den Ziel-CPA (Cost-per-Action) fest und geben Sie weitere Optionen an.

11. Konfigurieren Sie die Kampagneneinstellungen. Das geht über den Rahmen dieses Codelabs hinaus. Lesen Sie sich daher die entsprechenden Dokumente durch oder wenden Sie sich über andere Kanäle an uns, um die Einstellungen zu optimieren.

9. Glückwunsch

Herzlichen Glückwunsch, Sie haben Firebase erfolgreich in Unity und Google Ads integriert. So lässt sich die Kampagnenleistung steigern.

Sie haben gelernt,

• Firebase für die Unity-iOS-Plattform konfigurieren
• Benutzerdefinierte Ereignisse mit Unity und Firebase Analytics erfassen
• Ereignisse importieren und für Aktionskampagnen verwenden

Referenzdokumente

• Firebase zu Ihrem Unity-Projekt hinzufügen
• Github: firebase/quickstart-unity