Umfangreiche Push-Benachrichtigungen

Voraussetzungen

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

Einrichten von Rich-Push-Benachrichtigungen

Schritt 1: Erstellen einer Serviceerweiterung

Um eine Benachrichtigungsdienst-Erweiterung zu erstellen, navigieren Sie in Xcode zu „Datei“ > „Neu“ > „Ziel“ und wählen Sie „Benachrichtigungsdienst-Erweiterung“.

Vergewissern Sie sich, dass In Anwendung einbetten so eingestellt ist, dass die Erweiterung in Ihre Anwendung eingebettet wird.

Schritt 2: Einrichtung des Benachrichtigungsdienstes

Eine Erweiterung für einen Benachrichtigungsdienst 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 Erweiterung des Benachrichtigungsdienstes muss sich von der Bundle-ID Ihres App-Hauptziels für die App unterscheiden. Wenn die Bundle-ID Ihrer App zum Beispiel 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-Gruppen“ aus dem Bereich „Signing&Capabilities“ zu Ihrem Haupt-App-Ziel sowie zum Ziel „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 die App-Gruppe group.com.company.appname.xyz nennen.

Wichtig

App-Gruppen beziehen sich in diesem Zusammenhang auf die App-Gruppen-Berechtigung von Apple und nicht auf die ID Ihres Braze-Arbeitsbereichs (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 findenBrazeNotificationService Sie in unserem Tutorial.

Ein Beispiel wird in der Verwendung inNotificationServiceunserer Beispiel-App referenziert.

Rich-Push-Benachrichtigung 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 Ihrem Notification Service Extension hinzu, indem Sie wie folgt vorgehen:

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

2. Bitte wählen Sie das Framework „BrazeNotificationService“ aus.
   
   

Fügen Sie Folgendes zu Ihrer 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-Storys finden Sie in der Dokumentation.

Nachdem Sie das Podfile aktualisiert haben, wechseln Sie in Ihrem Terminal in das 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: Konfiguration der App-Gruppe in Braze

Weisen Sie vor der Initialisierung von Braze der Eigenschaft push.appGroup der 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 umfangreichen Benachrichtigung in Ihrem Dashboard

Ihr Marketing-Team kann auch Rich-Benachrichtigungen ü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 also große, synchrone Spitzen bei Anfragen ein, wenn Sie Ihre Inhalte hosten.