Umfangreiche Push-Benachrichtigungen

Voraussetzungen

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

Rich-Push-Benachrichtigungen einrichten

Schritt 1: Dienst-Erweiterung 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-Targets unterscheiden. Wenn die Bundle-ID Ihrer App beispielsweise com.company.appname lautet, können Sie com.company.appname.AppNameServiceExtension für Ihre Dienst-Erweiterung verwenden.

Schritt 3: App-Gruppe hinzufügen

Fügen Sie in Xcode die App-Groups-Funktion im Bereich Signing & Capabilities sowohl zu Ihrem Haupt-App-Target als auch zum Benachrichtigungsdienst-Erweiterungs-Target hinzu. Klicken Sie dann auf den +-Button. 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).

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 Ihre App möglicherweise bestimmte Felder aus der Push-Payload nicht befüllen und funktioniert nicht vollständig wie erwartet.

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 Folgendes tun:

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

Eine Anleitung 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ü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: App-Gruppe in Braze konfigurieren

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)

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 gehostetem Content mit großen, synchronen Anfragespitzen rechnen.