Como configurar notificações push do iOS

O que você vai aprender

Saiba como configurar notificações push na sua conta Klaviyo. Depois de concluir as etapas deste artigo, você poderá enviar notificações push nos seus fluxos e campanhas. Para que as notificações sejam de fato entregues aos dispositivos, você também precisa instalar o Software Development Kit (SDK) móvel da Klaviyo no código do seu app para dispositivos móveis e, em seguida, lançar uma nova versão do app com o SDK instalado.

Antes de começar

Há 3 pré-requisitos para usar notificações push na Klaviyo:

1. Você precisa ter seu próprio app móvel para iOS.
2. Você precisa ter uma conta de Apple Developer na qual possa gerar uma chave de autenticação do serviço Apple de notificação push (APNs) para enviar para a Klaviyo (mais detalhes abaixo).
3. Você precisa instalar o Software Development Kit (SDK) para dispositivos móveis da Klaviyo apropriado (iOS, React Native ou Flutter) e configurar o rastreamento de eventos e as notificação push no seu app iOS.

Configurar notificações push do iOS no Klaviyo

1. Clique no nome da sua organização no canto inferior esquerdo.
2. Navegue até Configurações > Notificações push.
3. Na página Configurações do app móvel, clique em Ativar ao lado da opção iOS.
   

4. Preencha as informações obrigatórias.
   Para criar a chave de autenticação de APNs, você deve ser o titular da conta ou um Administrador na sua conta do Apple Developer. Você também precisa acessar os detalhes da chave para copiar o Key ID. Você pode consultar as funções e permissões da Apple aqui.
   • Chave de autenticação do APNs Se você ainda não tiver uma, crie uma chave de autenticação do APNs com o serviço de notificação push da Apple ativado. A chave precisa oferecer suporte a envios para produção para o ID do pacote do seu app. Depois de criar sua chave, faça o download do arquivo .p8 e envie-o para sua conta Klaviyo. Mantenha o arquivo em um local seguro, pois a Apple permite fazer o download apenas uma vez.
   • ID da chave
     Para encontrar o ID da sua chave, navegue até sua lista de chaves. Clique na sua chave para expandir os detalhes e copie o ID da chave.
   • ID da equipe
     Encontre o ID da sua equipe aqui.
   • ID do pacote
     Você pode encontrar seu ID do pacote na sua conta do Apple Developer ou no projeto do Xcode do seu app. Para encontrar no App Store Connect:
     1. Faça login na sua conta do App Store Connect.
     2. Clique em Apps e selecione seu aplicativo.
     3. Em General > App Information na barra lateral, copie o ID do pacote e insira-o no Klaviyo.
        A ID do pacote diferencia maiúsculas de minúsculas. Insira o identificador exato do seu app, por exemplo:
        com.YOUR_APP_NAME
        

5. Depois de preencher todas as informações obrigatórias, clique em Salvar.

Uma notificação de sucesso confirma que sua configuração de push do iOS foi salva. Agora você pode criar notificações push em campanhas e fluxos.

Teste o envio de uma notificação push

Depois de configurar as notificações push na sua conta Klaviyo e confirmar que o Software Development Kit (SDK) da Klaviyo está instalado no seu app para dispositivos móveis:

1. Faça login no seu aplicativo móvel com um endereço de e-mail ou número de telefone que facilite encontrar seu perfil na Klaviyo.
2. Se for solicitado, habilite as notificações push do seu aplicativo. Se você não receber essa solicitação, confirme se as notificações push estão habilitadas para o aplicativo nas configurações do seu dispositivo.
3. No Klaviyo, acesse Público > Perfis e encontre seu perfil de teste. Se você não conseguir encontrar seu perfil, verifique com o desenvolvedor do seu app para confirmar se o app envia identificadores de perfil para o Klaviyo.
4. Em Consentimento do canal, confirme que seu perfil está inscrito para receber notificação push no Push para celular.

5. Crie uma lista ou segmento apenas com o seu perfil.
6. Crie uma campanha de notificação push e selecione essa lista ou segmento como público-alvo.
7. Termine de criar a mensagem e, em seguida, envie a campanha para sua lista de teste ou segmento.
8. Confirme se a notificação aparece no dispositivo.
9. Toque na notificação no seu dispositivo para abrir seu app.
10. Verifique o registro de atividades do seu perfil para confirmar que você vê um evento de Push recebido e um evento de Push aberto.

Solução de problemas

• Por que não vejo um token de notificação push no meu perfil no Klaviyo? Assim como um endereço de e-mail para e-mails, notificações push são enviadas para tokens de notificação push. Seu aplicativo para celular precisa encaminhar o token de notificação push de um dispositivo para o Klaviyo para que você consiga enviar notificações push para esse dispositivo. Confirme com seu desenvolvedor de aplicativos se ele implementou o código descrito na seção Notificações push da nossa documentação do Software Development Kit (SDK).
• Por que as imagens não são exibidas para notificações push do iOS? A mídia avançada é exibida no iOS somente se você adicionar a Extensão de serviço de notificação ao seu aplicativo. Confirme com o desenvolvedor do seu aplicativo se ele implementou o código descrito na seção Notificações avançadas da documentação do nosso Software Development Kit (SDK).
• Por que não estou vendo eventos de Push aberto mesmo quando toco em uma notificação? Você precisa adicionar código ao seu aplicativo móvel para rastrear eventos de Push aberto no Klaviyo. O Klaviyo pode cuidar desse código automaticamente para você, ou seu desenvolvedor pode adicionar esse código manualmente. Confirme com seu desenvolvedor de aplicativos se ele implementou o código descrito na seção Notificações push da nossa documentação do Software Development Kit (SDK).

Recursos adicionais

• Você também tem um app para Android? Saiba como configurar notificações push para Android.
• Seu app foi criado com React Native? Saiba como configurar notificações push para um app React Native.
• Saiba como usar notificações push em campanhas.
• Confira como usar deep links em notificações push.