Informacje o dostarczaniu powiadomień push
Dowiedz się więcej o dostarczaniu powiadomień push, w tym o tym, jak są dostarczane i dlaczego może się to nie udać.
Dostarczanie powiadomień push
Dostarczenie powiadomienia push oznacza moment, w którym powiadomienie push zostanie pomyślnie dostarczone na urządzenie odbiorcy.
Profil może mieć więcej niż 1 token powiadomień push, jeśli aplikacja mobilna jest zainstalowana na wielu urządzeniach. Próba wysłania powiadomień push zostanie podjęta na wszystkich urządzeniach z tokenem zapisanym w profilu.
Koncepcja dostarczalności nie ma zastosowania do powiadomień push w taki sposób jak w przypadku e-maili, ponieważ po pomyślnym odebraniu powiadomienia przez urządzenie odbiorcy nie jest wykonywane żadne sortowanie.
Gdy wysyłasz powiadomienie push w ramach kampanii lub sekwencji, Klaviyo sprawdza powiadomienie push, a następnie wysyła je do usługi powiadomień push dla urządzeń Apple (APN) dla systemu iOS lub do usługi powiadomień push Androida, Firebase Cloud Messaging (FCM), aby dostarczyć je na urządzenie odbiorcy. Możesz zobaczyć, że niektóre powiadomienia push zostały pominięte, jeśli występuje problem z dostarczeniem.
Powiadomienia push dla urządzeń Apple (APN) i FCM albo zaakceptują powiadomienie i spróbują dostarczyć je na urządzenie odbiorcy, albo odrzucą powiadomienie, zwracając serię możliwych błędów.
Klaviyo ma praktyczne dane tylko o tym, czy te usługi akceptują powiadomienie czy je odrzucają. Klaviyo nie może potwierdzić, czy powiadomienie nie powiedzie się po tym, jak powiadomienia push dla urządzeń Apple (APN) lub FCM zaakceptują powiadomienie push.
Chcesz poprosić o funkcje dla powiadomień push Klaviyo? Wypełnij ten formularz Google, aby nam o tym powiedzieć!
Przyczyny odrzucenia
Jeśli Klaviyo otrzyma odpowiedź o błędzie od powiadomienia push dla urządzeń Apple (APN) lub FCM po wysłaniu powiadomienia, dla każdego tokenu, którego dotyczy nieudane dostarczenie, zostanie utworzone zdarzenie o nazwie Bounced push. Będzie to wyświetlane w kanale aktywności profilu odbierającego wraz z działaniem odbiorcy dla odpowiedniej sekwencji lub kampanii, z której zostało wysłane powiadomienie.
Zdarzenie Odrzucone powiadomienie push zawiera metadane, które pokazują komunikat kodu błędu (np. ExpiredToken) zwrócony przez powiadomienia push dla urządzeń Apple (APN) lub Firebase. Jeśli widzisz problemy z dostarczaniem, skontaktuj się z deweloperem aplikacji, aby rozwiązać błąd na podstawie opisu w zdarzeniu.
Aby wyświetlić metadane zdarzenia, kliknij Szczegóły aktywności dla zdarzenia w dzienniku aktywności profilu.
Ciche powiadomienie push
Możesz wyświetlić wskaźnik dostarczalności i wskaźnik odbić dla poszczególnych powiadomień push typu silent, jednak powiadomienia push typu silent są wykluczone ze wszystkich zbiorczych raportów skuteczności w Klaviyo. Obejmuje to takie dane jak wskaźnik wyświetleń wiadomości Mobile Push w czasie, ponieważ nie mają one otwarć ani konwersji.
Pamiętaj, że w przypadku cichego push zobaczysz inne zdarzenia niż w przypadku standardowego push, a mianowicie Otrzymano ciche powiadomienie push oraz Odrzucono ciche powiadomienie push.
Jeśli masz problemy z dostarczaniem cichych powiadomień push na iOS, pamiętaj, że iOS nie gwarantuje dostarczania cichych powiadomień push. Mogą nie zostać dostarczone w zależności od bieżącego stanu urządzenia, np. poziomu baterii i połączenia sieciowego.
iOS
W przypadku powiadomień push dla systemu iOS wysyłanych za pośrednictwem powiadomień push dla urządzeń Apple (APN) odrzucenia mogą wystąpić z co najmniej jednego z powodów wymienionych w dokumentacji Apple dotyczącej obsługi odpowiedzi na powiadomienia z APNs.
Kod statusu | Ciąg błędu powiadomienia push dla urządzeń Apple (APN) | Opis powiadomień push dla urządzeń Apple (APN) |
400 | BadDeviceToken | Określony token urządzenia jest nieprawidłowy. Sprawdź, czy żądanie zawiera prawidłowy token i czy token jest zgodny ze środowiskiem. |
400 | BadTopic | Wartość apns-topic jest nieprawidłowa. |
400 | DeviceTokenNotForTopic | Token urządzenia nie pasuje do określonego tematu. |
400 | ZduplikowaneNagłówki | Co najmniej jeden nagłówek został powtórzony. |
400 | IdleTimeout | Przekroczono limit czasu bezczynności. |
400 | Nieprawidłowy typ powiadomienia push | Wartość apns-push-type jest nieprawidłowa. |
400 | PayloadEmpty | Ładunek wiadomości był pusty. |
403 | Nieprawidłowy certyfikat | Certyfikat był nieprawidłowy. |
403 | Środowisko z nieprawidłowym certyfikatem | Certyfikat klienta był dla niewłaściwego środowiska. |
403 | InvalidProviderToken | Token dostawcy jest nieprawidłowy lub nie można było zweryfikować podpisu tokenu. |
404 | Zła ścieżka | Żądanie zawierało nieprawidłową wartość :path. |
405 | Metoda niedozwolona | Określona wartość parametru :method nie była POST. |
410 | Wygasły token | Token urządzenia wygasł. |
410 | Niezarejestrowane | Token urządzenia jest nieaktywny dla określonego tematu. |
429 | Zbyt wiele aktualizacji tokena dostawcy | Token dostawcy jest aktualizowany zbyt często. |
500 | InternalServerError | Wystąpił wewnętrzny błąd serwera. |
503 | Usługa niedostępna | Usługa jest niedostępna. |
Android
W przypadku powiadomień push na Androida wysyłanych przez FCM odrzucenia mogą wystąpić z co najmniej jednego z powodów wymienionych w dokumentacji Google dotyczącej kodów błędów FCM.
Kod statusu | Ciąg błędu FCM | Opis FCM |
400 | NIEPRAWIDŁOWY_ARGUMENT | Sprawdź format tokena rejestracji, który przekazujesz na serwer. Upewnij się, że odpowiada tokenowi rejestracji, który aplikacja kliencka otrzymuje podczas rejestracji w Firebase Notifications. Nie przycinaj ani nie dodawaj dodatkowych znaków. |
400 | NIEPRAWIDŁOWY_ARGUMENT | Upewnij się, że wiadomość została wysłana do tokena rejestracji, którego nazwa pakietu jest zgodna z wartością przekazaną w żądaniu. |
400 | NIEPRAWIDŁOWY_ARGUMENT | Sprawdź, czy łączny rozmiar danych payloadu uwzględnionych w wiadomości nie przekracza limitów FCM: 4096 bajtów w przypadku większości wiadomości lub 2048 bajtów w przypadku wiadomości do tematów. Dotyczy to zarówno kluczy, jak i wartości. |
400 | NIEPRAWIDŁOWY_ARGUMENT | Sprawdź, czy dane ładunku nie zawierają klucza (np. from, gcm lub dowolnej wartości z prefiksem google), który jest używany wewnętrznie przez FCM. Pamiętaj, że niektóre słowa (np. collapse_key) są również używane przez FCM, ale są dozwolone w ładunku — w takim przypadku wartość w ładunku zostanie zastąpiona wartością FCM. |
400 | NIEPRAWIDŁOWY_ARGUMENT | Sprawdź, czy wartość użyta w ttl jest liczbą całkowitą reprezentującą czas trwania w sekundach z zakresu od 0 do 2 419 200 (4 tygodnie). |
400 | NIEPRAWIDŁOWY_ARGUMENT | Sprawdź, czy podane parametry mają prawidłową nazwę i typ. |
403 | SENDER_ID_MISMATCH | Uwierzytelniony identyfikator nadawcy różni się od identyfikatora nadawcy dla tokena rejestracji. |
404 | NIEZAREJESTROWANI | Instancja aplikacji została wyrejestrowana z FCM. Zwykle oznacza to, że używany token powiadomień push nie jest już prawidłowy i trzeba użyć nowego. |
429 | PRZEKROCZONO LIMIT | Przekroczono limit wysyłania dla celu wiadomości. Zwracane jest rozszerzenie typu google.rpc.QuotaFailure, aby określić, który limit został przekroczony. |
500 | WEWNĘTRZNE | Wystąpił nieznany błąd wewnętrzny. |
503 | Niedostępny | Serwer jest przeciążony. |
Zobaczysz też zdarzenie Odbite powiadomienie push, jeśli odbiorcy brakuje tokena powiadomień push lub jest on nieprawidłowy.
Najlepsze praktyki
Pozyskaj zgodę użytkownika
Aby wysłać standardowe powiadomienie push do profilu, najpierw musisz uzyskać jego wyraźną zgodę .
Aby zbierać zgodę na powiadomienia push, trzeba podczas pierwszej interakcji z aplikacją mobilną wyświetlić klientom monit o uprawnienia na ekranie.
Najlepszą praktyką jest, aby komunikat na ekranie uprawnień zawierał informację o zgodzie, która przekazuje następujące informacje i umożliwia wyrażenie zgody lub jej odmowę:
- Jakie typy powiadomień push wysyła Twoja marka
Uwzględnij szczegóły dotyczące różnych powiadomień push, które Twoja marka planuje wysyłać (na przykład zmiany na koncie, zmiany na koncie, przypomnienia i specjalne rabaty). - Dlaczego użytkownicy powinni wyrazić zgodę
Uwzględnij informacje o tym, dlaczego klient powinien udzielić zgód (na przykład aby otrzymywać ważne aktualizacje lub wcześniejszy dostęp do wyprzedaży).
Dowiedz się więcej o zbieraniu zgody na powiadomienie push.
Wysyłaj trafne powiadomienia
Podczas wysyłania kampanii powiadomień push ważne jest, aby korzystać z segmentacji Klaviyo do wysyłania treści spersonalizowanych i istotnych dla subskrybentów.
Na przykład, jeśli wiesz, że masz segment stałych klientów powracających, możesz użyć powiadomień push, aby poinformować ich o nowych ofertach lub promocjach przed wszystkimi innymi.
Dzięki temu, że wysyłane do klientów treści są dopasowane do ich zainteresowań i preferencji, możesz zmniejszyć prawdopodobieństwo rezygnacji z subskrypcji i zmaksymalizować możliwość docierania do klientów za pomocą powiadomień push.
Monitoruj i analizuj wyniki
Niezbędne jest ciągłe monitorowanie skuteczności powiadomień push w Klaviyo, aby szybko identyfikować problemy z dostarczaniem oraz spadki kluczowych metryk powiadomień push.
Najlepszym sposobem jest monitorowanie następujących zdarzeń powiadomienia push:
- Otrzymano powiadomienie push
- Otwarte powiadomienia push
- Odrzucono powiadomienie push
W Klaviyo możesz skonfigurować Raport dot. wielu metryk, aby monitorować, jak wyniki związane z tymi zdarzeniami zmieniają się w czasie.