Integração com o Shopify

Visão geral da integração

O Pushwoosh se integra perfeitamente com o Shopify, uma plataforma de e-commerce líder que permite que as empresas criem, gerenciem e escalem lojas online. Este guia orienta você na instalação e configuração do aplicativo Pushwoosh em sua loja Shopify, na configuração da identificação do usuário e no uso de notificações e ferramentas de automação para engajar clientes em canais como push, e-mail, SMS e WhatsApp.

Tipo de integração

• Destino: O Shopify envia dados de clientes para o Pushwoosh, onde são usados para segmentação e mensagens.

Pré-requisitos

• Uma conta Pushwoosh
• Acesso ao seu painel de administração do Shopify
• Token de Acesso da API de Dispositivo e Código de Aplicação do Pushwoosh
• Uma loja Shopify com dados de clientes e pedidos disponíveis
• Aprovação do escopo de acesso read_orders para eventos de pedido/carrinho, e write_pixels mais read_customer_events para rastreamento de etapas de checkout

Já conectado? Você será solicitado a reaprovar o acesso

Se você conectou o aplicativo Pushwoosh antes do rastreamento de pedidos, carrinhos e checkout existir, o Shopify solicitará que você aprove os novos escopos na próxima vez que abrir o aplicativo — esta é a maneira esperada que o Shopify implementa permissões adicionais, não um erro. Aprove-os para começar a receber eventos de pedido, carrinho e checkout.

Entidades sincronizadas

• Clientes: Usado para atribuir e identificar User IDs do Pushwoosh através de metafields do Shopify

Nota

Abordagens de sincronização de clientes no Pushwoosh

Devido a limitações técnicas, o Pushwoosh oferece vários métodos de sincronização de clientes, dependendo do canal de comunicação usado para as notificações:

• E-mail, Web, SMS e WhatsApp: Dispositivos/usuários são registrados automaticamente na aplicação Pushwoosh.
• Aplicativos Móveis e de Desktop: Dispositivos/usuários podem ser sincronizados manualmente através dos painéis de administração do Pushwoosh e do Shopify.
• Plataformas Web (Chrome, Firefox, Safari): Dispositivos/usuários são gerenciados pelo próprio embed do tema do Shopify.

Como funciona?

O processo de sincronização opera da seguinte forma:

1. O sistema tenta recuperar a sessão do usuário atual para obter um e-mail ou número de telefone (identificadores que funcionam sem configuração adicional).
2. Se bem-sucedido, o e-mail ou número de telefone é definido como o identificador userID tanto para o Pushwoosh quanto para a propriedade pushwoosh_userid nos dados do cliente.
3. Se isso não for possível, o userID padrão do SDK do Pushwoosh é atribuído como o identificador tanto para o Pushwoosh quanto para a propriedade pushwoosh_userid.
4. Em qualquer caso, um userID será atribuído em ambos os lados, garantindo uma sincronização consistente.

• Segmentos de clientes: Usado para segmentação e mensagens baseadas em grupos
• Eventos e gatilhos (por exemplo, pedidos feitos, tags aplicadas): Usado no Shopify Flow para automatizar mensagens em todos os canais
• Vitrine (Storefront): Usado para capturar opt-ins de web push através de scripts incorporados
• Feed de produtos: O feed da vitrine da sua loja (products.json) se conecta automaticamente ao Catálogo de Produtos do Pushwoosh quando você conecta o aplicativo, e se desconecta automaticamente se você o desinstalar.
• Pedidos e carrinhos: Eventos de servidor para servidor dos webhooks orders/paid, checkouts/create e checkouts/update do Shopify. Veja Rastrear pedidos, carrinhos e etapas de checkout.
• Comportamento de navegação na vitrine: Visualizações de produtos e ações de adicionar ao carrinho, coletadas pelo mesmo embed de tema usado para opt-ins de web push.
• Etapas de checkout: Informações de contato inseridas e informações de pagamento enviadas, coletadas através de um Web Pixel do Shopify.

