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 erstellen und folgende Dateien für Sie generieren:

• NotificationViewController.swift
• MainInterface.storyboard

Schritt 2: Funktionen aktivieren

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

Eine App-Gruppe hinzufügen

Fügen Sie zusätzlich über den Bereich Signing & Capabilities in Xcode die Funktion „App Groups“ 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 Zusammenhang 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 vorkommen, dass Ihre App bestimmte Felder aus der Push-Payload nicht korrekt befüllt und nicht wie erwartet funktioniert.

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

• swift-paketmanager
• cocoapods
• manuell

Nachdem Sie der Swift-Paketmanager-Integrationsanleitung 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

Anleitungen zur Implementierung von Rich-Push-Benachrichtigungen finden Sie unter Rich-Benachrichtigungen.

Navigieren Sie nach dem Aktualisieren des Podfile 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 als Nächstes die Standardimplementierung, 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 diese:

Fügen Sie außerdem das folgende Braze-Dictionary auf der obersten Ebene derselben 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)