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

1. Einführung

Letzte Aktualisierung:19.02.2021

Was Sie erstellen

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

In diesem Codelab können Sie den gesamten Prozess für App-Unternehmen nachvollziehen, mit dem unsere Kunden konfrontiert sind. Wenn Sie eine sanftere Einführung in Firebase und AdMob unter iOS wünschen, beginnen Sie mit AdMob und Firebase 101 (Unity): Einrichtung und Grundlagen von Analytics.

Lerninhalte

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

Voraussetzungen

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

2. Neues Unity-Projekt starten

Erstellen Sie eine einfache Unity-App mit Vorlage. Sie können diese einfache App ändern, 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 Ihr neues Projekt im Arbeitsbereichsfenster.

3. Firebase-Projekt erstellen und einrichten

Wenn Sie Firebase verwenden möchten, müssen Sie 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 Ihrem 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 benötigen, um Aktionsereignisse und Conversions zu erfassen.

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

4. Unity-Konfiguration

1. Klicken Sie in Unity auf „Datei“ > „Build Settings“ (Build-Einstellungen). Wichtig ist, die iOS-Bundle-ID festzulegen, die Sie im nächsten Schritt erhalten.

Das Dialogfeld wird wie im folgenden Screenshot angezeigt.

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

3. Klicken Sie nach dem Ändern der Plattform auf die Schaltfläche „Player Settings“ (Player-Einstellungen), um die Bundle-ID festzulegen. Sie sehen das Textfeld im Bereich Identification (Identifikation).
4. Der Wert des Felds „Bundle Identifier“ (Bundle-ID) ist die iOS-Bundle-ID (z. B. com.yourcompany.yourproject). Kopieren Sie diesen Wert oder legen Sie Ihren Wert fest und kopieren Sie ihn.
5. Fügen Sie im Firebase-Dialogfeld die kopierte Bundle-ID in das Feld iOS bundle ID (iOS-Bundle-ID) ein.
6. Klicken Sie auf App registrieren.
7. Folgen Sie in Firebase der Anleitung, um die Konfigurationsdatei GoogleService-Info.plist herunterzuladen.
8. Öffnen Sie das Projektfenster des Unity-Projekts und verschieben Sie die Konfigurationsdatei(en) in den Ordner Assets (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 Ihrem Unity-Projekt das Firebase SDK hinzu.

1. Öffnen Sie die Firebase Console.
2. Klicken Sie in der Mitte der Projektübersicht auf das Symbol Unity ( ), 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 (iOS-Bundle-ID) ein.
• Android : Geben Sie die Android-ID Ihres Unity-Projekts in das Feld Android package name (Android-Paketname) ein. Die Begriffe Paketname und Anwendungs-ID werden oft synonym verwendet.

5. Wo finde ich die ID meines Unity-Projekts?

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

6. (Optional) Geben Sie die plattformspezifischen Spitznamen Ihres Unity-Projekts ein. Diese Spitznamen sind interne, praktische IDs und nur 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 an einem geeigneten Ort.

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

2. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets (Assets) > Import Package (Paket importieren) > Custom Package (Benutzerdefiniertes Paket) auf.
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: Wenn Sie Firebase Authentication und Firebase Realtime Database verwenden möchten, fügen Sie FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage hinzu.

Unity 5.x und ältere Versionen verwenden das .NET 3.x-Framework. Importieren Sie daher das Paket dotnet3/. Unity 2017.x und höher ermöglicht die Verwendung des .NET 4.x-Frameworks. Wenn Ihr Unity-Projekt .NET 4.x verwendet, importieren Sie das Paket dotnet4/. Unity 2019 und höher unterstützt 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 die Method Swizzling nicht, wenn Sie das Firebase Unity SDK für iOS verwenden. Swizzling ist für das SDK erforderlich. Ohne Swizzling funktionieren wichtige Firebase-Funktionen (z. B. die FCM-Tokenverwaltung) nicht richtig.

6. Benutzerdefinierte Ereignisse mit Analytics for Firebase protokollieren

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

Analytics for Firebase protokolliert einige Ereignisse automatisch. Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn Sie zusätzliche Daten benötigen, können Sie bis zu 500 verschiedene benutzerdefinierte Analytics-Ereignistypen in Ihrer App protokollieren.

Ereignisse protokollieren

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

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

Ereignisse in der Xcode-Debug-Konsole ansehen

Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu beobachten 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 > Scheme > Edit scheme... (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 Bereich 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. So können Sie sofort überprüfen, ob Ereignisse gesendet werden.

Ereignisse im Dashboard ansehen

Sie sehen das protokollierte Ereignis in einigen Stunden in der Firebase Console. Es befindet sich unter „Analytics“ > „Ereignisse“. Sie können auch Parameterwerte finden, indem Sie auf das Ereignis klicken.

Sie können „text_search“ als Conversion markieren, indem Sie den Schalter „Als Conversion markieren“ nach rechts schieben.

Auf dem Tab „Conversions“ (Conversions) in Analytics for Firebase können Sie noch einmal überprüfen, ob das Ereignis erfolgreich als Conversion markiert wurde. Wenn Sie das Ereignis als Conversion markieren, kann Google Ads es auch als Conversion importieren.

7. Analytics-Ereignisse in Google Ads importieren

Die Einrichtung von Firebase-iOS 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 aus App-Kampagnen verbessern. Das führt in der Regel zu einer besseren Leistung und mehr Conversions.

1. Rufen Sie die Firebase-Einstellungen auf, indem Sie auf die Schaltfläche direkt neben „Projektübersicht“ klicken.
2. Auf dem Tab „Integrationen“ sehen Sie Google Ads und eine Schaltfläche „Verknüpfen“. Klicken Sie auf „Verknüpfen“ und „Weiter“.

3. Wählen Sie ein Google Ads-Konto aus.

Achtung:Wenn das Zielereignis nicht als Conversion markiert ist, kann Google Ads es nicht importieren. Achten Sie darauf, dass das Ereignis richtig als Conversion markiert ist.

Der Firebase-Teil ist jetzt abgeschlossen.

Rufen Sie Google Ads auf und melden Sie sich an.

1. Rufen Sie Google Ads auf und melden Sie sich an. Gehen Sie dann zu „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 Ereignis clicked_counter, 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 jetzt eine Kampagne starten, die auf Nutzer ausgerichtet ist, die wahrscheinlich text_search-Ereignisse auslösen.

8. App-Aktionskampagnen mit importierten Ereignissen starten

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

6. Rufen Sie den Tab „Kampagnen“ Ihres aktuellen Kontos auf und starten Sie eine neue Kampagne, indem Sie auf das Pluszeichen klicken. Klicken Sie auf die neue Kampagne und fahren Sie fort.
7. In diesem Fall starten wir eine App-Werbekampagne mit der Option „App-Installationen“.

8. Suchen Sie nach Ihrer App, indem Sie den App-Namen, den Paketnamen oder den Herausgeber angeben.
9. Wählen Sie im Bereich „Gebote“ im Drop-down-Menü „In-App-Aktionen“ aus, damit sich die Anzeigen auf Aktionen konzentrieren.
10. Ihre benutzerdefinierten Ereignisse finden Sie in der Liste. Legen Sie den Ziel-CPA (Cost-per-Action) fest und füllen Sie auch die anderen Optionen aus.

11. Konfigurieren Sie die Kampagneneinstellungen. Das würde den Rahmen dieses Codelabs sprengen. Weitere Informationen finden Sie in diesen Dokumenten oder wenden Sie sich über andere Kanäle an uns, um die Einstellungen zu optimieren.

9. Glückwunsch

Glückwunsch, Sie haben Firebase erfolgreich in Unity und Google Ads eingebunden. So können Sie die Kampagnenleistung steigern.

Lerninhalte

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

Referenzdokumente

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