Glossário (mapeando nomes de entidades se forem diferentes)

Shopify	Pushwoosh
Cliente	User ID
webhook orders/paid	Evento PW_OrderCreated — compartilhado com outras integrações de e-commerce (por exemplo, Magento)
webhook checkouts/create	Evento PW_AbandonedCart — mesmo evento compartilhado, também usado pela fonte de Carrinho do bloco de Produtos
webhook checkouts/update	Evento PW_AbandonedCartUpdate — dispara enquanto o comprador continua editando o mesmo checkout, sobrescrevendo o carrinho armazenado de PW_AbandonedCart
Visualização de página de produto	Evento PW_ProductViewed
Adicionar ao carrinho (sem recarregar a página)	Evento PW_AddToCart
Web Pixel checkout_contact_info_submitted	Evento PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Evento PW_PaymentInfoSubmitted

Como a integração funciona

O Pushwoosh atua como um destino de mensagens para o Shopify. Uma vez integrado, o Shopify envia dados de clientes e comportamentais para o Pushwoosh, onde alimenta notificações em tempo real, segmentação de clientes e mensagens personalizadas em todos os canais.

Componentes chave da integração

1. Identificação de clientes via metafields A cada cliente do Shopify é atribuído um User ID único, armazenado em um metafield (custom.pushwoosh_userid). Este ID permite que o Pushwoosh reconheça e envie mensagens aos usuários de forma consistente em todas as plataformas.

2. Automação orientada a eventos via Shopify Flow O Pushwoosh fornece ações do Flow que permitem automatizar mensagens (push, e-mail, SMS, WhatsApp) com base em eventos do Shopify, como:

   • Novo pedido realizado
   • Tag aplicada ao cliente
   • Abandono de carrinho

3. Segmentação baseada em segmentos Segmentos de clientes do Shopify podem ser usados para enviar notificações específicas para grupos em todos os canais, como promoções para compradores de primeira viagem ou campanhas de reativação para usuários inativos.

4. Mensagens manuais e em tempo real Na visualização de cliente ou segmento do Shopify, você pode acionar manualmente notificações usando as Extensões do Pushwoosh:

   • Notificação por Cliente: Para acompanhamentos pessoais ou testes
   • Notificação por Segmento: Para mensagens baseadas em campanhas

Notificações de web push via embed na vitrine

Ao habilitar o embed do Pushwoosh em seu tema do Shopify, você pode solicitar que os visitantes do site optem por receber notificações push baseadas no navegador — sem a necessidade de um aplicativo móvel.

Visão geral do fluxo de dados

Dados de Clientes e Eventos do Shopify
         ↓
API do Pushwoosh (via App)
         ↓
User ID → Segmentação → Notificações Acionadas ou Manuais

Esta integração capacita você a entregar mensagens oportunas e relevantes que melhoram a retenção de usuários, aumentam as conversões e aprimoram a experiência do cliente — automaticamente ou sob demanda.

Parte 1. Instalação

Faça login no Shopify

1. Vá para o Admin do Shopify
2. Selecione sua loja no painel

Nota

Este guia assume que você já tem uma conta Pushwoosh. Se não, crie uma

Instale o aplicativo Pushwoosh

1. Visite a página do Pushwoosh na App Store
2. Clique em Instalar
3. Confirme a instalação na caixa de diálogo do Shopify

Conecte seu aplicativo Pushwoosh

Após a instalação, você será redirecionado para o aplicativo Pushwoosh dentro do Shopify.

1. Clique em Conectar.

2. Insira o Código de Aplicação e a Chave de API, que você pode encontrar no Painel de Controle do Pushwoosh → Configurações → Acesso à API. A Chave de API aqui é o seu Token de Acesso da API de Dispositivo.

Quando conectado, uma mensagem de sucesso aparecerá: “Aplicativo Pushwoosh conectado.”

Quando o Shopify solicitar permissões (pedidos, pixels, eventos de clientes), aprove-as. Esses escopos são necessários para o rastreamento da Parte 5. Se você conectou o aplicativo anteriormente, veja Já conectado? Você será solicitado a reaprovar o acesso.

