Erfahre mehr über die Push-Benachrichtigung Zustellung, einschließlich wie sie zugestellt wird und warum sie scheitern kann.
Push-Benachrichtigung ZustellungPush-Benachrichtigung Zustellung
Push-Zustellung bedeutet, dass eine Push-Benachrichtigung erfolgreich an das Gerät des Empfängers zugestellt wurde.
Ein Profil kann mehr als 1 Push-Token haben, wenn er deine mobile App auf mehreren Geräten installiert hat. Push-Benachrichtigung wird für alle Geräte mit einem Token versucht, die auf dem Profil geladen sind.
Das Konzept der Zustellbarkeit gilt für Push-Benachrichtigung nicht wie für E-Mail, da keine Sortierung vorgenommen wird, sobald das Gerät des Empfängers die Benachrichtigung erfolgreich empfangen hat.
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 nehmen die Benachrichtigung entweder an und versuchen, sie an das Gerät des Empfängers zu übermitteln, oder sie lehnen die Benachrichtigung mit einer Reihe von möglichen Fehlern ab.
Klaviyo hat nur Einblick darin, ob diese Dienste die Meldung annehmen 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 Versand 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 Bounced Push erstellt. Sie erscheint im Aktivitäts-Feed des empfangenden Profils zusammen mit der Empfängeraktivität für den jeweiligen Flow oder die Kampagne, von der die Benachrichtigung gesendet wurde.
Das Bounced-Push-Ereignis enthält Metadaten, die die von APNs oder Firebase zurückgegebene Fehlercode-Meldung (z.B. ExpiredToken) anzeigen. Wenn du Probleme bei der Zustellung hast, arbeite mit deinem App-Entwickler zusammen, um den Fehler anhand der Beschreibung im Ereignis zu beheben.
Um die Metadaten eines Ereignisses einzusehen, klicke auf Aktivitätsdetails für das Ereignis im Aktivitätsprotokoll des Profils.
iOS
Bei iOS Push-Benachrichtigungen, die über APNs gesendet werden, kann es zu Ablehnungen aus mindestens einem der Gründe kommen, die in Apples Referenz für den Umgang mit Benachrichtigungsantworten von APNs aufgeführt sind.
| Statuscode |
APNs Fehlerstring |
APNs Beschreibung |
|
400 |
BadDeviceToken |
Das angegebene Gerätetoken war fehlerhaft. Überprüfe, ob die Anfrage ein gültiges Token enthält und ob das Token mit der Umgebung übereinstimmt. |
|
400 |
BadTopic |
Der Wert apns-topic ist ungültig. |
|
400 |
DeviceTokenNotForTopic |
Das Gerätetoken stimmt nicht mit dem angegebenen Thema überein. |
|
400 |
DuplicateHeaders |
Eine oder mehrere Überschriften wurden wiederholt. |
|
400 |
IdleTimeout |
Leerlaufzeit abgelaufen. |
|
400 |
InvalidPushType |
Der Wert apns-Push-type ist ungültig. |
|
400 |
PayloadEmpty |
Die Nutzlast der Nachricht war leer. |
|
403 |
BadCertificate |
Das Zertifikat war schlecht. |
|
403 |
BadCertificateEnvironment |
Das Client-Zertifikat war für die falsche Umgebung. |
|
403 |
InvalidProviderToken |
Der Anbieter-Token ist nicht gültig oder die Token-Signatur konnte nicht überprüft werden. |
|
404 |
BadPath |
Die Anfrage enthielt einen falschen :path-Wert. |
|
405 |
MethodNotAllowed |
Die angegebene :Methode war nicht POST. |
|
410 |
ExpiredToken |
Das Gerätetoken ist abgelaufen. |
|
410 |
Unregistriert |
Das Geräte-Token ist für das angegebene Thema inaktiv. |
|
429 |
TooManyProviderTokenUpdates |
Der Anbieter-Token wird zu oft aktualisiert. |
|
500 |
InternalServerError |
Es ist ein interner Serverfehler aufgetreten. |
|
503 |
ServiceUnavailable |
Der Dienst ist nicht verfügbar. |
Android
Bei Android-Push-Nachrichten, die über FCM gesendet werden, können Ablehnungen aus mindestens einem der Gründe auftreten, die in Googles Referenz für FCM-Fehlercodesaufgeführt sind .
|
Statuscode |
FCM-Fehlerstring |
FCM Beschreibung |
|
400 |
UNGÜLTIGES_ARGUMENT |
Überprüfe das Format des Registrierungs-Tokens, das du an den Server weitergibst. Vergewissere dich, dass er mit dem Registrierungs-Token übereinstimmt, den die Client-App bei der Registrierung bei Firebase Notifications erhält. Kürze nicht ab und füge keine zusätzlichen Zeichen hinzu. |
|
400 |
UNGÜLTIGES_ARGUMENT |
Stelle sicher, dass die Nachricht an ein Registrierungs-Token adressiert wurde, dessen Paketname mit dem in der Anfrage übergebenen Wert übereinstimmt. |
|
400 |
UNGÜLTIGES_ARGUMENT |
Überprüfe, ob die Gesamtgröße der in einer Nachricht enthaltenen Nutzdaten die FCM-Grenzen nicht überschreitet: 4096 Byte für die meisten Nachrichten bzw. 2048 Byte bei Nachrichten an Themen. Dazu gehören sowohl die Schlüssel als auch die Werte. |
|
400 |
UNGÜLTIGES_ARGUMENT |
Überprüfe, dass die Nutzdaten keinen Schlüssel (wie from oder gcm oder einen Wert mit dem Präfix google) enthalten, der intern von FCM verwendet wird. Beachte, dass einige Wörter (wie collapse_key) auch von FCM verwendet werden, aber in der Nutzlast erlaubt sind. In diesem Fall wird der Wert der Nutzlast durch den FCM-Wert überschrieben. |
|
400 |
UNGÜLTIGES_ARGUMENT |
Vergewissere dich, dass der in ttl verwendete Wert eine ganze Zahl ist, die eine Dauer in Sekunden zwischen 0 und 2.419.200 (4 Wochen) angibt. |
|
400 |
UNGÜLTIGES_ARGUMENT |
Überprüfe, ob 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 |
UNREGISTRIERT |
Die App-Instanz wurde vom FCM abgemeldet. Das bedeutet in der Regel, dass der verwendete Token nicht mehr gültig ist und ein neuer verwendet werden muss. |
|
429 |
QUOTA_EXCEEDED |
Sendegrenze für das Nachrichtenziel überschritten. Eine Erweiterung vom Typ google.rpc.QuotaFailure wird zurückgegeben, um anzugeben, welche Quote überschritten wurde. |
|
500 |
INTERNE |
Ein unbekannter interner Fehler ist aufgetreten. |
|
503 |
NICHT VERFÜGBAR |
Der Server ist überlastet. |
Du siehst auch ein Bounced Push-Ereignis, wenn der Empfänger fehlt oder ein ungültiges Push-Token hat.
Bewährte Praktiken
Zustimmung der Nutzer einholenZustimmung der Nutzer einholen
Um eine Push-Benachrichtigung an ein Profil zu senden, musst du zuerst seine ausdrückliche Zustimmung einholen.
Um die Push-Nachricht-Zustimmung zu sammeln, musst du den Kunden bei der ersten Interaktion mit deiner mobilen App eine Aufforderung zur Zustimmung geben.
Am besten ist es, wenn deine Aufforderung zur Erteilung der Erlaubnis einen Text enthält, der die folgenden Informationen enthält und die Möglichkeit bietet, sich an- oder abzumelden:
-
Welche Arten von Benachrichtigungen deine Marke versendet
Füge Details zu den verschiedenen Push-Benachrichtigungen hinzu, die deine Marke abonniert hat (z.B. Kontoänderungen, Erinnerungen und spezielle Rabatte). -
Warum Nutzer/innen sich anmelden sollten
Gib an, warum ein Kunde seine Berechtigung erteilen sollte (z.B. um wichtige Updates zu erhalten oder frühzeitigen Zugang zu Verkäufen).
Erfahre mehr über das Sammeln von Push-Nachricht-Einwilligungen.
Relevante Benachrichtigungen sendenRelevante 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 deinen Kunden sendest, für ihre Interessen und Vorlieben relevant sind, kannst du die Wahrscheinlichkeit verringern, dass Kunden sich abmelden, und deine Möglichkeiten, deine Kunden mit Push-Benachrichtigung zu erreichen, maximieren.
Überwache und analysiere die LeistungÜberwache und analysiere die Leistung
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.
Das geht am besten, indem du die folgenden Push-Nachricht-Ereignisse beobachtest:
- Empfangener Push
- Geöffneter Push
- Aufgeprallter Schub
Du kannst einen Multi-Metrik-Bericht in Klaviyo einrichten, um zu beobachten, wie sich deine Leistung bei diesen Ereignissen im Laufe der Zeit verändert.
Zusätzliche RessourcenZusätzliche Ressourcen
Verstehe Push-Benachrichtigung Zustimmung