O que você vai aprender

Saiba o que são pares de chave-valor e como usá-los com notificações push padrão e silenciosas. Pares de chave-valor são dados personalizados incluídos em notificações push que permitem acionar comportamentos do app, aplicar tag em mensagens, personalizar notificações e muito mais.

O que são pares chave-valor?

Pares de chave-valor são dados personalizados que podem ser incluídos em notificações push, tanto padrão (as que são exibidas aos usuários) quanto silenciosas (as que são invisíveis aos usuários). A chave é um nome que seu app reconhece, e o valor é a informação que você envia para essa chave.

Com as notificações silenciosas e padrão, você pode usá-las para atualizar o conteúdo do app, acionar tarefas em segundo plano ou fazer tag de mensagens para fins de relatórios.

Com push padrão, eles também podem ser usados para criar e preencher modelos de push personalizados.

Como usar pares de chave-valor

Para usar pares de chave-valor, seu aplicativo precisa estar configurado para reconhecer chaves e responder aos respectivos valores. Por isso, não deixe de trabalhar com o desenvolvedor do seu aplicativo para garantir que ele seja criado para atender aos seus casos de uso. Além disso, confira se você configurou notificações push para iOS ou Android na sua conta da Klaviyo.

Preencha os dois campos de cada par e use uma chave diferente para cada par. Se você repetir uma chave, apenas o último valor será salvo.

  1. Ao criar uma notificação push, abra a aba Conteúdo e selecione Standard ou Silencioso em Tipo.
  2. Selecione a aba Comportamentos e ative Dados personalizados se estiver desativado. Selecionar Silencioso ativa automaticamente.
  3. Insira uma chave e um valor. Clique em Adicionar para incluir outro par. Você pode adicionar até 10 pares de chave-valor por notificação push.
  4. Salve as mudanças. Em um fluxo, clique em Salvar e continuar. Em uma campanha, clique em Próximo ou Salvar e voltar, dependendo do editor.

Vamos ver um exemplo para um app de e-commerce:

  • Queremos atualizar os pontos de recompensa de um cliente exibidos no nosso app depois que ele fizer uma compra online. Vamos fazer isso enviando um push silencioso com uma Propriedades do perfil de pontos de recompensa como um par chave-valor.
  • Já temos um fluxo de agradecimento acionado por um evento de Pedido feito. Adicionamos uma notificação push silenciosa ao final desse fluxo para atualizar o valor de pontos de recompensas exibido no nosso app.
  • A notificação push silenciosa inclui um par chave-valor em que a Chave é igual a rewardspoints e o Valor é definido como {{ person.rewardspoints }}. O nome da Propriedades do perfil do perfil da Klaviyo em que armazenamos esses pontos é rewardspoints, e nosso app está configurado corretamente para atualizar com base nesse par chave-valor.
  • Neste exemplo, garantimos que o valor rewardspoints fosse atualizado na Klaviyo antes de ser enviado para nosso app por meio deste fluxo, para que reflita com precisão.

Casos de uso

Há muitos casos de uso para pares chave-valor, incluindo para:

  • Personalize o conteúdo do app
    Você pode enviar uma notificação push silenciosa para personalizar o conteúdo do app com base nos atributos do destinatário (como o exemplo de pontos de recompensas acima).
  • Crie tags para relatórios
    Você pode incluir pares de chave-valor em notificações push (padrão ou silenciosa) para "marcar" as mensagens e, em seguida, extrair dados de quaisquer mensagens com tags específicas para agregar. Por exemplo, essas tags podem ser parâmetros UTM.
  • Criar modelos de push personalizados
    Você pode definir o tamanho e a cor da fonte do corpo da notificação push ou configurar um som personalizado que será reproduzido quando a notificação push for entregue. As contas também podem exibir dados ao vivo, como a localização de uma entrega ou uma contagem regressiva até que uma oferta expire, na notificação.

Recomendamos trabalhar com o desenvolvedor do seu app para criar suporte aos seus casos de uso específicos.

Recursos adicionais

Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Parceiros
Contrate um especialista certificado pela Klaviyo para ajudá-lo com uma tarefa específica ou para gerenciamento contínuo de marketing.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano