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.

Rich-Push-Benachrichtigungen einrichten

Schritt 1: Diensterweiterung erstellen

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: Benachrichtigungsdienst-Erweiterung einrichten

Eine Benachrichtigungsdienst-Erweiterung ist eine eigenständige 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: App-Gruppe hinzufügen

Fügen Sie in Xcode die App-Groups-Berechtigung im Bereich Signing & Capabilities sowohl zu Ihrem Haupt-App-Ziel als auch zum Benachrichtigungsdienst-Erweiterungsziel 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 (früher App-Gruppen-ID).

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-Payload nicht befüllen kann und nicht wie erwartet funktioniert.

Schritt 4: Rich-Push-Benachrichtigungen integrieren

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.

Das Rich-Push-Framework zu Ihrer App hinzufügen

• swift-paketmanager
• cocoapods
• manuell

Nachdem Sie die Integrationsanleitung für den Swift-Paketmanager befolgt haben, fügen Sie BrazeNotificationService zu Ihrer Notification Service Extension hinzu, indem Sie folgende Schritte ausführen:

1. Wählen Sie in Xcode unter „Frameworks and Libraries“ 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

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

Navigieren Sie nach dem Aktualisieren des Podfiles 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, lesen Sie Manuelle Integration.

Eigene UNNotificationServiceExtension verwenden

Wenn Sie Ihre eigene UNNotificationServiceExtension verwenden möchten, 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: App-Gruppe in Braze konfigurieren

Bevor Sie Braze initialisieren, weisen Sie 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)

Schritt 6: Rich-Benachrichtigung im Dashboard erstellen

Ihr Marketing-Team kann auch Rich-Benachrichtigungen über das Dashboard erstellen. Erstellen Sie eine Push-Benachrichtigung über den Push-Composer und hängen Sie ein Bild oder GIF an, oder geben Sie eine URL an, die ein Bild, GIF oder Video hostet. Beachten Sie, dass Assets beim Empfang von Push-Benachrichtigungen heruntergeladen werden. Sie sollten daher bei selbst gehosteten Inhalten mit großen, synchronen Anfragespitzen rechnen.