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

1. Einführung

Zuletzt aktualisiert: 19.02.2021

Umfang

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

In diesem Codelab können Sie den gesamten Prozess des App-Geschäfts durchlaufen, mit dem unsere Kunden konfrontiert sind. Wenn Sie eine sanftere Einführung in Firebase und AdMob unter iOS wünschen, beginnen Sie mit AdMob+Firebase 101 Unity: Setup & Analytics Basics.

Lerninhalte

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

Voraussetzungen

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

2. Neues Unity-Projekt starten

Erstellen Sie eine einfache Unity-App auf Grundlage einer Vorlage. Sie modifizieren 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 3D-Vorlagen aus.
3. Geben Sie einen Namen für das Projekt 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 Workspace-Fenster.

3. Firebase-Projekt erstellen und einrichten

Um mit Firebase zu beginnen, 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 der 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

4. Unity-Konfiguration

1. Wählen Sie in Unity „File“ > „Build Settings“ aus. Wichtig ist, dass Sie die iOS-Bundle-ID festlegen, die Sie im nächsten Schritt erhalten.

Sie sehen das im folgenden Screenshot dargestellte Dialogfeld.

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

3. Klicken Sie nach der Plattformänderung auf die Schaltfläche „Player Settings“ (Playereinstellungen), um die Bundle-ID festzulegen. Das Textfeld wird um den Bereich Identifizierung angezeigt.
4. Der Wert des Felds „Bundle Identifier“ ist die iOS-Bundle-ID (z. B. com.yourcompany.yourproject). Kopieren Sie diesen Wert oder legen Sie einen 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 App registrieren.
7. Folgen Sie in Firebase der Anleitung, um die Konfigurationsdatei GoogleService-Info.plist herunterzuladen.
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ü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 jederzeit zum Einrichtungsablauf zurückkehren, um das andere Build-Ziel zu registrieren.

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

• Für 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 finde ich die ID meines Unity-Projekts?

Hinweis:Achten Sie darauf, dass Sie die ID eingeben, die tatsächlich für Ihr Projekt verwendet wird. 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 die plattformspezifischen Aliasnamen Ihres Unity-Projekts ein. Diese Aliasse sind interne, praktische 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 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 > Import Package > Custom Package auf.
3. Wählen Sie im entpackten SDK die unterstützten Firebase-Produkte aus, die Sie in Ihrer App verwenden möchten.

• Firebase-Paket für Google Analytics hinzufügen: 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: FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

Unity 5.x und früher 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 in Ihrem Unity-Projekt .NET 4.x verwendet wird, 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 auf Import.
5. Klicken Sie in der Firebase Console im Einrichtungs-Workflow auf Weiter.

Wichtig:Beim Firebase Unity SDK für iOS darf die Method-Swizzling nicht deaktiviert werden. Swizzling ist für das SDK erforderlich. Ohne Swizzling funktionieren wichtige Firebase-Funktionen (z. B. die FCM-Token-Verarbeitung) 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 protokollieren.

Firebase Analytics protokolliert einige Ereignisse automatisch. Sie müssen also keinen Code hinzufügen, um sie zu erhalten. Wenn in Ihrer App zusätzliche Daten erfasst werden müssen, 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 mit der Methode „logEvent()“ beginnen, Ereignisse zu protokollieren.

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

Ereignisse in der Xcode-Debugkonsole ansehen

Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Das gilt sowohl für automatisch als auch für 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 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

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

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

Auf dem Tab „Conversions“ in Firebase Analytics können Sie noch einmal prüfen, ob das Ereignis erfolgreich als Conversion markiert wurde. 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 Einrichtung von Firebase für iOS 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 den Button 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 abgeschlossen.

Rufen Sie Google Ads auf und melden Sie sich an.

1. Rufen Sie Google Ads auf, melden Sie sich an und gehen Sie zu „Tools und Einstellungen“ → „Messung“ → „Conversions“, um benutzerdefinierte Ereignisse als Conversion 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, die wahrscheinlich text_search-Ereignisse auslösen.

8. App-Aktionskampagnen mit importierten Ereignissen starten

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

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 dieser Zeit 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 Publisher angeben.
9. Wählen Sie im Bereich „Gebote“ im Drop-down-Menü für Anzeigen die Option „In-App-Aktionen“ aus, um den Schwerpunkt auf Aktionen zu legen.
10. Benutzerdefinierte Ereignisse finden Sie in der bereitgestellten 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 geht über den Umfang dieses Codelabs hinaus. Weitere Informationen finden Sie in den folgenden Dokumenten. Sie können sich auch über andere Kanäle an uns wenden, um Einstellungen zu optimieren.

9. Glückwunsch

Herzlichen Glückwunsch! Sie haben Firebase erfolgreich in Unity und Google Ads eingebunden. So können Sie 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 aktionsorientierte Kampagnen verwenden

Referenzdokumente

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