Criar modelos de notificação por push - Amazon Pinpoint

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar modelos de notificação por push

Um modelo de notificação por push é um modelo de mensagem que contém conteúdo e configurações que você pode usar com seus projetos do Amazon Pinpoint. Quando você usa um modelo para enviar uma notificação por push, o Amazon Pinpoint preenche a notificação com o conteúdo e as configurações definidos no modelo.

Ao criar um modelo de notificação por push, você especifica o conteúdo e as configurações que deseja reutilizar em vários componentes de notificações por push baseadas no modelo. Esses componentes, conhecidos como partes de modelo, podem conter texto (como o título ou o corpo de uma notificação) ou configurações (como um som personalizado para reproduzir quando um destinatário recebe uma notificação).

Para personalizar um modelo para canais específicos de notificação por push, você pode criar vários conjuntos de componentes de modelo em cada modelo: um conjunto padrão e, opcionalmente, um ou mais conjuntos específicos de serviços. O conjunto padrão contém o conteúdo e as configurações que você deseja usar por padrão para qualquer canal de notificação por push. Um conjunto específico do serviço contém todo o conteúdo e as configurações que você deseja usar para um serviço de notificação específico, como o Apple Push Notification service ou o Firebase Cloud Messaging. Ao adicionar configurações específicas do serviço a um modelo, você pode personalizar as notificações para exibir conteúdo exclusivo para cada tipo de dispositivo de um destinatário.

Você também pode criar modelos que contenham dados brutos de mensagens. Essa opção é mais avançada, mas é útil se você quiser especificar configurações para um canal específico que não estão presentes no modelo padrão de notificação por push do Amazon Pinpoint.

Criar um modelo de notificação por push padrão

Conclua este procedimento para especificar o conteúdo básico da mensagem, como título, corpo da mensagem, imagem e ação. Para especificar o conteúdo bruto da mensagem, conclua o procedimento em Criar um modelo de notificação por push com os dados brutos da mensagem vez disso.

Para criar um modelo de notificação por push
  1. Abra o console do Amazon Pinpoint em. https://console.aws.amazon.com/pinpoint/

  2. No painel de navegação, escolha Modelos de mensagem.

  3. Selecione Criar modelo.

  4. Em Canal, escolha Notificações push.

  5. Em Detalhes do modelo, para Nome do modelo, insira um nome para o modelo. O nome deve começar com uma letra ou número. Ele pode conter até 128 caracteres. Os caracteres podem ser letras, números, sublinhados (_) ou hifens (-).

  6. (Opcional) Para Descrição da versão, insira uma breve descrição do modelo. A descrição pode conter até 500 caracteres.

  7. Em Detalhes da notificação por push, faça o seguinte:

    • Em Tipo de notificação, escolha Mensagem padrão.

    • Em Título, insira o título que você deseja exibir acima do corpo da mensagem.

    • Em Corpo, insira o texto que deseja exibir no corpo da mensagem de notificação.

      dica

      Você pode incluir conteúdo personalizado no título e no corpo do modelo. Para fazer isso, adicione variáveis de mensagem que façam referência a atributos específicos, como um atributo que armazena o nome de um usuário. Ao usar variáveis de mensagem, é possível exibir conteúdos diferentes para cada destinatário de uma notificação por push que usa o modelo.

      Para usar uma variável de mensagem, escolha o nome de um atributo existente no Localizador de atributos. O Amazon Pinpoint cria uma variável de mensagem para o atributo e a copia para sua área de transferência. Cole a variável no local desejado. Para obter mais informações, consulte Adicionar conteúdo personalizado a modelos de mensagem.

    • Em Som de alerta personalizado, insira o nome do arquivo de áudio que contém o som personalizado que você deseja reproduzir quando um destinatário receber a notificação por push. Esse nome deve corresponder ao nome de um arquivo de áudio no dispositivo do destinatário.

    • Em Ação, escolha o que você deseja que o dispositivo de um destinatário faça se o destinatário tocar na notificação por push:

      • Abra seu aplicativo: abra seu aplicativo ou leve-o para o primeiro plano se ele foi enviado para o plano de fundo.

      • Vá para URL — Abra o navegador padrão no dispositivo do destinatário e carregue uma página da web específica. Se você escolher essa opção, insira o URL da página da Web na URL caixa Destino.

      • Abra um link direto: abra o aplicativo e exiba uma interface de usuário específica nele. Se você escolher essa opção, insira o URL da interface na URL caixa Destino.

  8. (Opcional) Para personalizar o modelo para canais de notificação por push específicos, escolha a guia de canal apropriada em Personalizar conteúdo para serviços de push individuais. Depois, escolha as opções que deseja para o serviço.

    Se você marcar a caixa de seleção Substituir conteúdo por push padrão em uma guia de serviço, o Amazon Pinpoint substituirá automaticamente o conteúdo padrão e as configurações escolhidas na etapa anterior pelas opções escolhidas na guia. Se você quiser manter o conteúdo e as configurações padrão e apenas personalizar o modelo para usar configurações adicionais específicas do canal, não marque essa caixa de seleção.

    Apple

    Use essas opções para especificar conteúdo e configurações personalizados para notificações push que você envia pelo canal do serviço Apple Push Notification (APNs) para aplicativos que estão sendo executados em dispositivos iOS.

    Além do conteúdo e das configurações padrão, você pode incluir uma imagem personalizada ou vídeo em notificações por push que usam o modelo. Para fazer isso, insira o URL para o arquivo de imagem ou vídeo na caixa de mídia do iOS. Eles URL devem estar acessíveis ao público. Caso contrário, o dispositivo do destinatário não poderá exibir a imagem ou o vídeo.

    Google

    Use essas opções para especificar conteúdo e configurações personalizados para notificações push que você envia por meio do canal Google Firebase Cloud Messaging (FCM) para aplicativos executados em dispositivos Android.

    Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

    • Imagem URL do Android — Insira a imagem a ser exibida no corpo da notificação push.

    • Ícone do Android — Insira a imagem URL do ícone grande a ser exibida na visualização de conteúdo da notificação push.

    • Ícone pequeno do Android — Insira a imagem URL do ícone pequeno a ser exibida na barra de status e na visualização do conteúdo da notificação push.

    Amazon

    Use essas opções para especificar conteúdo e configurações personalizados para notificações push que você envia pelo canal Amazon Device Messaging (ADM) para aplicativos que estão sendo executados em dispositivos Amazon, como tablets Kindle Fire.

    Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

    • Imagem URL do Android — Insira a imagem a ser exibida no corpo da notificação push.

    • Ícone do Android — Insira a imagem URL do ícone grande a ser exibida na visualização de conteúdo da notificação push.

    • Ícone pequeno do Android — Insira a imagem URL do ícone pequeno a ser exibida na barra de status e na visualização do conteúdo da notificação push.

    Baidu

    Use essas opções para especificar conteúdo personalizado e configurações para notificações por push enviadas pelo canal Baidu para aplicativos que usam a plataforma Baidu Cloud Push.

    Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

    • Imagem URL do Android — Insira a imagem a ser exibida no corpo da notificação push.

    • Ícone do Android — Insira a imagem URL do ícone grande a ser exibida na visualização de conteúdo da notificação push.

    • Ícone pequeno do Android — Insira a imagem URL do ícone pequeno a ser exibida na barra de status e na visualização do conteúdo da notificação push.

  9. Se você tiver adicionado conteúdo personalizado ao modelo usando variáveis de mensagem, especifique um valor padrão para cada variável. Se fizer isso, o Amazon Pinpoint substituirá a variável pelo valor especificado, caso um valor correspondente não exista para um destinatário. Recomendamos que você faça isso para cada variável no modelo.

    Para especificar valores padrão para variáveis, expanda a seção Valores de atributo padrão. Depois, insira o valor padrão que deseja usar para cada variável. Se você não especificar um valor padrão e não existir um valor para o destinatário, o Amazon Pinpoint não enviará a mensagem.

  10. Quando terminar de inserir conteúdo e configurações para o modelo, escolha Criar.

