Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Warnung

Das AppboyKit (auch bekannt als Objective-C SDK) wird nicht mehr unterstützt und wurde durch das Swift SDK. ] ersetzt. Es wird keine neuen Features, Fehlerbehebungen, Sicherheitsupdates oder technischen Support mehr erhalten - Messaging und Analytics werden jedoch weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie unter Einführung in das neue Braze Swift SDK.

Die Integration abschließen

Bevor Sie diese Schritte ausführen, vergewissern Sie sich bitte, dass das SDK mit Carthage, CocoaPods, dem Swift-Paketmanager oder einer manuellen Integration integriert wurde.

Schritt 1: Aktualisieren Sie Ihren App-Delegate

objective-c
swift

Wenn Sie das Braze SDK mit CocoaPods, Carthage oder mit einer dynamischen manuellen Integration integrieren, fügen Sie die folgende Codezeile zu Ihrer AppDelegate.m-Datei hinzu:

#import "Appboy-iOS-SDK/AppboyKit.h"

Wenn Sie mit dem Swift-Paketmanager oder mit einer statischen manuellen Integration integrieren, verwenden Sie stattdessen diese Zeile:

#import "AppboyKit.h"

Fügen Sie als Nächstes in Ihrer AppDelegate.m-Datei das folgende Snippet innerhalb Ihrer application:didFinishLaunchingWithOptions:-Methode hinzu:

[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions];

Aktualisieren Sie YOUR-APP-IDENTIFIER-API-KEY mit dem korrekten Wert von Ihrer Seite Einstellungen verwalten. Weitere Informationen darüber, wo Sie Ihren App-Bezeichner-API-Schlüssel finden, finden Sie in unserer API-Dokumentation.

Wenn Sie das Braze SDK mit CocoaPods, Carthage oder mit einer dynamischen manuellen Integration integrieren, fügen Sie die folgende Codezeile zu Ihrer AppDelegate.swift-Datei hinzu:

import Appboy_iOS_SDK

Wenn Sie mit dem Swift-Paketmanager oder mit einer statischen manuellen Integration integrieren, verwenden Sie stattdessen diese Zeile:

import AppboyKit

Weitere Informationen zur Verwendung von Objective-C-Code in Swift-Projekten finden Sie in der Apple-Entwicklerdokumentation.

Fügen Sie als Nächstes in AppDelegate.swift das folgende Snippet zu Ihrer application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool-Methode hinzu:

Appboy.start(withApiKey: "YOUR-APP-IDENTIFIER-API-KEY", in:application, withLaunchOptions:launchOptions)

Hinweis

Das sharedInstance-Singleton ist nil, bevor startWithApiKey: aufgerufen wird, da dies eine Voraussetzung für die Nutzung jeglicher Braze-Funktionalität ist.

Warnung

Stellen Sie sicher, dass Sie Braze im Hauptthread Ihrer Anwendung initialisieren. Eine asynchrone Initialisierung kann zu fehlerhafter Funktionalität führen.

Schritt 2: Ihren Daten-Cluster angeben

Hinweis

Beachten Sie, dass seit Dezember 2019 keine angepassten Endpunkte mehr vergeben werden. Wenn Sie einen bereits bestehenden angepassten Endpunkt haben, können Sie diesen weiterhin verwenden. Weitere Details finden Sie in unserer Liste der verfügbaren Endpunkte.

Endpunktkonfiguration zur Kompilierzeit (empfohlen)

Wenn ein bereits bestehender angepasster Endpunkt vergeben wurde:

