Entenda os pares chave-valor

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 com notificações push, tanto padrão (aquelas que são exibidas para os usuários) quanto silenciosas (aquelas que são invisíveis para os usuários).

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 ser configurado para reconhecer chaves e responder aos valores delas; por isso, trabalhe 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ê já configurou as notificações push na sua conta da Klaviyo.

Você pode encontrá-las na aba Comportamentos ao criar uma notificação push. Para usá-los, ative a opção Dados personalizados e, em seguida, adicione chaves e valores. Você pode adicionar até 10 pares de chave-valor por notificação push.

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.
• O push silencioso 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 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