Criar um modelo de notificação por push com os dados brutos da mensagem

Conclua este procedimento para especificar manualmente a carga útil da mensagem bruta. Você só precisa especificar a carga bruta da mensagem se quiser usar um recurso de um serviço específico de notificação por push que o Amazon Pinpoint não permite que você configure. Se você não precisar especificar o conteúdo bruto da mensagem, conclua o procedimento em Criar um modelo de notificação por push padrão vez disso.

Um exemplo de caso de uso que exige o uso de um modelo de mensagem bruta é quando você deseja enviar mensagens aos usuários do navegador Safari para desktop. Nesse caso, você deve incluir um atributo específico na carga da mensagem bruta. Para obter mais informações, consulte Enviando uma mensagem no Guia do usuário do AWS End User Messaging Push.

Para criar um modelo de notificação por push
  1. Abra o console do Amazon Pinpoint em. https://console.aws.amazon.com/pinpoint/

  2. No painel de navegação, escolha Modelos de mensagem.

  3. Selecione Criar modelo.

  4. Em Canal, escolha Notificações push.

  5. Em Detalhes do modelo, para Nome do modelo, insira um nome para o modelo. O nome deve começar com uma letra ou número. Ele pode conter até 128 caracteres. Os caracteres podem ser letras, números, sublinhados (_) ou hifens (-).

  6. (Opcional) Para Descrição da versão, insira uma breve descrição do modelo. A descrição pode conter até 500 caracteres.

  7. Em Detalhes da notificação por push, em Tipo de notificação, escolha Mensagem bruta. O editor de mensagens exibirá uma estrutura do código a ser usado para o modelo. No editor de mensagens, insira as configurações que deseja usar para cada serviço de notificação por push, incluindo quaisquer configurações opcionais, como imagens, sons e ações, que deseja especificar para o modelo. Para obter mais informações, consulte a documentação relativa aos serviços de notificação por push usados por você.

  8. Quando terminar de inserir conteúdo para a mensagem bruta, escolha Criar.

Para testar o modelo antes de usá-lo em uma notificação push que você envia aos usuários, você pode enviar uma notificação de teste que usa o modelo. Se você fizer isso, primeiro conclua a etapa 10 para especificar valores padrão para todas as variáveis no modelo. Caso contrário, a notificação por push talvez não seja enviada ou processada corretamente.