Ab Braze iOS SDK v3.0.2 können Sie einen angepassten Endpunkt über die Info.plist-Datei festlegen. Fügen Sie das Braze-Wörterbuch zu Ihrer Info.plist-Datei hinzu. Fügen Sie innerhalb des Braze-Wörterbuchs den Endpoint-String-Untereintrag hinzu und setzen Sie den Wert auf die Autorität der URL Ihres angepassten Endpunkts (zum Beispiel sdk.iad-01.braze.com, nicht https://sdk.iad-01.braze.com). Beachten Sie, dass vor Braze iOS SDK v4.0.2 der Wörterbuch-Schlüssel Appboy anstelle von Braze verwendet werden muss.

Ihre Braze-Vertretung sollte Sie bereits über den richtigen Endpunkt informiert haben.

Endpunktkonfiguration zur Laufzeit

Wenn ein bereits bestehender angepasster Endpunkt vergeben wurde:

Ab Braze iOS SDK v3.17.0+ können Sie Ihren Endpunkt über den ABKEndpointKey innerhalb des appboyOptions-Parameters überschreiben, der an startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions: übergeben wird. Setzen Sie den Wert auf die Autorität der URL Ihres angepassten Endpunkts (zum Beispiel sdk.iad-01.braze.com, nicht https://sdk.iad-01.braze.com).

SDK-Integration abgeschlossen

Braze sollte nun Daten aus Ihrer Anwendung erfassen, und Ihre grundlegende Integration sollte abgeschlossen sein. In den folgenden Artikeln erfahren Sie, wie Sie angepasstes Event-Tracking, Push-Messaging und die gesamte Suite der Braze-Features aktivieren.

Braze beim Start anpassen

Wenn Sie Braze beim Start anpassen möchten, können Sie stattdessen die Braze-Initialisierungsmethode startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions: verwenden und ein optionales NSDictionary mit Braze-Startschlüsseln übergeben.

objective-c
swift

Fügen Sie in Ihrer AppDelegate.m-Datei innerhalb Ihrer application:didFinishLaunchingWithOptions:-Methode die folgende Braze-Methode hinzu:

[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

Beachten Sie, dass diese Methode die Initialisierungsmethode startWithApiKey:inApplication:withLaunchOptions: ersetzt.

Fügen Sie in AppDelegate.swift innerhalb Ihrer application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool-Methode die folgende Braze-Methode hinzu, wobei appboyOptions ein Dictionary mit Startkonfigurationswerten ist:

Appboy.start(withApiKey: "YOUR-APP-IDENTIFIER-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:appboyOptions)

Beachten Sie, dass diese Methode die Initialisierungsmethode startWithApiKey:inApplication:withLaunchOptions: ersetzt.

Diese Methode wird mit den folgenden Parametern aufgerufen:

YOUR-APP-IDENTIFIER-API-KEY – Ihr App-Bezeichner-API-Schlüssel aus dem Braze-Dashboard.
application – Die aktuelle App.
launchOptions – Das Options-NSDictionary, das Sie von application:didFinishLaunchingWithOptions: erhalten.
appboyOptions – Ein optionales NSDictionary mit Startkonfigurationswerten für Braze.

Eine Liste der Braze-Startschlüssel finden Sie unter Appboy.h.

Appboy.sharedInstance() und Swift-Nullability

Abweichend von der gängigen Praxis ist das Appboy.sharedInstance()-Singleton optional. Das liegt daran, dass sharedInstance den Wert nil hat, bevor startWithApiKey: aufgerufen wird, und es einige nicht-standardmäßige, aber dennoch zulässige Implementierungen gibt, bei denen eine verzögerte Initialisierung verwendet werden kann.

Wenn Sie startWithApiKey: in Ihrem didFinishLaunchingWithOptions:-Delegate aufrufen, bevor auf Appboys sharedInstance zugegriffen wird (die Standardimplementierung), können Sie Optional Chaining verwenden, z. B. Appboy.sharedInstance()?.changeUser("testUser"), um aufwändige Prüfungen zu vermeiden. Damit erreichen Sie dasselbe Verhalten wie bei einer Objective-C-Implementierung, die von einer nicht-null sharedInstance ausgeht.

Zusätzliche Ressourcen

Die vollständige iOS-Klassendokumentation steht zur Verfügung und bietet zusätzliche Informationen zu allen SDK-Methoden.

New Stuff!