Verstehe Push-Benachrichtigung Zustellung
Erfahre mehr über die Push-Benachrichtigung Zustellung, einschließlich wie sie zugestellt wird und warum sie scheitern kann.
Push-Benachrichtigung Zustellung
Die Zustellung einer Push-Benachrichtigung bezieht sich darauf, dass eine Push-Benachrichtigung erfolgreich an das Gerät der Empfänger*innen zugestellt wird.
Ein Profil kann mehr als 1 Push-Token haben, wenn die Person deine mobile App auf mehreren Geräten installiert hat. Push-Benachrichtigung wird für alle Geräte mit einem Token Laden auf dem Profil versucht.
Das Konzept der Zustellbarkeit gilt für Push-Benachrichtigung nicht wie für E-Mail, da keine Sortierung vorgenommen wird, sobald das Gerät der*des Empfänger*in die Benachrichtigung erfolgreich empfängt.
Wenn du eine Push-Benachrichtigung über eine Kampagne oder einen Flow sendest, prüft Klaviyo die Push-Benachrichtigung und sendet sie dann an den Apple Push-Nachrichtendienst (APNs) für iOS oder den Push-Nachrichtendienst von Android, Firebase Cloud Messaging (FCM) für Zustellung an das Gerät des Empfängers. Es kann vorkommen, dass einige Push-Benachrichtigungen übersprungen werden, wenn es ein Problem mit der Zustellung gibt.
APNs und FCM akzeptieren entweder die Benachrichtigung und versuchen, sie an das Gerät der Empfänger*in zuzustellen, oder lehnen die Benachrichtigung mit einer Reihe möglicher Fehler ab.
Klaviyo hat nur Erkenntnisse darüber, ob diese Services die Benachrichtigung akzeptieren oder ablehnen. Klaviyo kann nicht bestätigen, ob die Benachrichtigung fehlschlägt, nachdem APNs oder FCM den Push akzeptiert haben.
Möchtest du eine Funktion für Klaviyo Push-Benachrichtigung beantragen? Fülle dieses Google-Formular aus, um uns davon zu erzählen!
Gründe für die Ablehnung
Wenn Klaviyo nach dem Senden einer Benachrichtigung eine Fehlerantwort von APNs oder FCM erhält, wird für jedes Token, das von der fehlgeschlagenen Zustellung betroffen ist, ein Ereignis namens Unzustellbare Push-Benachrichtigung erstellt. Dies wird im Aktivitätsfeed des empfangenden Profils zusammen mit der Empfänger*innenaktivität für den jeweiligen Flow oder die jeweilige Kampagne angezeigt, aus dem bzw. der die Benachrichtigung gesendet wurde.
Das Ereignis Bounced push enthält Metadaten, die die Fehlercode-Nachricht (z. B. ExpiredToken) zeigen, die von APNs oder Firebase zurückgegeben wurde. Wenn du Zustellprobleme feststellst, arbeite mit deiner App-Entwickler*in zusammen, um den Fehler anhand der Beschreibung im Ereignis zu beheben.
Um die Metadaten für ein Event anzuzeigen, klicke im Aktivitätsprotokoll des Profils beim Event auf Aktivitätsdetails.
Silent Push
Du kannst die Zustellrate und Bounce-Rate für einzelne stille Push-Benachrichtigungen sehen; stille Push-Benachrichtigungen sind jedoch in Klaviyo von allen aggregierten Performance-Reportings ausgeschlossen. Dazu zählen beispielsweise Mobile Push-Öffnungsraten im Zeitverlauf, da sie keine Öffnungen oder Conversions haben.
Bitte beachte, dass du für Silent Push andere Events als für Standard-Push siehst, nämlich Silent Push empfangen und Silent Push zurückgewiesen.
Wenn es Probleme mit der Zustellung von stillen Push-Benachrichtigungen unter iOS gibt, beachte, dass iOS die Zustellung von stillen Push-Benachrichtigungen nicht garantiert. Sie werden möglicherweise abhängig vom aktuellen Zustand des Geräts nicht zugestellt, z. B. je nach Akkustand und Netzwerkverbindung.
iOS
Bei iOS-Push-Benachrichtigungen, die über APNs gesendet werden, kann es aus mindestens einem der in Apples Referenz zum Umgang mit Benachrichtigungsantworten von APNs aufgeführten Gründe zu Ablehnungen kommen.
Statuscode | APNs-Fehlerzeichenfolge | APNs-Beschreibung |
400 | BadDeviceToken | Das angegebene Gerätetoken war ungültig. Stelle sicher, dass die Anfrage ein gültiges Token enthält und dass das Token mit der Umgebung übereinstimmt. |
400 | Ungültiges Thema | Der apns-topic-Wert ist ungültig. |
400 | DeviceTokenNotForTopic | Das Gerätetoken stimmt nicht mit dem angegebenen Topic überein. |
400 | DuplicateHeaders | Eine oder mehrere Kopfzeilen wurden wiederholt. |
400 | IdleTimeout | Timeout bei Inaktivität. |
400 | Ungültiger Push-Typ | Der Wert für apns-push-type ist ungültig. |
400 | PayloadEmpty | Die Payload der Nachricht war leer. |
403 | Ungültiges Zertifikat | Das Zertifikat war ungültig. |
403 | Schlechte Zertifikatsumgebung | Das Client-Zertifikat war für die falsche Umgebung. |
403 | Ungültiges Anbietertoken | Das Provider-Token ist nicht gültig oder die Token-Signatur konnte nicht verifiziert werden. |
404 | BadPath | Die Anfrage enthielt einen ungültigen :path-Wert. |
405 | Methode nicht zulässig | Die angegebene :method war nicht POST. |
410 | Abgelaufenes Token | Der Gerätetoken ist abgelaufen. |
410 | Nicht registriert | Das Geräte-Token ist für das angegebene Thema inaktiv. |
429 | TooManyProviderTokenUpdates | Das Anbieter-Token wird zu häufig aktualisiert. |
500 | InternalServerError | Ein interner Serverfehler ist aufgetreten. |
503 | ServiceUnavailable | Der Dienst ist nicht verfügbar. |
Android
Bei Android-Push-Benachrichtigungen, die über FCM gesendet werden, kann es aus mindestens einem der in Googles Referenz für FCM-Fehlercodesaufgeführten Gründe zu Ablehnungen kommen.
Statuscode | FCM-Fehler-String | FCM-Beschreibung |
400 | INVALID_ARGUMENT | Das Format des Registrierungstokens prüfen, das an den Server übergeben wird. Sicherstellen, dass es mit dem Registrierungstoken übereinstimmt, das die Client-App bei der Registrierung bei Firebase Notifications erhält. Nicht kürzen oder zusätzliche Zeichen hinzufügen. |
400 | INVALID_ARGUMENT | Stelle sicher, dass die Nachricht an ein Registrierungstoken adressiert wurde, dessen Paketname mit dem im Request übergebenen Wert übereinstimmt. |
400 | INVALID_ARGUMENT | Stelle sicher, dass die Gesamtgröße der in einer Nachricht enthaltenen Nutzlastdaten die FCM-Limits nicht überschreitet: 4096 Bytes für die meisten Nachrichten oder 2048 Bytes bei Nachrichten an Themen. Dazu gehören sowohl die Schlüssel als auch die Werte. |
400 | INVALID_ARGUMENT | Prüfen, dass die Nutzlastdaten keinen Schlüssel (z. B. from oder gcm oder einen Wert mit dem Präfix google) enthalten, der intern von FCM verwendet wird. Beachte, dass einige Wörter (z. B. collapse_key) ebenfalls von FCM verwendet werden, aber in der Nutzlast zulässig sind; in diesem Fall wird der Nutzlastwert durch den FCM-Wert überschrieben. |
400 | INVALID_ARGUMENT | Prüfe, ob der in ttl verwendete Wert eine Ganzzahl ist, die eine Dauer in Sekunden zwischen 0 und 2.419.200 (4 Wochen) darstellt. |
400 | INVALID_ARGUMENT | Stelle sicher, dass die angegebenen Parameter den richtigen Namen und Typ haben. |
403 | SENDER_ID_MISMATCH | Die authentifizierte Absender-ID unterscheidet sich von der Absender-ID für das Registrierungstoken. |
404 | NICHT REGISTRIERT | App-Instanz wurde aus FCM deregistriert. Das bedeutet in der Regel, dass das verwendete Token nicht mehr gültig ist und ein neues verwendet werden muss. |
429 | QUOTA_EXCEEDED | Sendelimit für das Nachrichtenziel überschritten. Es wird eine Erweiterung vom Typ google.rpc.QuotaFailure zurückgegeben, um anzugeben, welches Kontingent überschritten wurde. |
500 | INTERN | Ein unbekannter interner Fehler ist aufgetreten. |
503 | Nicht verfügbar | Der Server ist überlastet. |
Du siehst auch ein Bounced push -Ereignis, wenn Empfänger*innen fehlen oder ein ungültiges Push-Token haben.
Best Practices
Einwilligung einholen
Um eine Standard-Push-Benachrichtigung an ein Profil zu senden, musst du zuerst die ausdrückliche Zustimmung einholen.
Um die Einwilligung für Push-Benachrichtigungen einzuholen, musst du Kund*innen beim ersten Kontakt mit deiner mobilen App eine Berechtigungsaufforderung anzeigen.
Es ist Best Practice, dass dein Prompt auf dem Berechtigungsbildschirm eine Einwilligungsformulierung enthält, die die folgenden Informationen bereitstellt und es Kund*innen ermöglicht, sich anzumelden oder sich abzumelden:
- Welche Arten von Benachrichtigungen deine Marke versendet
Füge Details zu den verschiedenen Push-Benachrichtigungen hinzu, die deine Marke senden möchte (z. B. Kontoänderungen, Kontoänderungen, Erinnerungen und spezielle Rabatte). - Warum Benutzer*innen sich anmelden sollten
Informationen dazu aufnehmen, warum Kund*innen Berechtigungen erteilen sollten (z. B., um wichtige Updates oder frühzeitigen Zugriff auf Angebote zu erhalten).
Erfahre mehr über das Einholen der Einwilligung in Push-Benachrichtigungen.
Relevante Benachrichtigungen senden
Wenn du eine Push-Benachrichtigung Kampagne versendest, ist es wichtig, die Vorteile von Klaviyo's Segmentierung zu nutzen, um Inhalte zu senden, die personalisiert und relevant für deinen Abonnenten sind.
Wenn du zum Beispiel weißt, dass du ein Segment von engagierten wiederkommenden Kunden hast, kannst du sie mit Push-Benachrichtigung vor allen anderen über neue Angebote oder Aktionen informieren.
Indem du sicherstellst, dass die Inhalte, die du Kund*innen sendest, für ihre Interessen und Vorlieben relevant sind, kannst du die Wahrscheinlichkeit verringern, dass Kund*innen sich abmelden, und deine Möglichkeiten, Kund*innen mit Push-Benachrichtigung zu erreichen, maximieren.
Performance überwachen und analysieren
Es ist wichtig, die Leistung deiner Push-Benachrichtigung mit Klaviyo kontinuierlich zu überwachen, um Zustellungsprobleme und Einbrüche in wichtigen Push-Metriken schnell zu erkennen.
Am besten geht das, indem du die folgenden Push-Benachrichtigung-Events überwachst:
- Push empfangen
- Push geöffnet
- Push gebounct
In Klaviyo kannst du einen Bericht mit mehreren Metriken einrichten, um zu beobachten, wie sich deine Performance mit diesen Events im Laufe der Zeit verändert.