Conexão automática do catálogo de produtos

Conectar o aplicativo também conecta o feed da vitrine da sua loja ao Catálogo de Produtos do Pushwoosh automaticamente. Nenhuma configuração de feed separada é necessária. A moeda da sua loja é capturada ao mesmo tempo e atualiza automaticamente se você alterar a moeda da sua loja posteriormente.

Assine um plano

1. Clique em Atualizar Assinatura
2. Um único plano baseado em uso será mostrado.
3. Confirme o faturamento.

Nota

O faturamento é necessário para usar os recursos de entrega de mensagens e segmentação.

Parte 2. Configuração: User ID do cliente via metafields

Para entregar notificações a usuários identificados em todos os canais (push, e-mail, SMS, WhatsApp), o Pushwoosh usa um User ID único por cliente. O Shopify armazena esse valor nos Metafields do Cliente do Shopify.

1. Vá para Configurações → Metafields e metaobjetos → Clientes

2. Clique em Adicionar definição e use estes valores:

Campo	Valor
Namespace e chave	custom.pushwoosh_userid
Namespace	custom
Tipo	Texto de linha única
Validação	Nenhuma
Acesso à Conta do Cliente	Leitura e Escrita
Acesso à API da Vitrine	Habilitado

Defina o Acesso às contas de clientes e o Acesso à API da vitrine como na tabela acima.

Por que isso é importante

Este metafield é um identificador de usuário persistente em dispositivos móveis/web para notificações e segmentação.

Parte 3. Usando as extensões do Pushwoosh

O Pushwoosh inclui Extensões do Shopify para segmentação, automação (Flow) e notificações específicas para clientes.

Extensão 1. Enviar notificação por cliente

Caso de uso

Envie manualmente mensagens personalizadas ou teste notificações para um usuário específico.

Passos

1. Abra Clientes → Selecione um cliente
2. Clique em Mais ações → Notificação por cliente
3. Selecione a plataforma de mensagens (por exemplo, E-mail) e um preset de conteúdo.
4. Clique em Enviar

Dica

Use isso para lembretes pós-compra, agradecimentos pessoais ou prompts de reativação.

Extensão 2. Notificação por segmento

Caso de uso

Segmente grupos de clientes — carrinhos abandonados, compradores de primeira viagem, grandes gastadores.

Passos

1. Vá para Clientes → Segmentos

2. Escolha um segmento → Clique em Usar Segmento

3. Selecione Notificação por Segmento
4. Selecione o canal de comunicação desejado e o preset de mensagem. Clique em Enviar.

Dica

Os segmentos podem ser criados com base no histórico de compras, localização, atividade ou tags.

Extensão 3. Pushwoosh no Shopify Flow

Caso de uso

Automatize mensagens em jornadas de clientes usando gatilhos como pedidos, tags ou comportamento.

Passos

1. Crie um novo Flow no Shopify Flow
2. Adicione ação → Escolha Pushwoosh enviar notificação

3. Configure a mensagem e os campos dinâmicos

Por exemplo:

• Enviar uma mensagem após o pedido ser feito

• Lembrar o usuário quando o carrinho for abandonado

• Enviar um push de reativação após 30 dias de inatividade

Parte 4. Habilitar web push (e eventos de navegação na vitrine)

Opcional apenas para web push. Obrigatório se você precisar de eventos de visualização de produto e adição ao carrinho na Parte 5.

Ative o embed do tema para web push do navegador em sua vitrine:

1. Vá para Loja Online → Temas → Personalizar
2. Abra App Embeds no menu esquerdo
3. Ative o Push Init Embed

Nota

Agora sua loja pode solicitar que os usuários optem por receber web push diretamente da vitrine. Se você pular esta etapa, também não receberá eventos de navegação na vitrine na Parte 5. Eventos de pedido pago e checkout ainda chegam sem isso.

Parte 5. Rastrear pedidos, carrinhos e etapas de checkout

