Push-Storys

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Braze Swift SDK integrieren. Sie müssen außerdem Push-Benachrichtigungen einrichten, was die Implementierung des UNNotification-Frameworks beinhaltet.

Die folgende Mindestversion des SDK ist erforderlich, um Push-Storys zu empfangen:

Push-Storys einrichten

Schritt 1: Das Notification Content Extension-Ziel hinzufügen

Gehen Sie in Ihrem App-Projekt zum Menü File > New > Target und fügen Sie ein neues Notification Content Extension-Ziel hinzu und aktivieren Sie es.

Xcode sollte automatisch ein neues Ziel für Sie erstellen und dabei folgende Dateien generieren:

• NotificationViewController.swift
• MainInterface.storyboard

Schritt 2: Funktionen aktivieren

Fügen Sie in Xcode die Background-Modes-Funktion über den Bereich Signing & Capabilities zum Hauptziel Ihrer App hinzu. Aktivieren Sie die Kontrollkästchen Background fetch und Remote notifications.

Eine App-Gruppe hinzufügen

Fügen Sie außerdem über den Bereich Signing & Capabilities in Xcode die App-Groups-Funktion sowohl zum Hauptziel Ihrer App als auch zu den Notification Content Extension-Zielen hinzu. Klicken Sie dann auf die Schaltfläche +. Verwenden Sie die Bundle-ID Ihrer App, um die App-Gruppe zu erstellen. Wenn die Bundle-ID Ihrer App beispielsweise com.company.appname lautet, können Sie Ihre App-Gruppe group.com.company.appname.xyz nennen.

Wichtig

App-Gruppen beziehen sich in diesem Kontext auf Apples App Groups Entitlement und nicht auf Ihre Braze Workspace-ID (ehemals App-Gruppe).

Wenn Sie Ihre App nicht zu einer App-Gruppe hinzufügen, kann es sein, dass Ihre App bestimmte Felder aus dem Push-Payload nicht ausfüllen kann und nicht wie erwartet funktioniert.

Schritt 3: Das Push-Story-Framework zu Ihrer App hinzufügen

• swift-paketmanager
• cocoapods
• manuell

Nachdem Sie der Integrationsanleitung für den Swift-Paketmanager gefolgt sind, fügen Sie BrazePushStory zu Ihrer Notification Content Extension hinzu:

Fügen Sie die folgende Zeile zu Ihrem Podfile hinzu:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

target 'YourAppTarget' do
pod 'BrazeKit'
pod 'BrazeUI'
pod 'BrazeLocation'
end

target 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

Hinweis

Weitere Informationen zur Implementierung von Rich-Push-Benachrichtigungen finden Sie unter Rich-Push-Benachrichtigungen.

Navigieren Sie nach dem Aktualisieren des Podfiles in Ihrem Terminal zum Verzeichnis Ihres Xcode-App-Projekts und führen Sie pod install aus.

Laden Sie die neueste BrazePushStory.zip von der GitHub-Release-Seite herunter, entpacken Sie sie und fügen Sie das BrazePushStory.xcframework zur Notification Content Extension Ihres Projekts hinzu.

Wichtig

Stellen Sie sicher, dass Do Not Embed für BrazePushStory.xcframework in der Spalte Embed ausgewählt ist.

Schritt 4: Ihren Notification View Controller aktualisieren

Fügen Sie in NotificationViewController.swift die folgende Zeile hinzu, um die Header-Dateien zu importieren:

1

import BrazePushStory

Ersetzen Sie anschließend die Standard-Implementierung, indem Sie von BrazePushStory.NotificationViewController erben:

1

class NotificationViewController: BrazePushStory.NotificationViewController {}

Benutzerdefinierte Behandlung von Push-Story-Ereignissen

Wenn Sie Ihre eigene benutzerdefinierte Logik zur Behandlung von Push-Story-Benachrichtigungsereignissen implementieren möchten, erben Sie von BrazePushStory.NotificationViewController wie im vorherigen Beispiel gezeigt und überschreiben Sie die didReceive-Methoden wie im folgenden Beispiel.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import BrazePushStory
import UserNotifications
import UserNotificationsUI

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)

    // Custom handling logic
  }

  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)

    // Custom handling logic
  }
}

Schritt 5: Die plist der Notification Content Extension konfigurieren

Öffnen Sie die Datei Info.plist der Notification Content Extension und fügen Sie die folgenden Schlüssel unter NSExtension \ NSExtensionAttributes hinzu bzw. ändern Sie sie:

Fügen Sie außerdem das folgende Braze-Dictionary auf oberster Ebene zur selben Info.plist-Datei hinzu und ersetzen Sie REPLACE_WITH_APPGROUP durch die App-Gruppe, die Sie in Schritt 2 erstellt haben:

Ihre Info.plist-Datei sollte dem folgenden Bild entsprechen:

Schritt 6: Die Braze-Integration in Ihrer Haupt-App aktualisieren

Weisen Sie vor der Initialisierung von Braze den Namen Ihrer App-Gruppe der Eigenschaft push.appGroup Ihrer Braze-Konfiguration zu.

1
2
3
4

let configuration = Braze.Configuration(apiKey: "<YOUR-BRAZE-API-KEY>",
                                        endpoint: "<YOUR-BRAZE-ENDPOINT>")
configuration.push.appGroup = "REPLACE_WITH_APPGROUP"
let braze = Braze(configuration: configuration)