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

1. Einführung

Zuletzt aktualisiert: 14.12.2020

Umfang

In diesem Codelab erfahren Sie, wie Sie benutzerdefinierte Ereignisse mit dem GA4F iOS SDK 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 iOS wünschen, beginnen Sie mit dem Firebase iOS Codelab (Swift).

Lerninhalte

• 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 iOS-Swift-App auf Grundlage einer Vorlage. Sie modifizieren diese Starter-App, um die fertige App zu erstellen.

Öffnen Sie zuerst Xcode.

1. Wenn Sie keine offenen Projekte haben, wählen Sie auf der Startseite „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 dann auf „Weiter“.
4. Geben Sie im Dialogfeld, das sich öffnet, 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, legen Sie das Team auf „None“ (Kein Team) fest.
3. Name der Organisation: Der Name Ihrer Organisation oder Ihr eigener Name.
4. Bundle-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 das neue Projekt im Arbeitsbereichfenster.

3. Firebase-Projekt erstellen und einrichten

Um mit Firebase zu beginnen, müssen Sie 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 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. Firebase-Konfiguration

1. Wählen Sie in der Firebase Console im linken Navigationsbereich „Projektübersicht“ > „Projekteinstellungen“ aus und klicken Sie dann unter „Allgemein“ > „Ihre Apps“ auf die Schaltfläche „iOS“.

Sie sehen das im folgenden Screenshot dargestellte Dialogfeld.

2. Der wichtige Wert, den Sie angeben müssen, ist die iOS-Bundle-ID, die Sie im nächsten Schritt erhalten.
3. Wählen Sie in Ihrem Xcode-Projekt für die iOS-App im Projektnavigator die App der obersten Ebene und dann den Tab „General“ (Allgemein) aus.
4. Der Wert des Felds „Bundle Identifier“ (Paket-Identifikator) ist die iOS-Paket-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 GoogleService-Info.plist herunterzuladen.

8. Rufen Sie Ihr Xcode-Projekt auf und verschieben Sie die soeben heruntergeladene Datei GoogleService-Info.plist in den Xcode-Projektstamm.
9. Überspringen Sie die restlichen Schritte und kehren Sie zur Hauptseite der Firebase Console zurück.

5. Analytics for Firebase in Xcode konfigurieren

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

Hinweis:Bei Google-Diensten werden Abhängigkeiten mithilfe von CocoaPods installiert und verwaltet. 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 den folgenden Befehl aus :

$ pod install

5. Initialisierungscode hinzufügen :

Fügen Sie der 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 einige benutzerdefinierte Ereignisprotokolle auslösen.

6. Benutzerdefinierte Ereignisse mit Firebase Analytics erfassen

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

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

Standard-Ereignisparameter festlegen

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

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

Ereignisse in der Xcode-Debug-Konsole 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 App-Kampagnen mehr über Zielgruppen erfahren und die Kampagnenleistung steigern. 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 text_search-Ereignisse wahrscheinlich 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 Rahmen dieses Codelabs hinaus. Weitere Informationen finden Sie in den folgenden Dokumenten oder wenden Sie sich über andere Kanäle an uns, um die Einstellungen zu optimieren.

9. Glückwunsch

Herzlichen Glückwunsch! Sie haben Firebase und Google Ads erfolgreich verknüpft. So können Sie 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 erfassen
• Ereignisse importieren und für Aktionskampagnen verwenden