Depois de conectar o aplicativo 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 Parte 1 para a etapa de aprovação. A navegação na vitrine (visualizações de produtos e adição ao carrinho) também precisa que o Push Init Embed esteja ATIVADO.

O rastreamento abrange três grupos de eventos independentes. Cada um precisa de 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 produtos e adição ao carrinho): precisam do embed do tema ATIVADO
• Etapas de checkout: precisam das 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 aplicativo, verifique como o Pushwoosh lida com os tipos de atributos de dinheiro e data para PW_OrderCreated e PW_AbandonedCart. Um tipo errado enviado antes de você perceber não pode ser corrigido retroativamente.

Eventos de pedido pago e checkout

Use-os para mensagens pós-compra (PW_OrderCreated), jornadas 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 aplicativo conectado e read_orders aprovado

Nenhum botão extra além disso: conecte o aplicativo 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 dispara
PW_OrderCreated	Um pedido é pago
PW_AbandonedCart	Um comprador inicia o checkout
PW_AbandonedCartUpdate	O comprador adiciona, remove ou altera itens durante um checkout existente

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

A própria condição de Flow do Shopify, o webhook checkouts/create e a fonte de Carrinho do bloco de Produtos são três coisas diferentes que são todas 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 (condição de Abandono de carrinho do próprio Shopify)	Shopify Flow + ação Pushwoosh enviar notificação. Não os nomes de eventos PW_AbandonedCart.
Lembrete ou segmento no Pushwoosh a partir do início do checkout ou alteração do carrinho	Customer Journey ou segmento em PW_AbandonedCart / PW_AbandonedCartUpdate
Mostrar os itens do carrinho do comprador dentro de um e-mail	Fonte de Carrinho do bloco de Produtos (Cart source) (usa a tag PW_AbandonedCartID no momento do envio). Separado de qual gatilho iniciou a jornada.

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

Enquanto o comprador edita o checkout, PW_AbandonedCartUpdate dispara novamente para o mesmo checkout e sobrescreve o carrinho armazenado de PW_AbandonedCart. E-mails de lembrete que usam a fonte de Carrinho pegam os itens mais recentes no momento do envio. Você não precisa de um segundo gatilho de jornada apenas para atualizar o carrinho.

PW_AbandonedCart e PW_AbandonedCartUpdate definem a tag PW_AbandonedCartID no comprador, que é o que a fonte de Carrinho lê no momento do envio. PW_OrderCreated a limpa imediatamente, então um comprador que já finalizou a compra pula o bloco em vez de receber um lembrete para um carrinho que 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 reentra na jornada apenas se você permitir

Por padrão, uma Customer Journey não permite que alguém que já está nela reentre, então um segundo checkouts/create do mesmo comprador enquanto sua primeira jornada de carrinho abandonado ainda está em execução é ignorado, não reiniciado. Ative Permitir reentrada no gatilho se você quiser que cada novo checkout redefina o tempo do lembrete. Veja Controlar se os usuários podem reentrar na campanha.

Atributos de 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 do frete
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, não presente para 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 “Complete sua compra”.
createdDate	Quando o pedido ou checkout foi criado
abandonedDate	Apenas para 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 atributos de dinheiro e data

O Pushwoosh infere o tipo de cada atributo a partir do primeiro evento que vê, e essa inferência não é confiável para campos de dinheiro e data como totalPrice, shippingAmount, taxAmount, discountAmount e createdDate/abandonedDate acima. Um preço de número inteiro como 129 infere como um inteiro, que então trunca 129.90 para 129 em todos os eventos posteriores.

Ainda não conectou o aplicativo? Declare PW_AbandonedCart e PW_OrderCreated com os tipos corretos antes de fazer isso, usando a tabela em Crie os eventos em seu Painel de Controle. Pule a etapa Envie os eventos do seu backend desse guia. A integração com o Shopify já os envia para você.

