Visão geral
Este guia apresenta várias maneiras de implementar lembretes de carrinho abandonado no OneSignal. Você aprenderá como sincronizar dados do carrinho e personalizar emails ou notificações push quando os usuários deixarem itens para trás. Você pode implementar modelos de carrinho abandonado com:- API
custom_data— passe detalhes do carrinho inline com sua solicitação de mensagem. - Tags — armazene pares chave-valor para personalizar mensagens.
- Eventos Personalizados — acione Jornadas a partir de eventos do usuário como
cart_updated. - Feeds de Dados — extraia dados do carrinho em tempo real diretamente da sua API no momento do envio da mensagem.
Exemplos de configuração
- API: custom_data
- Eventos Personalizados
- Feeds de Dados
Use a API Create Message com a propriedade 
custom_data para injetar dados do carrinho armazenados em seu servidor. Ideal para dados de carrinho controlados pelo servidor.Exemplo de payload custom_data:JSON
Modelo de email de carrinho abandonado
Este exemplo de modelo de email demonstra como exibir os itens docart Usando Sintaxe Liquid:- Número total de itens no carrinho
- Itens no carrinho do usuário incluindo:
- Imagem do produto
- Nome do produto
- Quantidade do produto
- Preço do produto
- Link para o URL personalizado do carrinho do cliente
Exemplo de modelo de email de carrinho abandonado
Configuração do modelo de email
1
Crie um novo modelo de email
Navegue até Mensagens > Modelos > Novo Modelo de Email.
2
Use o Editor de Arrastar e Soltar
3
Crie 5 linhas com o seguinte:
- Linhas 1, 2 e 4 têm 1 coluna com um bloco de Texto.
- Linha 3 tem 4 colunas com: bloco HTML | bloco de Texto | bloco de Texto | bloco de Texto
- Linha 5 tem 1 coluna com um bloco de Botão
Configuração do modelo de email de carrinho abandonado
Exibir contagem de itens no email
Usando a sintaxe Liquid, mostre o número de produtos usando a propriedadesize.
No bloco de Texto da linha 1 do seu modelo, defina seu texto conforme desejado.Exemplo:Exibir itens no email
Use um for-loop Liquid para iterar sobre seu array de carrinhocustom_data.No bloco de Texto da linha 2 do modelo, defina: {% for product in message.custom_data.cart %} que inicia o for-loop.A linha 3 com as 4 colunas terá o seguinte no bloco HTML da 1ª coluna:{{product.cartProductName}}{{product.cartQuantity}}{{product.cartPrice}}
{% endfor %}O for-loop verifica cada product no array cart que passamos para custom_data e exibe o valor de cada produto nas colunas.Exemplo de modelo de email de carrinho abandonado para mostrar itens
Adicionar um URL de carrinho personalizado no email
Isso é opcional e necessário apenas se seus carrinhos são personalizados para um URL específico por cliente.Existem várias maneiras de configurar o URL do carrinho. Neste exemplo, passamos o URL completo para o carrinho dentro docustom_data: "cart_url": "https://seudominio.com/cart"Consulte URLs Dinâmicos para mais detalhes.No bloco de Botão > Propriedades do Conteúdo > Ação > Url, defina {{message.custom_data.cart_url}}Exemplo de modelo de email de carrinho abandonado para URL personalizado
Finalizar o modelo de email
Consulte Criar Emails com Arrastar e Soltar para mais detalhes sobre como personalizar o modelo.Quando estiver pronto, você pode usar o
template_id em suas solicitações de API Create message com a propriedade custom_data.Modelo de Push de Carrinho Abandonado
Este exemplo de modelo de push demonstrará como exibir um item no carrinho do usuário, incluindo sua imagem e nome. Também exibe quantos itens totais estão no carrinho e vincula ao URL personalizado do carrinho do cliente.Exemplo de modelo de push de carrinho abandonado
Configuração do Modelo de Push
Notificações push podem ser enviadas apenas com uma quantidade limitada de dados. Em vez de listar todos os itens no carrinho, queremos exibir o primeiro item e mencionar quantos itens totais existem.Navegue até Mensagens > Modelos > Novo Modelo de PushExibir item e contagem de itens no push
A sintaxe Liquid fornece declarações if que podemos usar para alterar o que a mensagem diz dependendo de quantos itens estão no arraycart do seu objeto custom_data.No campo Mensagem do modelo, adicione o seguinte texto:cart como sendo custom_data.cart, depois atribuímos a variável item_count como sendo cart.size, e, se essa contagem for igual a 1, 2 ou mais que 2, exibimos conteúdo diferente.Devido ao carrinho possivelmente ter mais de 1 item, usamos a propriedade first para obter o primeiro item no carrinho.Usamos o recurso minus para reduzir a contagem total de itens do carrinho em 1, já que já o mencionamos.Exibir imagem do item no push
No campo Imagem do modelo, adicione a propriedade de URL da Imagem com a sintaxe liquid. Se a imagem não existir, nenhuma imagem será exibida. Você também pode definir uma imagemdefault. Exemplo:Adicionar um URL de carrinho personalizado no push
No campo URL de Inicialização do modelo, adicione a propriedade de URL do carrinho com a sintaxe liquid. Se o carrinho não existir, o push direcionará para a página inicial do site ou aplicativo.Nota sobre URL de Inicialização em Modelos: definirhttps:// ou algum outro esquema no formato x:// é necessário. Se você definir isso nos dados, pode usar o recurso remove da sintaxe liquid da seguinte forma:https://{{message.custom_data.cart_url | remove: "https://"}}
Atualizar o modelo de push e enviar a mensagem
Consulte Enviar Mensagens para mais detalhes sobre as opções fornecidas em modelos de push.Quando estiver pronto, você pode usar o
template_id em suas solicitações de API Create message com a propriedade custom_data.Precisa de ajuda?Converse com nossa equipe de Suporte ou envie email para
support@onesignal.comPor favor inclua:- Detalhes do problema que você está enfrentando e passos para reproduzir se disponível
- Seu OneSignal App ID
- O External ID ou Subscription ID se aplicável
- A URL para a mensagem que você testou no Dashboard OneSignal se aplicável
- Quaisquer logs ou mensagens de erro relevantes