Stille 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.

iOS-Einschränkungen

Das iOS-Betriebssystem kann Benachrichtigungen für einige Features einschränken. Sollten Sie Schwierigkeiten mit diesen Features haben, könnte das iOS-Gate für stille Benachrichtigungen die Ursache sein. Weitere Einzelheiten finden Sie in der Dokumentation zu Apples Instanz-Methode und nicht empfangenen Benachrichtigungen.

Stille Push-Benachrichtigungen einrichten

Wenn Sie stille Push-Benachrichtigungen verwenden möchten, um Aufgaben im Hintergrund zu triggern, müssen Sie Ihre App so konfigurieren, dass sie auch dann Benachrichtigungen erhält, wenn sie sich im Hintergrund befindet. Fügen Sie dazu die Funktion „Background Modes“ über den Bereich Signing & Capabilities zum Haupt-App-Target in Xcode hinzu. Aktivieren Sie das Kontrollkästchen Remote notifications.

Auch wenn der Hintergrundmodus für Remote-Benachrichtigungen aktiviert ist, startet das System Ihre App nicht im Hintergrund, wenn Nutzer:innen das Beenden der Anwendung erzwungen haben. Nutzer:innen müssen die Anwendung explizit starten oder das Gerät neu starten, bevor die App vom System automatisch im Hintergrund gestartet werden kann.

Weitere Informationen finden Sie unter Pushing Background Updates und in der Dokumentation zu application:didReceiveRemoteNotification:fetchCompletionHandler:.

Stille Push-Benachrichtigungen senden

Um eine stille Push-Benachrichtigung zu senden, setzen Sie das Flag content-available in der Nutzlast einer Push-Benachrichtigung auf 1.

Hinweis

Was Apple als Remote-Benachrichtigung bezeichnet, ist eine normale Push-Benachrichtigung, bei der das Flag content-available gesetzt ist.

Das content-available-Flag kann sowohl im Braze-Dashboard als auch in unserem Apple-Push-Objekt in der Messaging-API gesetzt werden.

Warnung

Es wird davon abgeraten, sowohl einen Titel als auch einen Textkörper mit content-available=1 anzuhängen, da dies zu undefiniertem Verhalten führen kann. Um sicherzustellen, dass eine Benachrichtigung wirklich still ist, schließen Sie sowohl den Titel als auch den Text aus, wenn Sie das content-available-Flag auf 1 setzen. Weitere Einzelheiten finden Sie in der offiziellen Apple-Dokumentation über Hintergrundaktualisierungen.

Wenn Sie eine stille Push-Benachrichtigung senden, möchten Sie vielleicht auch einige Daten in die Nutzlast der Benachrichtigung aufnehmen, damit Ihre Anwendung auf das Ereignis verweisen kann. Dies könnte Ihnen einige Netzwerkanfragen ersparen und die Reaktionsfähigkeit Ihrer App verbessern.

Interne Push-Benachrichtigungen ignorieren

Braze verwendet stille Push-Benachrichtigungen, um bestimmte fortgeschrittene Features wie Uninstall-Tracking intern zu verwalten. Wenn Ihre App beim Starten der Anwendung oder bei Push-Nachrichten im Hintergrund automatische Aktionen ausführt, sollten Sie diese Aktivitäten so steuern, dass sie nicht durch interne Push-Benachrichtigungen ausgelöst werden.

Wenn Sie beispielsweise eine Logik haben, die Ihre Server bei jedem Hintergrund-Push oder Anwendungsstart nach neuen Inhalten fragt, möchten Sie vielleicht verhindern, dass die internen Pushs von Braze ausgelöst werden, um unnötigen Netzwerkverkehr zu vermeiden. Da Braze bestimmte Arten von internen Pushs an alle Nutzer:innen ungefähr zur gleichen Zeit sendet, kann es zu einer erheblichen Serverbelastung kommen, wenn die Netzwerkaufrufe beim Start von internen Pushs nicht eingeschränkt werden.

1. Schritt: Überprüfen Sie Ihre App auf automatische Aktionen

Überprüfen Sie Ihre Anwendung an den folgenden Stellen auf automatische Aktionen und aktualisieren Sie Ihren Code, um die internen Pushs von Braze zu ignorieren:

1. Push-Empfänger. Push-Benachrichtigungen im Hintergrund rufen application:didReceiveRemoteNotification:fetchCompletionHandler: auf dem UIApplicationDelegate auf.
2. Application Delegate. Pushs im Hintergrund können angehaltene Apps im Hintergrund starten und dabei die Methoden application:willFinishLaunchingWithOptions: und application:didFinishLaunchingWithOptions: auf Ihrem UIApplicationDelegate triggern. Überprüfen Sie die launchOptions dieser Methoden, um festzustellen, ob die Anwendung durch einen Push im Hintergrund gestartet wurde.

2. Schritt: Verwenden Sie die interne Push-Utility-Methode

Sie können die statische Utility-Methode in Braze.Notifications verwenden, um zu überprüfen, ob Ihre App einen internen Push von Braze erhalten hat oder von diesem gestartet wurde. Braze.Notifications.isInternalNotification(_:) liefert true für alle internen Push-Benachrichtigungen von Braze, einschließlich Uninstall-Tracking und Feature-Flags-Synchronisierungsbenachrichtigungen.

Zum Beispiel:

• swift
• objective-c

1
2
3
4
5
6
7
func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if (!Braze.Notifications.isInternalNotification(userInfo)) {
    // Gated logic here (for example pinging server for content)
  }
}

1
2
3
4
5
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
  if (![BRZNotifications isInternalNotification:userInfo]) {
    // Gated logic here (for example pinging server for content)
  }
}