Como configurar uma campanha de carrinho abandonado

Compradores que adicionam itens a um carrinho e saem sem comprar são algumas das conversões mais fáceis de recuperar. Eles já demonstraram intenção.

Este guia mostra como enviar a eles um e-mail de carrinho abandonado no Pushwoosh: dispare o evento PW_AbandonedCart da sua loja, mostre os itens deixados para trás no e-mail com o bloco de Produtos e acione o envio a partir de uma Customer Journey.

O que é PW_AbandonedCart

PW_AbandonedCart marca que um usuário deixou itens em seu carrinho sem comprar. Não é um evento padrão integrado. É um nome de evento compartilhado usado em todas as integrações de e-commerce do Pushwoosh para que as jornadas, o bloco de Produtos e os segmentos funcionem da mesma maneira.

• Integração com Magento: envia PW_AbandonedCart e PW_OrderCreated para você automaticamente.
• Qualquer outra loja ou backend personalizado: sua equipe envia ambos os eventos via postEvent com os nomes e atributos em Como enviar lembretes de carrinho abandonado.

O que acontece quando você envia PW_AbandonedCart

O envio de PW_AbandonedCart faz duas coisas do lado do Pushwoosh:

1. É registrado como qualquer outro evento personalizado, para que você possa vê-lo nas estatísticas de Eventos e usá-lo em segmentos.
2. O Pushwoosh armazena o conteúdo do carrinho e marca o usuário com:
   • PW_AbandonedCartID: um identificador para o carrinho atual, usado para buscar seu conteúdo no momento do envio.
   • PW_AbandonedCartDate: o valor abandonedDate do payload do evento.

O que acontece quando você envia PW_OrderCreated

Quando o comprador faz um pedido, envie PW_OrderCreated (ou PW_OrderUpdated). O Pushwoosh limpa PW_AbandonedCartID e PW_AbandonedCartDate para esse usuário imediatamente. Ele não corresponde aos valores de orderId: qualquer pedido do usuário remove ambas as tags, mesmo que a compra tenha sido para um carrinho diferente.

Exemplo: Um comprador abandona o carrinho ORDER-100 e depois compra o ORDER-200 antes que o lembrete seja enviado. O Pushwoosh limpa as tags, então ele não receberá um lembrete sobre o ORDER-100.

O que aparece no e-mail de lembrete

O bloco de Produtos lê o carrinho armazenado no perfil do usuário no momento do envio. Ele não usa a lista de itens do evento PW_AbandonedCart que iniciou a jornada.

• Mesmo orderId: cada novo PW_AbandonedCart substitui o carrinho armazenado. O lembrete mostra os itens mais recentes.
• orderId diferente: O Pushwoosh armazena um carrinho separado. Os itens não são mesclados.

Como enviar lembretes de carrinho abandonado

Siga estes passos para criar os eventos, enviá-los da sua loja, construir o e-mail e lançar a Customer Journey.

Crie os eventos no seu Control Panel

1. Vá para Audience → Events no seu Pushwoosh Control Panel e clique em Criar Evento.

2. Crie um evento personalizado chamado PW_AbandonedCart com estes atributos:

   Atributo	Tipo
   email	string
   orderId	string
   customerId	string
   orderUrl	string
   abandonedDate	date
   createdDate	date
   totalPrice	decimal (price)
   shippingAmount	decimal (price)
   taxAmount	decimal (price)
   discountAmount	decimal (price)
   currency	string

3. Repita para PW_OrderCreated com um único atributo orderId.

Use os tipos de atributo corretos

O Pushwoosh armazena apenas os atributos que você declarou ao criar o evento, e apenas nos tipos que você escolheu. Campos extras, campos ausentes ou valores que não correspondem ao tipo são descartados sem erro. postEvent ainda retorna sucesso, então você não verá na resposta que os dados foram perdidos.

Para que o carrinho abandonado funcione, corresponda aos tipos na tabela acima:

• Campos de dinheiro (totalPrice, shippingAmount, taxAmount, discountAmount): use decimal (price). Declarado como string, o carrinho não é armazenado e nenhuma tag é definida. Declarado como integer, 129.90 se torna 129.
• Datas (abandonedDate, createdDate): use date.
• items: não o adicione à definição do evento. Envie-o no payload JSON como um array de objetos. Use números JSON reais para price e quantity, não strings entre aspas.

Saiba mais sobre como criar eventos personalizados.

Envie os eventos do seu backend

Necessária a ajuda de um desenvolvedor

