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

1. Einführung

Zuletzt aktualisiert:14.12.2020

Inhalt

In diesem Codelab erfahren Sie, wie Sie benutzerdefinierte Ereignisse mit dem GA4F iOS SDK 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 du eine sanftere Einführung in Firebase iOS erhalten möchtest, beginne mit Firebase iOS Codelab Swift

Aufgaben in diesem Lab

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

Voraussetzungen

• Xcode
• Firebase-Konto
• Google Ads-Konto

2. Neues iOS Swift-Projekt starten

Einfache Vorlagen-App für iOS Swift erstellen Sie ändern diese Start-App, um die fertige App zu erstellen.

Starten Sie zuerst Xcode.

1. Wenn Sie keine offenen Projekte haben, wählen Sie auf der Begrüßungsseite „Create a new Xcode project“ (Neues Xcode-Projekt erstellen) aus.
2. Wählen Sie oben im Dialogfeld iOS aus.
3. Wählen Sie im Abschnitt „Anwendung“ die Option „App“ aus und klicken Sie dann auf „Weiter“.
4. Geben Sie im angezeigten Dialogfeld die folgenden Werte ein, um Ihre App zu benennen, wählen Sie zusätzliche Optionen für Ihr Projekt aus und klicken Sie auf Next (Weiter):
5. Produktname: z.B. iOS-App

Xcode verwendet den von Ihnen eingegebenen Produktnamen, um Ihr Projekt und die App zu benennen.

2. Team: Falls dieses Feld nicht automatisch ausgefüllt wird, setzen Sie das Team auf Keine.
3. Name der Organisation: Der Name Ihrer Organisation oder Ihr eigener Name.
4. Paket-ID: Dieser Wert wird automatisch anhand Ihres Produktnamens und Ihrer Organisations-ID generiert.
5. Sprache: Swift
6. Wählen Sie einen Speicherort für Ihr Projekt aus und klicken Sie auf „Erstellen“.
7. Xcode öffnet Ihr neues Projekt im Arbeitsbereichsfenster.

3. Firebase-Projekt erstellen und einrichten

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

Firebase-Projekt erstellen

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. Firebase-Konfiguration

1. Wählen Sie in der Firebase Console die Option "Projektübersicht" > Projekteinstellungen im linken Navigationsbereich, dann klicken Sie auf die iOS-Schaltfläche unter Allgemein > Meine Apps

Das Dialogfeld erscheint auf dem folgenden Bildschirm.

2. Der wichtige Wert ist die iOS-Paket-ID, die Sie im folgenden Schritt abrufen.
3. Wählen Sie in Ihrem Xcode-Projekt für die iOS-App im Projektnavigator die App der obersten Ebene und dann den Tab „Allgemein“ aus.
4. Der Wert des Felds „Bundle Identifier“ (Paket-Identifikator) ist die iOS-Bundle-ID (etwa com.yourcompany.yourproject). Kopieren Sie diesen Wert.
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. Rufen Sie Ihr Xcode-Projekt auf und verschieben Sie die soeben heruntergeladene Datei GoogleService-Info.plist in das Stammverzeichnis Ihres Xcode-Projekts.
9. Überspringen Sie die restlichen Schritte und kehren Sie zur Hauptseite der Firebase Console zurück.

5. Firebase Analytics in Xcode konfigurieren

In diesem Schritt fügen Sie dem Xcode-Projekt das Firebase SDK hinzu.

Hinweis:In Google-Diensten werden CocoaPods verwendet, um Abhängigkeiten zu installieren und zu verwalten. Wenn Sie CocoaPods noch nie verwendet haben, müssen Sie es zuerst installieren. Führen Sie dazu den folgenden Befehl in Ihrem Terminal aus:

$ sudo gem install cocoapods

1. Öffnen Sie ein Terminalfenster und gehen Sie zum Speicherort des Xcode-Projekts für Ihre App.
2. Erstellen Sie eine Podfile-Datei, falls keine vorhanden ist:

$ pod init

3. Öffnen Sie die Podfile-Datei und fügen Sie Folgendes hinzu :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Speichern Sie die Datei und führen Sie folgenden Befehl aus :

$ pod install

5. Initialisierungscode hinzufügen :

Fügen Sie Ihrer AppDelegate-Hauptklasse den folgenden Initialisierungscode hinzu, damit beim Start Ihrer App eine Verbindung zu Firebase hergestellt wird.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Fertig! Weiter zur Konsole.

Jetzt können Sie benutzerdefinierte Ereignisprotokolle auslösen.

6. Benutzerdefinierte Ereignisse mit Firebase Analytics protokollieren

In diesem Schritt erfahren Sie, wie Sie benutzerdefinierte Ereignisse mit Firebase Analytics in der 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.

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Standardmäßige Ereignisparameter festlegen

Mit „setDefaultEventParameters“ können Sie Parameter ereignisübergreifend protokollieren. Standardparameter sind allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Ereignisse in der Xcode Debug Console 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

Sie haben Firebase und Google Ads erfolgreich integriert. So lässt sich die Kampagnenleistung steigern.

Sie haben das Skript installiert, eine neue Codelab-Änderungsliste erstellt und bereitgestellt, die ausstehende Codelab-Änderungsliste aktualisiert und bereitgestellt, die Codelab-Änderungsliste überprüft und genehmigt sowie die Codelab-Änderungsliste eingereicht und veröffentlicht.

Sie haben gelernt,

• Firebase für iOS konfigurieren
• Benutzerdefinierte Ereignisse mit iOS und Firebase Analytics protokollieren
• Ereignisse importieren und für Aktionskampagnen verwenden