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

Erstellen Sie eine einfache Vorlage für eine iOS Swift-App. Sie ändern diese Starter-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 Bereich „Anwendung“ die Option „App“ aus und klicken Sie auf „Weiter“.
4. Geben Sie im angezeigten Dialogfeld die folgenden Werte ein, um Ihre App zu benennen und zusätzliche Optionen für Ihr Projekt auszuwählen. Klicken Sie dann auf „Weiter“:
5. Produktname: z. B. ios-app

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

2. Team: Wenn dieses Feld nicht automatisch ausgefüllt wird, setzen Sie „Kein“ für das Team ein.
3. Name der Organisation: Der Name Ihrer Organisation oder Ihr eigener Name.
4. Bundle-ID: Dieser Wert wird automatisch anhand des Produktnamens und der 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 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 als Namen für Ihr Firebase-Projekt „Firebase-iOS-Ads“ ein.

2. Klicken Sie sich durch die Optionen für die 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. Firebase-Konfiguration

1. Wählen Sie in der Firebase Console links in der Navigationsleiste „Projektübersicht“ > „Projekteinstellungen“ aus und klicken Sie dann unter „Allgemein“ > „Meine Apps“ auf die Schaltfläche für iOS.

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 Projekt-Navigator die App der obersten Ebene und dann den Tab „Allgemein“ aus.
4. Der Wert des Felds „Bundle-ID“ ist die iOS-Bundle-ID (z. B. 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 App registrieren.
7. Folgen Sie in Firebase der Anleitung, um die Konfigurationsdatei herunterzuladen.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 Ihrem 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 wechseln Sie zum Verzeichnis mit dem Xcode-Projekt für Ihre App.
2. Erstellen Sie eine Podfile-Datei, falls keine vorhanden ist:

$ pod init

3. Öffnen Sie Ihre 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! Rufen Sie die Console auf.

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

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

Standardmäßige Ereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter für mehrere Ereignisse protokollieren. Standardparameter werden mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

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

Ereignisse in der Xcode-Fehlerbehebungskonsole 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 protokollierte 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 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 nach 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 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 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 ein 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. 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 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 das Kästchen und dann 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: Wenn Sie eine App-Kampagne starten möchten, benötigen Sie eine App auf Produktionsebene bei Google Play. 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 App-Namen, 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 füllen Sie auch die anderen Optionen aus.

11. Kampagneneinstellungen konfigurieren 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 und Google Ads erfolgreich eingebunden. So lässt sich die Kampagnenleistung steigern.

Sie haben das Script installiert, eine neue Codelab-Änderungsliste erstellt und bereitgestellt, die ausstehende Codelab-Änderungsliste aktualisiert und bereitgestellt, die Codelab-Änderungsliste geprü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 erfassen
• Ereignisse importieren und für aktionsfördernde Kampagnen verwenden