Umfangreiche Push-Benachrichtigungen

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Swift Braze SDK integrieren. Sie müssen auch Push-Benachrichtigungen einrichten.

Einrichten von Rich-Push-Benachrichtigungen

Schritt 1: Erstellen einer Diensterweiterung

Um eine Benachrichtigungsdienst-Erweiterung zu erstellen, navigieren Sie in Xcode zu File > New > Target und wählen Sie Notification Service Extension aus.

Stellen Sie sicher, dass Embed In Application so eingestellt ist, dass die Erweiterung in Ihre Anwendung eingebettet wird.

Schritt 2: Einrichten der Benachrichtigungsdienst-Erweiterung

Eine Benachrichtigungsdienst-Erweiterung ist eine eigene Binärdatei, die mit Ihrer App gebündelt wird. Sie muss im Apple Developer Portal mit einer eigenen App-ID und einem eigenen Bereitstellungsprofil eingerichtet werden.

Die Bundle-ID der Benachrichtigungsdienst-Erweiterung muss sich von der Bundle-ID Ihres Haupt-App-Ziels unterscheiden. Wenn die Bundle-ID Ihrer App beispielsweise com.company.appname lautet, können Sie com.company.appname.AppNameServiceExtension für Ihre Diensterweiterung verwenden.

Schritt 3: Hinzufügen einer App-Gruppe

Fügen Sie in Xcode die Funktion „App Groups“ aus dem Bereich Signing & Capabilities sowohl zu Ihrem Haupt-App-Ziel als auch zum Ziel der Notification Service Extension 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 die App Groups Entitlement von Apple und nicht auf die ID Ihres Braze Workspace (früher App-Gruppe).

Sie benötigen eine gemeinsame App-Gruppe, damit Ihre Haupt-App und die Benachrichtigungsdienst-Erweiterung auf gemeinsame Daten zugreifen können. Wenn Sie Ihre App nicht zu einer App-Gruppe hinzufügen, kann es vorkommen, dass Ihre App bestimmte Felder aus der Push-Nutzlast nicht ausfüllt und nicht vollständig wie erwartet funktioniert.

Schritt 4: Integration von Rich-Push-Benachrichtigungen

Eine Schritt-für-Schritt-Anleitung zur Integration von Rich-Push-Benachrichtigungen mit BrazeNotificationService finden Sie in unserem Tutorial.

Ein Beispiel finden Sie in der Verwendung von NotificationService in unserer Beispiel-App.

Rich-Push-Framework zu Ihrer App hinzufügen

• swift package manager
• cocoapods
• manual

Nachdem Sie die Anleitung zur Integration des Swift-Paketmanagers befolgt haben, fügen Sie BrazeNotificationService zu Ihrer Notification Service Extension hinzu, indem Sie wie folgt vorgehen:

1. Wählen Sie in Xcode unter Frameworks und Bibliotheken das Symbol aus, um ein Framework hinzuzufügen.
   
   
   
   

2. Wählen Sie das Framework „BrazeNotificationService“ aus.
   
   

Fügen Sie Folgendes 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
  pod 'BrazePushStory'
end

Hinweis

Anweisungen zur Implementierung von Push Stories finden Sie in der Dokumentation.

Nachdem Sie das Podfile aktualisiert haben, navigieren Sie in Ihrem Terminal zum Verzeichnis Ihres Xcode-App-Projekts und führen Sie pod install aus.

Um BrazeNotificationService.xcframework zu Ihrer Notification Service Extension hinzuzufügen, siehe Manuelle Integration.

Verwendung Ihrer eigenen UNNotificationServiceExtension

Wenn Sie Ihre eigene UNNotificationServiceExtension verwenden müssen, können Sie stattdessen brazeHandle in Ihrer didReceive-Methode aufrufen.

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

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(
    _ request: UNNotificationRequest,
    withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
  ) {
    if brazeHandle(request: request, contentHandler: contentHandler) {
      return
    }

    // Custom handling here

    contentHandler(request.content)
  }
}

Schritt 5: Konfigurieren der App-Gruppe in Braze

Weisen Sie vor der Initialisierung von Braze der Eigenschaft push.appGroup Ihrer Braze-Konfiguration den Namen Ihrer App-Gruppe 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)

Schritt 6: Erstellen einer Rich-Benachrichtigung in Ihrem Dashboard

Ihr Marketing-Team kann Rich-Benachrichtigungen auch über das Dashboard erstellen. Erstellen Sie eine Push-Benachrichtigung über den Push-Composer und fügen Sie ein Bild oder GIF hinzu, oder geben Sie eine URL an, unter der ein Bild, GIF oder Video gehostet wird. Beachten Sie, dass Assets beim Empfang von Push-Benachrichtigungen heruntergeladen werden. Planen Sie daher große, synchrone Spitzen bei Anfragen ein, wenn Sie Ihre Inhalte selbst hosten.