Já conectado? Verifique os tipos agora: vá para Público → Eventos no Painel de Controle, abra PW_AbandonedCart e PW_OrderCreated e compare cada atributo com a mesma tabela. Corrigir um tipo errado lá o corrige para o futuro, mas qualquer valor já enviado sob o tipo errado se foi 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 postados para esses mesmos nomes de eventos, então um segmento ou jornada construída em PW_OrderCreated / PW_AbandonedCart captura ambas as lojas, e os tipos de atributos acima se aplicam a ambas também. O Magento não tem equivalente a PW_AbandonedCartUpdate, porque não rastreia edições de checkout em andamento.

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

Itens do carrinho são enriquecidos a partir do seu Catálogo de Produtos

Os items que o Shopify envia em PW_AbandonedCart e PW_AbandonedCartUpdate carregam apenas productId, name, sku, quantity e price. O Pushwoosh preenche o que mais estiver faltando nesse item, como description, imageUrl, productUrl, category e outros campos do catálogo, a partir do produto correspondente em 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 no catálogo continua sendo exibido com os campos que o Shopify enviou.

Eventos de navegação na vitrine

Use-os para segmentos ou jornadas de abandono de navegação e para estratégias de recomendação de e-mail que precisam de visualizações de produtos (por exemplo, Com base no que eles visualizaram). Veja Como configurar recomendações de produtos em e-mail.

Requer Push Init Embed ATIVADO

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

Se o embed estiver desativado, ou um comprador bloquear seu script, você perde apenas as visualizações de produtos e as adições ao carrinho. PW_OrderCreated e PW_AbandonedCart ainda chegam do Shopify.

Ambos os eventos são coletados pelo mesmo embed de tema. Nada mais a adicionar ao tema uma vez que o Push Init Embed esteja 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.

Duas coisas para verificar antes de construir com base nesses eventos

• PW_ProductViewed conta cada carregamento de página, sem filtragem. Recarregamentos, visualizações repetidas na mesma visita e até mesmo tráfego de bots contam o mesmo que uma visualização de produto real. Uma estratégia de recomendação construída sobre este evento herda esse ruído.
• PW_AddToCart só dispara se o botão Adicionar ao carrinho da sua loja não recarregar a página. Teste isso você mesmo: clique em Adicionar ao carrinho em sua loja e observe o que acontece. Apenas o contador do carrinho atualiza, ou a página inteira é atualizada? A maioria dos temas do Shopify faz o primeiro, atualizando o contador sem recarregar (uma solicitação em segundo plano para /cart/add). Se o seu tema recarregar a página, PW_AddToCart nunca disparará, mas PW_ProductViewed e os eventos de pedido/checkout ainda funcionam bem de qualquer maneira.

Atributos de 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 a expõe

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

