Como configurar recomendações de produtos em e-mails

Definir a Fonte do bloco de Produtos como Recomendações pode classificar produtos por Mais vendidos, De volta ao estoque, Queda de preço, Novidades, Comprados juntos ou Com base no que visualizaram, sem que você precise escolher produtos ou escrever uma regra de catálogo. Consulte Obter produtos recomendados para cada campo que esta fonte adiciona. Três dessas estratégias precisam de dados de fora do seu catálogo para funcionar: Mais vendidos lê seu histórico de pedidos, e Comprados juntos e Com base no que visualizaram leem o que os compradores olharam e compraram. Este guia aborda o que enviar para que cada estratégia tenha algo para classificar.

Dica

Já está enviando PW_AbandonedCart e PW_OrderCreated para recuperação de carrinho abandonado? Continue lendo. A estratégia Mais vendidos precisa de mais um campo no PW_OrderCreated que o guia de carrinho abandonado não aborda.

Antes de começar

Certifique-se de que o catálogo da sua conta tenha produtos. Vá para Conteúdo → Catálogo de Produtos e conecte um feed, importe um CSV ou adicione produtos manualmente. Aprenda como popular seu catálogo.

Assistência de desenvolvedor necessária

O envio dos eventos abaixo requer a ajuda da sua equipe de desenvolvimento, a menos que a integração da sua loja já os envie para você. Por favor, compartilhe este guia com eles.

Contas novas veem o catálogo regular primeiro

Toda estratégia abaixo precisa de um histórico acumulado antes de poder classificar qualquer coisa. Até lá, o bloco mostra o catálogo regular. Veja a nota em Obter produtos recomendados.

Quais estratégias precisam de eventos

Três das seis estratégias classificam produtos a partir de eventos que você envia; as outras três classificam diretamente do seu catálogo e não precisam de nada de você.

Estratégia	Precisa de eventos?	Fonte de dados
De volta ao estoque	Não	Alterações de estoque do catálogo
Queda de preço	Não	Alterações de preço do catálogo
Novidades	Não	Data de “adição” do catálogo
Mais vendidos (7/30 dias)	Sim	PW_OrderCreated / PW_OrderUpdated com items
Com base no que visualizaram	Sim	Qualquer evento que contenha um ID de produto
Comprados juntos	Sim	Qualquer evento que contenha um ID de produto ou os items do pedido, mais uma tag de dispositivo

Uma alteração de estoque ou preço no seu feed, ou a próxima sincronização agendada, atualiza De volta ao estoque, Queda de preço e Novidades automaticamente. Nada a enviar para essas três.

Mais vendidos: adicione itens aos seus eventos de pedido

Mais vendidos (7 dias) e Mais vendidos (30 dias) classificam produtos por quantas unidades foram vendidas nesse período. Eles leem o array items em PW_OrderCreated e PW_OrderUpdated, especificamente o productId e a quantity de cada item.

Se você já envia PW_OrderCreated para limpar tags de carrinho abandonado, essa chamada mínima (apenas com orderId) ainda limpa o carrinho, mas não dá nada para a estratégia Mais vendidos contar. Adicione os itens de linha do pedido à mesma chamada:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293",
      "items": [
        {
          "productId": "SKU-4821",
          "quantity": 1
        },
        {
          "productId": "SKU-5190",
          "quantity": 2
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

O productId deve corresponder ao ID que seu Catálogo de Produtos usa para esse item, para que a estratégia Mais vendidos possa procurar o produto para exibir. Campos de item extras (preço, nome e assim por diante) são ignorados para esta estratégia. Apenas productId e quantity contam para a classificação. O evento também precisa de orderId, porque um pedido sem ele não é contabilizado.

Quando um pedido mudar, envie PW_OrderUpdated com o mesmo orderId e os mesmos items. Para cada produto no evento, a nova quantity substitui a anterior em vez de ser somada a ela. Dessa forma, um produto pode cair para 1 unidade, mas não para zero:

• quantity igual a 0 ou menor: o produto conta como 1 unidade vendida.
• Produto omitido de items: o produto mantém a quantidade do último evento que o incluiu.

Por exemplo, um cliente pede 2 unidades de um produto e devolve ambas. Se você enviar PW_OrderUpdated com a quantity desse produto definida como 0, a estratégia Mais vendidos conta 1 unidade para ele em vez de 2. Se você remover o produto de items, ele ainda conta 2. Nenhum evento remove um produto devolvido ou cancelado de Mais vendidos. Ele só deixa de ser contado quando o pedido sai da janela de 7 ou 30 dias.

Dica

Se você usa a integração com o Shopify, cada pedido pago chega como PW_OrderCreated com o ID do pedido do Shopify como orderId e items contendo productId e quantity, então os pedidos pagos contam para a estratégia Mais vendidos sem nada a adicionar do seu lado. O productId é o ID do produto no Shopify, o mesmo ID que seu catálogo usa quando é importado do Shopify. A integração não envia PW_OrderUpdated, no entanto, então a estratégia Mais vendidos conta as quantidades do pedido original e não reflete edições, reembolsos ou cancelamentos posteriores.

Envie a quantidade como um número

Use um número JSON real para quantity, não uma string entre aspas. O Pushwoosh armazena cada valor de atributo apenas no tipo com o qual foi declarado ou inferido pela primeira vez; um valor incompatível é descartado silenciosamente, e o postEvent ainda retorna sucesso. Veja Use os tipos de atributo corretos para o mesmo aviso sobre o PW_AbandonedCart.

Nota

Mais vendidos classifica especificamente pelo histórico de pedidos. Visualizações e atividade no carrinho não contam. Para uma classificação que também inclua a navegação e a atividade no carrinho, use Com base no que visualizaram ou Comprados juntos.

Com base no que visualizaram e Comprados juntos: rastreie a atividade do produto

Ambas as estratégias se baseiam no mesmo sinal: eventos que carregam um ID de produto. Você não precisa de um nome de evento dedicado para “produto visualizado” — qualquer evento personalizado enviado via postEvent conta, desde que seus attributes incluam uma destas chaves:

• Um único produto, como um atributo de nível superior: product_id, productId, productid, item_id ou sku.
• Vários produtos, como um array products onde cada item tem product_id, productId, id ou sku.

Por exemplo, dispare seu evento de visualização de produto existente com um atributo de ID de produto já nele:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "ProductViewed",
    "attributes": {
      "product_id": "SKU-4821",
      "category": "Audio"
    },
    "userId": "shopper@example.com"
  }
}

Com base no que visualizaram classifica os produtos com os quais cada comprador interagiu recentemente — nenhuma configuração adicional é necessária depois que os eventos acima estiverem fluindo.

Dica

Se você usa a integração com o Shopify, o embed do tema da vitrine já envia PW_ProductViewed com um productId em cada visualização de página de produto — nada a adicionar do seu lado, desde que o botão Push Init Embed esteja ativado (ele fica desativado por padrão). Veja Eventos de navegação na vitrine.

Comprados juntos mostra produtos que os compradores costumam escolher junto com um determinado produto. Por exemplo, para um celular, o bloco pode mostrar as capas e os carregadores que outros compradores de celulares também visualizaram ou compraram. Quanto mais compradores interagiram com os dois produtos, mais alta é a classificação do produto recomendado.

Apesar do nome, compras não são obrigatórias. Visualizações, eventos de carrinho e pedidos contam. A estratégia lê:

• Todo evento que contenha um ID de produto, usando as chaves listadas acima.
• O array items de PW_OrderCreated e PW_OrderUpdated. Os items de outros eventos, incluindo PW_AbandonedCart, não são lidos.

Dois produtos formam um par quando o mesmo usuário enviou eventos para ambos nos últimos 30 dias. Os eventos podem ser separados, então os produtos não precisam estar no mesmo pedido. Os pares são contados dentro de um único aplicativo, então a atividade nos outros aplicativos da sua conta não conta. As classificações são recalculadas uma vez por dia, então novos eventos as afetam a partir do dia seguinte.

Comprados juntos precisa de mais uma coisa: uma Tag de Produto, uma tag de dispositivo que armazena o ID do produto para o qual as recomendações são geradas. Defina o nome do campo ao configurar a estratégia no bloco de Produtos (por exemplo, PW_LastViewedProductID), e mantenha essa tag atualizada em cada dispositivo. Por exemplo, defina-a como o ID do produto sempre que o comprador visualizar um produto. Sem a tag definida em um destinatário, o bloco volta a exibir o catálogo regular para ele.

Regras de nome de tag

O nome da tag aceita apenas letras, dígitos, sublinhados e espaços, pois precisa ser endereçável em Liquid. Veja Comprados juntos precisa de uma Tag de Produto.

Confirme que seus eventos estão chegando

Antes de adicionar o bloco, verifique se o Pushwoosh está realmente recebendo os eventos acima: vá para Público → Eventos, abra o evento que você enviou (PW_OrderCreated ou o evento personalizado que carrega um ID de produto) e confirme que os acessos recentes aparecem. Veja Estatísticas de eventos.

Nota

Um bloco de Produtos vazio pode significar “os eventos nunca chegaram” ou “ainda não há histórico suficiente acumulado” (veja a nota acima). As estatísticas de eventos descartam a primeira causa antes que você investigue a segunda.

Adicione o bloco ao seu e-mail

Adicione um bloco de Produtos ao seu conteúdo de e-mail, defina a Fonte como Recomendações e escolha uma Estratégia. Veja Obter produtos recomendados para cada campo no painel de configurações. Clique em Atualizar visualização para verificar se a tela é preenchida com produtos reais antes de enviar.