Você precisará da ajuda da sua equipe de desenvolvimento para enviar eventos da sua loja ou backend. Por favor, compartilhe este guia com eles.

Peça à sua equipe de desenvolvimento para chamar postEvent sempre que um carrinho for abandonado, usando este esquema de atributos:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_AbandonedCart",
    "attributes": {
      "email": "shopper@example.com",
      "orderId": "ORDER-10293",
      "customerId": "CUST-4471",
      "orderUrl": "https://yourstore.com/cart/restore/ORDER-10293",
      "abandonedDate": "2026-07-28T10:15:00Z",
      "createdDate": "2026-07-28T09:40:00Z",
      "totalPrice": 129.90,
      "shippingAmount": 9.90,
      "taxAmount": 0,
      "discountAmount": 0,
      "currency": "USD",
      "items": [
        {
          "productId": "SKU-4821",
          "name": "Wireless headphones",
          "quantity": 1,
          "price": 119.90,
          "sku": "SKU-4821",
          "description": "Over-ear, noise-cancelling",
          "imageUrl": "https://yourstore.com/media/sku-4821.jpg",
          "productUrl": "https://yourstore.com/products/sku-4821",
          "category": "Audio"
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

Quando o carrinho se converter em um pedido, envie PW_OrderCreated apenas com o orderId para limpar as tags do carrinho:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293"
    },
    "userId": "shopper@example.com"
  }
}

Dica

Se você usa a integração com Magento, não precisa enviar esses eventos do seu backend. O Magento envia PW_AbandonedCart e PW_OrderCreated para você de forma agendada.

Adicione um bloco de Produtos ao seu e-mail

1. Abra o editor de conteúdo de e-mail e adicione um bloco de Produtos à tela.
2. No painel de configurações, defina a Fonte como Carrinho.

Nota

A fonte Carrinho do bloco de Produtos requer Content Templates no seu plano e um token de acesso à API. Consulte bloco de Produtos.

3. Defina Máximo de produtos exibidos para limitar quantos itens do carrinho aparecem no e-mail.

4. Estilize a grade e o modelo de cartão conforme necessário. Consulte Estilizar a grade.

Quando o e-mail é enviado, o bloco de Produtos procura o carrinho armazenado de cada destinatário usando sua tag PW_AbandonedCartID. Em seguida, ele preenche o bloco com os itens atuais do carrinho: imagem, título, preço e um link de volta para o carrinho. O layout vem do modelo de cartão que você definiu no editor. Destinatários sem essa tag (nada abandonado ou já pedido) pulam o bloco em vez de mostrar conteúdo vazio, então é seguro usá-lo também em uma campanha mais ampla.

Dica

A fonte Carrinho está disponível no editor de conteúdo de e-mail. Para lembrar os compradores com um push, use uma etapa de Push com personalização que faça referência aos detalhes do carrinho do evento.

Construa a Customer Journey

1. Adicione uma Entrada Baseada em Gatilho usando o evento PW_AbandonedCart.
2. Adicione uma etapa de Aguardar Gatilho. Defina seu período de espera para uma ou duas horas. Nomeie o ramo como Pedido realizado e adicione o evento PW_OrderCreated a ele.

Cuidado

Defina o período de espera no próprio Aguardar Gatilho. Não adicione uma etapa separada de Atraso de Tempo antes dele.

Aguardar Gatilho só começa a escutar por PW_OrderCreated quando o comprador atinge essa etapa. Se o Atraso de Tempo vier primeiro e o comprador fizer um pedido durante esse atraso, o evento do pedido não será detectado. O comprador se move para o ramo Não acionado, mas o PW_OrderCreated já limpou o PW_AbandonedCartID. O bloco de Produtos não encontra nenhum carrinho e o pula. O comprador ainda recebe o e-mail de carrinho abandonado sem produtos, mesmo que já tenha concluído a compra.

3. Direcione o ramo Pedido realizado para Sair. O usuário já comprou, então não o lembre.
4. Direcione o ramo Não acionado para a etapa de E-mail. Salve o e-mail que você construiu em Adicione um bloco de Produtos ao seu e-mail como conteúdo de e-mail, e então selecione-o como o conteúdo desta etapa.

Teste antes de lançar

1. Envie um evento de teste PW_AbandonedCart para um dispositivo de teste. Não defina a tag PW_AbandonedCartID manually: o bloco de Produtos carrega o conteúdo do carrinho armazenado que o evento cria, não do valor da tag. Sem um evento real, o bloco renderiza vazio.
2. Visualize o e-mail e confirme o layout e o conteúdo do produto antes de enviar para compradores reais.