Eventos e campanhas do Shopify

Depois de conectar o app e aprovar as permissões solicitadas pelo Shopify para rastreamento de pedidos, carrinhos e checkout (read_orders, write_pixels, read_customer_events), os eventos de pedido, checkout e etapas de checkout começam a chegar sem uma tela de rastreamento separada do Pushwoosh. Veja Pré-requisitos e a Parte 1 para a etapa de aprovação. A navegação na vitrine (visualizações de produto e adição ao carrinho) também exige que o Push Init Embed esteja ATIVADO.

O rastreamento cobre três grupos de eventos independentes. Cada um exige um acesso diferente, então desativar um não pausa os outros:

• Pedido pago e checkout: chegam do Shopify mesmo que o embed do tema esteja desativado
• Navegação na vitrine (visualizações de produto e adição ao carrinho): exigem que o embed do tema esteja ATIVADO
• Etapas do checkout: exigem as permissões de rastreamento de checkout do Shopify da Parte 1 (write_pixels e read_customer_events), aprovadas separadamente da permissão de rastreamento de pedidos (read_orders) acima

Antes de conectar o app, verifique como o Pushwoosh trata os tipos de atributo de valor monetário e data para PW_OrderCreated e PW_AbandonedCart. Um tipo incorreto enviado antes que você perceba não pode ser corrigido retroativamente.

Eventos de pedido pago e checkout

Use-os para mensagens pós-compra (PW_OrderCreated), journeys ou segmentos de checkout abandonado (PW_AbandonedCart / PW_AbandonedCartUpdate) e mapeamento de conversão de compra. Eles chegam do Shopify mesmo que o comprador bloqueie o rastreamento do navegador:

Requer o app conectado e read_orders aprovado

Nenhum toggle extra além disso: conecte o app na Parte 1 e aprove a permissão de rastreamento de pedidos do Shopify (read_orders). Diferente da navegação na vitrine, esses eventos não dependem de o embed do tema estar ativado.

Nome do evento no Pushwoosh	Quando é disparado
PW_OrderCreated	Um pedido é pago
PW_AbandonedCart	Um comprador inicia o checkout
PW_AbandonedCartUpdate	O comprador adiciona, remove ou altera itens durante um checkout já em andamento

Esses correspondem às notificações de pedido e checkout que o Shopify envia automaticamente ao Pushwoosh (os webhooks orders/paid, checkouts/create e checkouts/update, listados em Entidades sincronizadas).

A própria condição do Shopify Flow, o webhook checkouts/create e a fonte Cart do bloco Products são três coisas diferentes que todas são chamadas de abandono de carrinho. Escolha a que corresponde ao que você está construindo, usando a tabela abaixo.

O que você quer construir	O que usar
Lembrete do Shopify Flow (a própria condição Cart abandonment do Shopify)	Shopify Flow + ação Pushwoosh send notification. Não os eventos PW_AbandonedCart.
Lembrete ou segmento no Pushwoosh a partir do checkout iniciado ou carrinho alterado	Customer Journey ou segmento em PW_AbandonedCart / PW_AbandonedCartUpdate
Mostrar os itens do carrinho do comprador dentro de um e-mail	Fonte Cart do bloco Products (usa a tag PW_AbandonedCartID no momento do envio). Independente de qual gatilho iniciou a journey.

Como esses eventos se comportam. checkouts/create significa apenas que um checkout foi iniciado. O Shopify ainda não decidiu que ele foi abandonado, e nenhum pedido foi confirmado ainda.

Enquanto o comprador edita o checkout, PW_AbandonedCartUpdate é disparado novamente para o mesmo checkout e sobrescreve o carrinho armazenado desde PW_AbandonedCart. E-mails de lembrete que usam a fonte Cart pegam os itens mais recentes no momento do envio. Você não precisa de um segundo gatilho de journey só para atualizar o carrinho.

PW_AbandonedCart e PW_AbandonedCartUpdate definem a tag PW_AbandonedCartID no comprador, que é o que a fonte Cart lê no momento do envio. PW_OrderCreated a limpa imediatamente, então um comprador que já finalizou a compra não recebe o bloco em vez de um lembrete de um carrinho que ele não tem mais. Veja O que acontece quando você envia PW_OrderCreated para o comportamento exato de limpeza.

Um comprador que inicia o checkout duas vezes só reentra na journey se você permitir

Por padrão, uma Customer Journey não permite a reentrada de alguém que já está nela, então um segundo checkouts/create do mesmo comprador enquanto sua primeira journey de carrinho abandonado ainda está em execução é ignorado, não reiniciado. Ative Allow re-entry no gatilho se quiser que cada novo checkout reinicie a contagem do lembrete. Veja Controle se os usuários podem reentrar na campanha.

Atributos dos eventos de pedido e checkout

PW_OrderCreated e PW_AbandonedCart incluem:

Atributo	Descrição
orderId	O identificador do pedido ou checkout
email	O e-mail do comprador
totalPrice	O total do pedido ou carrinho
shippingAmount	O custo de envio
taxAmount	O valor do imposto
discountAmount	O valor do desconto
currency	O código da moeda
items	Os itens de linha do carrinho
customerId	Apenas para clientes registrados, ausente em checkouts de convidados
orderUrl	A página de status do pedido para PW_OrderCreated, ou a URL de recuperação do checkout abandonado para PW_AbandonedCart e PW_AbandonedCartUpdate. Use-a para construir um link ou botão “Finalize sua compra”.
createdDate	Quando o pedido ou checkout foi criado
abandonedDate	Apenas PW_AbandonedCart e PW_AbandonedCartUpdate. Quando o carrinho foi tocado pela última vez, não quando foi criado pela primeira vez

Acerte os tipos de atributo de valor monetário e data

O Pushwoosh infere o tipo de cada atributo a partir do primeiro evento que vê, e essa inferência é pouco confiável para campos de valor monetário e data como totalPrice, shippingAmount, taxAmount, discountAmount e createdDate/abandonedDate acima. Um preço em número inteiro como 129 é inferido como inteiro, o que então trunca 129.90 para 129 em todo evento posterior.

Ainda não conectou o app? Declare PW_AbandonedCart e PW_OrderCreated com os tipos corretos antes de fazer isso, usando a tabela em Crie os eventos no seu Control Panel. Pule a etapa Send the events from your backend desse guia. A integração com o Shopify já os envia para você.

Já conectou? Verifique os tipos agora: vá em Audience → Events no Control Panel, abra PW_AbandonedCart e PW_OrderCreated, e compare cada atributo com a mesma tabela. Corrigir um tipo errado ali o corrige daí em diante, mas qualquer valor já enviado com o tipo errado está perdido para sempre.

Checkouts de convidados ainda podem enviar eventos de pedido e carrinho, mas sem um ID de cliente registrado no evento.

PW_AbandonedCartUpdate carrega os mesmos atributos. Se sua conta também tiver a integração com o Magento conectada, seus pedidos e carrinhos abandonados são publicados nesses mesmos nomes de evento, então um segmento ou journey construído em PW_OrderCreated / PW_AbandonedCart captura ambas as lojas, e os tipos de atributo acima se aplicam a ambas também. O Magento não tem equivalente ao PW_AbandonedCartUpdate, porque não rastreia edições de checkout em andamento.

items em particular chega do Shopify com apenas alguns campos preenchidos.

Os itens do carrinho são enriquecidos a partir do seu Catálogo de produtos

O items que o Shopify envia em PW_AbandonedCart e PW_AbandonedCartUpdate carrega apenas productId, name, sku, quantity e price. O Pushwoosh preenche tudo o mais que faltar nesse item, como description, imageUrl, productUrl, category e outros campos do catálogo, a partir do produto correspondente no seu Catálogo de produtos conectado (veja Conexão automática do catálogo de produtos) sempre que um productId corresponder. Não há nada extra para enviar para isso. Um produto ausente do catálogo simplesmente continua aparecendo com os campos que o Shopify enviou.

Eventos de navegação na vitrine

Use-os para segmentos ou journeys de abandono de navegação, e para estratégias de recomendação por e-mail que precisam de visualizações de produto (por exemplo Based on what they viewed). Veja Como configurar recomendações de produtos em e-mail.

Requer o Push Init Embed ATIVADO

Ative o Push Init Embed na Parte 4. O mesmo embed de tema usado para web push. Nada mais a adicionar ao tema.

Se o embed estiver desativado, ou um comprador bloquear seu script, você perde apenas visualizações de produto e adição ao carrinho. PW_OrderCreated e PW_AbandonedCart continuam chegando do Shopify.

Ambos os eventos são coletados pelo mesmo embed de tema. Nada mais a adicionar ao tema depois que o Push Init Embed estiver ATIVADO:

• PW_ProductViewed: o comprador abre uma página de produto.
• PW_AddToCart: o comprador adiciona um item ao carrinho sem recarregar a página, que é como a maioria dos temas do Shopify faz isso.

Duas coisas para verificar antes de construir sobre esses eventos

• PW_ProductViewed conta todo carregamento de página, sem filtragem. Recarregamentos, visualizações repetidas na mesma visita e até tráfego de bots contam da mesma forma que uma visualização de produto real. Uma estratégia de recomendação construída sobre esse evento herda esse ruído.
• PW_AddToCart só é disparado se o botão Add to cart da sua loja não recarregar a página. Teste você mesmo: clique em Add to cart na sua loja e observe o que acontece. Apenas o contador do carrinho é atualizado, ou a página inteira é recarregada? A maioria dos temas do Shopify faz o primeiro, atualizando o contador sem recarregar (uma requisição em segundo plano para /cart/add). Se o seu tema recarregar a página em vez disso, PW_AddToCart nunca será disparado, mas PW_ProductViewed e os eventos de pedido/checkout continuam funcionando normalmente de qualquer forma.

Atributos dos eventos de navegação na vitrine

Ambos os eventos incluem:

Atributo	Descrição
items	O(s) produto(s) visualizado(s) ou adicionado(s), cada um com productId, name, sku, quantity, price
totalPrice	O preço combinado de items
productUrl	A página em que o comprador estava
currency	Apenas quando a vitrine o expõe

Uma mensagem que exibe totalPrice precisa de um fallback para quando currency estiver ausente, já que o número sozinho não diz em qual moeda está.

Nenhum dos dois eventos carrega email ou customerId como atributo. O comprador é identificado da mesma forma que o restante do embed do tema faz isso, por meio da sessão do SDK vinculada ao User ID do metacampo (veja a Parte 2), não pelo payload do evento.

Os items de PW_ProductViewed e PW_AddToCart carregam os mesmos campos que o Shopify envia antes do enriquecimento: productId, name, sku, quantity, price. O Pushwoosh não preenche os demais campos do catálogo para esses dois eventos, como faz para os items de PW_AbandonedCart (veja Os itens do carrinho são enriquecidos a partir do seu Catálogo de produtos acima).

Uma estratégia de recomendação que precisa de detalhes completos do produto, como Based on what they viewed, os busca no seu Catálogo de produtos pelo productId quando a mensagem é renderizada. Veja Como configurar recomendações de produtos em e-mail para o que cada estratégia precisa.

Eventos de etapas do checkout

Use-os para ver onde as pessoas desistem antes da compra, e para enviar mensagens a pessoas que iniciaram o checkout mas não chegaram a um pedido pago.

Requer permissões do app relacionadas a pixels

Aprove as permissões de rastreamento de checkout que o Shopify solicita ao conectar o app (write_pixels e read_customer_events). Veja a Parte 1 para essa etapa. Sem etapa de embed de tema. O Shopify relata esses marcos automaticamente assim que essas permissões são aprovadas (tecnicamente, por meio do Web Pixel do Shopify).

• PW_CheckoutContactInfo: o comprador inseriu suas informações de contato.
• PW_PaymentInfoSubmitted: o comprador enviou os detalhes de pagamento.

Uma venda concluída é PW_OrderCreated da seção acima, não esses dois eventos.

PW_AbandonedCart só diz que um checkout foi iniciado. Esses dois eventos marcam dois pontos posteriores no mesmo checkout, nessa ordem: informações de contato primeiro, detalhes de pagamento depois. Um comprador que chegou a PW_PaymentInfoSubmitted e nunca teve um PW_OrderCreated seguinte foi mais longe do que alguém que só disparou PW_AbandonedCart, então uma mensagem construída sobre esse estágio pode abordar um pagamento travado especificamente, em vez de um lembrete genérico de carrinho.

Atributos dos eventos de etapas do checkout

Ambos os eventos incluem:

Atributo	Descrição
items	Os itens de linha do checkout, cada um com productId, name, sku, quantity, price
orderId	O token do checkout, ou o ID do pedido do Shopify assim que o checkout tiver um
totalPrice	O total do checkout
email	Apenas quando o checkout tiver um. Um checkout baseado em telefone (sem e-mail inserido) envia o evento sem ele.
currency	Apenas quando o checkout tiver um

Verifique se funciona

Faça a ação correspondente na loja, depois confirme que o nome do evento aparece no Pushwoosh. O próprio evento é processado em tempo real, mas os dois lugares onde você o verificaria reagem de forma diferente a um nome que o Pushwoosh ainda não viu:

• No menu suspenso Event ao criar um segmento por eventos, um novo nome aparece imediatamente.
• No menu suspenso Event ao adicionar um gatilho de Customer Journey, um novo nome pode levar até 10 minutos para aparecer (esse menu é armazenado em cache). Se ainda não o vir, espere em vez de presumir que a integração está quebrada.

Ação de teste	Evento
Pagar um pedido de teste	PW_OrderCreated
Iniciar um checkout	PW_AbandonedCart
Alterar itens nesse checkout	PW_AbandonedCartUpdate
Abrir uma página de produto (Push Init Embed ATIVADO)	PW_ProductViewed
Adicionar um item ao carrinho	PW_AddToCart
Inserir informações de contato no checkout	PW_CheckoutContactInfo
Enviar informações de pagamento no checkout	PW_PaymentInfoSubmitted

Use os eventos

Depois de saber qual evento você precisa, use-o em dois lugares:

• Como um gatilho ou condição de segmento: escolha-o no menu suspenso Event ao criar um segmento por eventos ou adicionar um gatilho de Customer Journey.
• No texto da mensagem: na etapa de mensagem, ative Personalize message with event attributes e escolha o atributo (por exemplo, o total do pedido de PW_OrderCreated). Você também pode inserir o atributo com um placeholder Liquid. Veja Conteúdo dinâmico e templates Liquid em journeys.

Para pedidos pagos, você também pode mapear PW_OrderCreated como um evento de conversão para que as compras do Shopify alimentem a segmentação RFM, a atribuição de journey e as estatísticas do bloco Product.

Exemplos de campanhas

Cada uma dispara em um ponto diferente do caminho do comprador, então alcançam públicos diferentes: quão longe alguém chegou antes de desistir, ou se chegou ao checkout, decide qual se aplica.

• Lembrete de carrinho abandonado. Captura todo comprador que iniciou o checkout, não importa quão longe chegou: o público mais amplo aqui. Construa como uma Customer Journey: gatilho em PW_AbandonedCart, espere por PW_OrderCreated, depois envie um e-mail com um bloco de fonte Cart para quem não pagou. Veja Como configurar uma campanha de carrinho abandonado para a configuração completa.
• Acompanhamento para checkouts travados. Captura apenas compradores que chegaram a inserir informações de contato mas nunca pagaram, uma fatia mais estreita do público acima. Segmente em PW_CheckoutContactInfo, depois exclua quem também tiver PW_PaymentInfoSubmitted ou PW_OrderCreated.
• Recuperação de pagamento travado. Captura compradores que chegaram ao pagamento mas nunca concluíram o pedido, mais adiante do que o acompanhamento acima e mutuamente exclusivo com ele. Segmente em PW_PaymentInfoSubmitted, depois exclua quem também tiver PW_OrderCreated.
• E-mail de recomendação de navegação. Captura compradores que olharam produtos mas nunca iniciaram o checkout, um público diferente dos lembretes acima. Use PW_ProductViewed com a estratégia Based on what they viewed do bloco Products. Veja Como configurar recomendações de produtos em e-mail.