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

1. Einführung

Zuletzt aktualisiert:19.02.2021

Inhalt

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 auf iOS-Geräten sanfter einführen möchten, beginnen Sie mit AdMob + Firebase 101 Unity: Einrichtung und Analytics – Grundlagen.

Aufgaben in diesem Lab

• Anleitung zum Initialisieren von GA4F (Google Analytics for Firebase) in Unity und iOS
• 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

Einfache Vorlagen-App für Unity erstellen Sie ändern diese einfache App, 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. Benutzerdefiniertes Firebase-Ereignis für Unity:
4. Wähle einen Speicherort aus, um dein Projekt zu speichern, und klicke 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 Sie ein vorhandenes Firebase-Projekt haben, für das Google Analytics nicht aktiviert ist, können Sie Google Analytics in den Einstellungen auf dem Tab „Integrationen“ aktivieren > Projekteinstellungen. Fahren Sie mit dem Schritt „Firebase-Konfiguration“ fort.

1. Firebase

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

4. Unity-Konfiguration

1. In der Unity > Datei > Build-Einstellungen. 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 Settings (Datei > Build-Einstellungen: Wenn die Plattform nicht auf iOS festgelegt 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 des Felds „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. Fahren Sie in Firebase fort und folgen Sie der Anleitung zum Herunterladen der Konfigurationsdatei GoogleService-Info.plist.
8. Öffnen Sie das Projektfenster Ihres Unity-Projekts und verschieben Sie Ihre Konfigurationsdatei(en) in den Ordner Assets.
9. Überspringen Sie die restlichen Schritte und kehren Sie zur Hauptseite der Firebase Console zurück.

5. Analytics for Firebase in Unity konfigurieren

In diesem Schritt fügen Sie dem 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 aus, welches Build-Ziel Ihres Unity-Projekts Sie registrieren möchten. Sie können auch beide Ziele jetzt 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 oft synonym verwendet.

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

Hinweis:Achten Sie darauf, dass Sie die ID eingeben, die Ihr Projekt tatsächlich verwendet. Beim 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 Kennungen und sind nur für Sie in der Firebase Console 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 dann an einem für Sie geeigneten Speicherort.

• 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 > 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. Beispiel für die Verwendung von Firebase Authentication und Firebase Realtime Database: FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

Für Unity 5.x und frühere Versionen wird das .NET 3.x-Framework verwendet. Importieren Sie daher das dotnet3/-Paket. 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ützt das .NET 3.x-Framework nicht mehr. Importieren Sie daher das dotnet4/-Paket.

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:Wenn Sie das Firebase Unity SDK für iOS verwenden, deaktivieren Sie das Methoden-Wechseln nicht. 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 protokollieren

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

Firebase Analytics protokolliert einige Ereignisse automatisch für Sie. Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn in Ihrer App zusätzliche Daten erhoben werden müssen, können Sie bis zu 500 verschiedene benutzerdefinierte Analytics-Ereignistypen darin 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 die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu überprüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell protokollierte Ereignisse.

So aktivieren Sie die ausführliche Protokollierung:

1. Wählen Sie in Xcode Product > Schema > Schema bearbeiten...
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 Beim Start übergebene Argumente "-FIRAnalyticsDebugEnabled" hinzu.

Wenn Sie Ihre App das nächste Mal ausführen, werden Ihre Ereignisse in der Xcode-Debug-Konsole angezeigt, sodass Sie sofort prüfen können, 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 markieren, indem Sie nach rechts wechseln.

Auf dem Tab „Conversions“ in Firebase Analytics können Sie prüfen, ob das Ereignis erfolgreich als Conversion markiert wurde. Wenn Sie das Ereignis als Conversion markieren, kann es auch in Google Ads 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. 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.

1. Rufen Sie die Firebase-Einstellungen auf, indem Sie auf die Schaltfläche rechts neben der Projektübersicht klicken.
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 Google Ads-Konto aus.

Achtung:Wenn das Zielereignis nicht als Conversion markiert ist, kann es nicht in Google Ads importiert werden. Das Ereignis muss korrekt als Conversion markiert sein.

Jetzt ist der Firebase-Teil abgeschlossen.

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

1. Melden Sie sich in Google Ads an. Wählen Sie „Tools und Einstellungen → Analyse → Conversions, um benutzerdefinierte Ereignisse als Conversion zu importieren.
2. Klicken Sie auf die Schaltfläche „+“, um eine neue Conversion-Aktion hinzuzufügen.

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

4. Hier sehen Sie alle Analytics-Ereignisse, die als Conversions markiert sind. Suchen Sie das 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, können Sie eine Kampagne starten, die auf Nutzer ausgerichtet ist, die wahrscheinlich text_search Ereignisse auslösen.

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, lassen Sie diesen Schritt vorerst.

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. Derzeit starten wir 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ähle im Bereich „Gebote“ in der Dropbox die Option „In-App-Aktionen“ aus, damit Anzeigen den Schwerpunkt auf Aktionen legen.
10. finden Sie Ihre benutzerdefinierten Ereignisse in der bereitgestellten Liste. Legen Sie den Ziel-CPA (Cost-per-Action) fest und geben Sie weitere Optionen an.

11. Konfigurieren Sie die Kampagneneinstellungen. Das wird im Codelab nicht möglich sein. Sehen Sie sich diese Dokumente daher an oder wenden Sie sich über andere Kanäle an die Optimierung der Einstellungen.

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 protokollieren
• Ereignisse importieren und für Aktionskampagnen verwenden

Referenzdokumente

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