Nenhum dos eventos carrega email ou customerId como atributo. O comprador é identificado da mesma forma que o resto do embed do tema o faz, através da sessão do SDK vinculada ao User ID do metafield (veja Parte 2), não através do 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 o resto dos campos do catálogo para esses dois eventos, da forma como faz para os items de PW_AbandonedCart (veja 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 Com base no que eles visualizaram, os busca em seu Catálogo de Produtos por productId quando a mensagem é renderizada. Veja Como configurar recomendações de produtos em e-mail para o que cada estratégia precisa.

Eventos de etapa de checkout

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

Requer permissões de aplicativo relacionadas a pixels

Aprove as permissões de rastreamento de checkout que o Shopify solicita quando você conecta o aplicativo (write_pixels e read_customer_events). Veja a Parte 1 para essa etapa. Nenhuma etapa de embed de tema. O Shopify relata esses marcos automaticamente assim que essas permissões são aprovadas (tecnicamente, via Web Pixel do Shopify).

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

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

PW_AbandonedCart apenas informa 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 em segundo. Um comprador que alcançou PW_PaymentInfoSubmitted e nunca recebeu um PW_OrderCreated seguinte foi mais longe do que um que apenas acionou PW_AbandonedCart, então uma mensagem construída nesse estágio pode abordar um pagamento paralisado especificamente, em vez de um lembrete de carrinho genérico.

Atributos de eventos de etapa de 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 de checkout, ou o ID do pedido do Shopify assim que o checkout tiver um
totalPrice	O total do checkout
email	Apenas quando o checkout tem um. Um checkout baseado em telefone (sem e-mail inserido) envia o evento sem ele.
currency	Apenas quando o checkout tem um

Verifique se funciona

Faça a ação correspondente na loja e, em seguida, confirme se o nome do evento aparece no Pushwoosh. O evento em si é processado em tempo real, mas os dois lugares onde você o verificaria reagem de maneira diferente a um nome que o Pushwoosh nunca viu antes:

• No menu suspenso Evento quando você cria um segmento por eventos, um novo nome aparece imediatamente.
• No menu suspenso Evento quando você adiciona um gatilho de Customer Journey, um novo nome pode levar até 10 minutos para aparecer (esse menu suspenso é armazenado em cache). Se você ainda não o vir, espere em vez de assumir 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 Evento quando você cria um segmento por eventos ou adiciona um gatilho de Customer Journey.
• No texto da mensagem: na etapa da mensagem, ative Personalizar mensagem com atributos de evento 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 jornadas.

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 jornada e as estatísticas do bloco de Produtos.

Campanhas de exemplo

Cada uma dispara em um ponto diferente do caminho do comprador, então elas alcançam públicos diferentes: até onde 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 até onde chegou: o público mais amplo aqui. Construa como uma Customer Journey: acione em PW_AbandonedCart, espere por PW_OrderCreated, depois envie um e-mail com um bloco de Fonte de Carrinho para quem não pagou. Veja Como configurar uma campanha de carrinho abandonado para a configuração completa.
• Acompanhamento para checkouts paralisados. 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 tem PW_PaymentInfoSubmitted ou PW_OrderCreated.
• Recuperação para um pagamento paralisado. 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 tem 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 Com base no que eles visualizaram do bloco de Produtos. Veja Como configurar recomendações de produtos em e-mail.

Parte 6. Conformidade de dados

O Shopify exige que todos os aplicativos públicos respondam aos seus webhooks obrigatórios de GDPR/CCPA. O Pushwoosh os trata da seguinte forma:

• customers/redact: Quando um comprador pede à loja para apagar seus dados, o Pushwoosh apaga os registros correspondentes do Pushwoosh por quaisquer identificadores que o Shopify envie — e-mail, telefone e ID de cliente do Shopify.
• customers/data_request: Quando um comprador solicita uma cópia de seus dados, o Pushwoosh posta uma notificação no canal interno de suporte, e uma pessoa lida com a solicitação manualmente. O Shopify exige que os aplicativos respondam a estas solicitações em até 30 dias.
• shop/redact: O Shopify envia isso 48 horas depois que uma loja desinstala o aplicativo, pedindo para apagar os dados da loja. O Pushwoosh executa novamente a mesma exclusão que a própria desinstalação aciona, limpando qualquer sessão remanescente e apagando o registro de integração da loja (chave de API de dispositivo, código de aplicação e IDs de faturamento incluídos). Isso existe como uma rede de segurança para o caso de a desinstalação não ter limpado completamente na primeira vez.

Resumo de casos de uso

Em seguida, use os nomes de eventos acima em jornadas, segmentos ou mapeamento de conversão. Exemplos:

Cenário	Ferramenta usada
Acompanhamento personalizado	Notificação por Cliente
Lembrete de abandono de carrinho	Shopify Flow + ação Pushwoosh, ou Jornada/segmento em PW_AbandonedCart / PW_AbandonedCartUpdate (veja Parte 5)
Promoção baseada em segmento	Notificação por Segmento
Mensagem de boas-vindas após o cadastro	Flow + Rastreamento de Metafield
Opt-in de push	Embed de Tema + Ativação do Push Init
Atribuição de receita e segmentação RFM	Eventos de pedido/checkout mapeados para eventos de conversão
Análise de abandono de checkout	Eventos PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Segmentos de abandono de navegação ou carrinho	Eventos de visualização de produto / adição ao carrinho na vitrine