Conecte o Shopify ao OneSignal através da integração Vendo para notificações web push, tags de clientes, eventos de comércio e segmentação comportamental.
O OneSignal fez parceria com a Vendo para criar uma integração perfeita com o Shopify. A Vendo implanta o SDK do OneSignal na sua loja Shopify com um clique — sem necessidade de editar manualmente o código do tema. Ela sincroniza tags de clientes, eventos de navegação do lado do cliente e eventos de comércio do lado do servidor para o OneSignal, permitindo que você construa segmentos e acione campanhas push a partir de comportamento real e histórico de compras.Para a documentação da Vendo, consulte Vendo OneSignal Destination.
Não use https://your-site.myshopify.com/ se os clientes acessam seu site através de um domínio personalizado como https://your-site.com/.
Default Icon URL: Faça upload de uma imagem PNG ou JPG quadrada de 256x256px para prompts e mensagens de notificação. Se não definida, um ícone de sino é usado.
3
Configurar o caminho do service worker
O Shopify não permite servir arquivos da raiz do site, então você deve informar ao OneSignal onde a Vendo serve o arquivo service worker.No OneSignal, vá para Settings > Push & In-App > Web Settings, role até Advanced Push Settings e configure:
Configuração
Valor
Service Worker Path
/apps/vendo/
Service Worker Filename
OneSignalSDKWorker.js
Updater Filename
OneSignalSDKWorker.js
Service Worker Registration Scope
/apps/vendo/
Configuração do service worker para lojas Shopify usando a Vendo.
A Vendo serve automaticamente o arquivo OneSignalSDKWorker.js necessário em https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js — sem uploads manuais de arquivos.
O Updater Filename e o Service Worker Filename são o mesmo arquivo. O OneSignal v16+ usa um único service worker para ambos os propósitos.
4
Copiar suas credenciais
No OneSignal, vá para Settings > Keys & IDs e copie seu App ID e REST API Key. Você os inserirá na Vendo.
Na Vendo, navegue até Integrations > Add Integration > OneSignal (ou Destinations > OneSignal).
Adicionar a integração OneSignal na Vendo.
3
Inserir suas credenciais OneSignal
Insira seu App ID e REST API Key do OneSignal da seção anterior, depois clique em Save.
4
Ativar o bloco de tema Vendo
O bloco de tema Vendo carrega o SDK do OneSignal na sua loja. Sem ele, o prompt de push não aparecerá e o rastreamento do lado do cliente não funcionará.
No administrador do Shopify, vá para Online Store > Themes > Customize.
Clique em App embeds (ícone de peça de quebra-cabeça na barra lateral esquerda).
Ative Vendo.
Clique em Save.
O bloco de tema gerencia a inicialização do SDK, o registro do service worker, a exibição do prompt push, a identificação do usuário (inscrição push, login, cadastro em newsletter) e a sincronização de tags.
5
Selecionar eventos para sincronizar
No aplicativo Vendo em OneSignal > Events, ative os eventos do lado do cliente e do servidor que deseja enviar ao OneSignal. Consulte Rastreamento abaixo para a lista completa de eventos.
6
Sincronização de dados históricos (opcional)
A Vendo pode preencher retroativamente clientes existentes e histórico de pedidos recentes para o OneSignal. Isso acontece automaticamente em segundo plano após salvar suas credenciais.
Opções de sincronização de dados históricos na Vendo.
A Vendo usa uma abordagem somente para usuários identificados — visitantes anônimos não são rastreados no OneSignal. Os usuários devem ser identificados por um dos quatro métodos antes que os eventos sejam enviados. Isso evita usuários duplicados e garante dados limpos e acionáveis.
Método
Como funciona
Identificador usado
Inscrição push web
O visitante clica em “Permitir” no prompt push. O OneSignal cria um usuário automaticamente e a Vendo captura o ID do OneSignal.
OneSignal ID
Cadastro em newsletter
O visitante envia um formulário de newsletter ou e-mail. A Vendo captura o e-mail e chama OneSignal.login(email).
Email
Login do cliente
O cliente faz login na sua conta Shopify. A Vendo detecta isso e chama OneSignal.login() com o identificador configurado.
Shopify Customer ID ou Email
Checkout concluído
O cliente conclui uma compra. A Vendo armazena o identificador e chama OneSignal.login().
Shopify Customer ID ou Email
Se você tem um app mobile ou conexões de terceiros, selecione o identificador (Shopify Customer ID vs. Email) que corresponde às suas outras ferramentas para que os perfis de usuário permaneçam consistentes entre plataformas. Configure isso no aplicativo Vendo em Settings > Customer Identifier.
Se um assinante push (identificado pelo ID do OneSignal) fizer login ou concluir uma compra posteriormente, a Vendo chama OneSignal.login() com seu Shopify Customer ID ou e-mail. O OneSignal vincula a inscrição push ao usuário identificado — nenhum usuário duplicado é criado. Todas as inscrições push anteriores são preservadas, e os eventos do lado do servidor (pedidos, cumprimentos) chegam ao perfil de usuário correto.
A Vendo sincroniza as propriedades do cliente como tags no OneSignal para segmentação. Todos os valores são armazenados como strings (formato nativo do OneSignal).
A Vendo rastreia eventos personalizados do lado do cliente na sua loja através do Shopify Web Pixel e os envia ao OneSignal. Esses eventos só são enviados após um usuário ser identificado.
Evento
Descrição
page_viewed
O cliente visita uma página (loja, checkout ou status do pedido)
product_viewed
O cliente visualiza uma página de detalhes do produto
collection_viewed
O cliente visualiza uma página de coleção de produtos
search_submitted
O cliente realiza uma busca na loja
product_added_to_cart
Um produto é adicionado ao carrinho
product_removed_from_cart
Um produto é removido do carrinho
cart_viewed
O cliente visualiza a página do carrinho
checkout_started
O cliente inicia o checkout
checkout_contact_info_submitted
Etapa de informações de contato enviada
checkout_address_info_submitted
Etapa de informações de endereço enviada
checkout_shipping_info_submitted
Método de envio selecionado
payment_info_submitted
Detalhes de pagamento enviados
checkout_completed
Checkout concluído com sucesso
Configuração de eventos do lado do cliente na Vendo.
Os eventos de comércio do Shopify são exportados e encaminhados ao OneSignal pelo pipeline da Vendo. Eles sempre usam o Shopify Customer ID como external_id.
Evento
Descrição
received_orders
Um novo pedido é criado
fulfilled_orders
O pedido é cumprido/enviado
delivered_orders
O pedido é entregue
refunded_orders
O pedido é totalmente reembolsado
partially_refunded_orders
O pedido é parcialmente reembolsado
abandoned_checkouts
O checkout é abandonado
Configuração de eventos do lado do servidor na Vendo.
Crie um Journey acionado pelo evento abandoned_checkouts. Aguarde 1 hora após o abandono, depois envie uma notificação push com o link de recuperação usando a propriedade checkout_url.
Crie Journeys para fulfilled_orders e delivered_orders para enviar notificações push imediatas com informações de rastreamento quando os pedidos são enviados e chegam.
O OneSignal funciona com as seguintes fontes de dados da Vendo:
Fonte
Eventos
Tags de usuário
Audiências
Shopify
Sim
Sim
Sim
Stripe
Sim
Sim
Sim
Mixpanel
—
—
Sim
Segment
—
—
Sim
Amplitude
—
—
Sim
Eventos e tags de usuário requerem Shopify ou Stripe como fonte de dados. Segmentos de audiência podem ser construídos a partir de qualquer dado fonte no seu conjunto de dados do BigQuery.
Visite https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js no seu navegador. Você deve ver código JavaScript. Se receber um 404, verifique se o aplicativo Vendo está instalado.Você também pode abrir o DevTools do navegador (F12), ir para Application > Service Workers e confirmar que OneSignalSDKWorker.js está registrado com um scope de /apps/vendo/.
2
Testar o prompt push
Abra sua loja em uma janela de navegação anônima/privada. Você deve ver o prompt de permissão de notificação do OneSignal. Clique em Permitir para se inscrever.
3
Enviar uma notificação de teste
No dashboard do OneSignal, vá para Messages > Push > New Message. Envie uma notificação de teste para seu assinante e verifique se ela aparece.
4
Verificar dados do usuário no OneSignal
Vá para Audience > Subscriptions e confirme que sua inscrição de teste aparece. Verifique se as tags de usuário (e-mail, nome, etc.) estão sincronizando para usuários identificados.
5
Acionar um evento de teste
Navegue por um produto ou conclua um checkout de teste na sua loja. Confirme que o evento aparece na atividade do usuário no dashboard do OneSignal.
O service worker deve estar em /apps/vendo/OneSignalSDKWorker.js. Se você vir um erro 404 no caminho raiz (/OneSignalSDKWorker.js), o caminho do service worker não está configurado no OneSignal — siga a etapa de configuração do service worker. Se o 404 estiver no caminho /apps/vendo/, verifique se o aplicativo Vendo está instalado e o bloco de tema está ativado.
Verifique se o bloco de tema Vendo está ativado em App embeds. Confirme que seu navegador permite notificações (clique no ícone de cadeado na barra de endereços). Tente uma janela de navegação privada caso o prompt tenha sido descartado anteriormente.
As tags só sincronizam para usuários identificados — visitantes anônimos não são rastreados. Certifique-se de que o usuário foi identificado via inscrição push, login, cadastro em newsletter ou checkout. As sincronizações iniciais de tags podem levar várias horas.
Verifique se os eventos estão habilitados no aplicativo Vendo em OneSignal > Events. Eventos do lado do cliente requerem que o Shopify Web Pixel esteja ativo e o usuário esteja identificado. Eventos do lado do servidor requerem que a REST API Key esteja configurada.
As notificações mostram “Entregue” mas não aparecem
A integração está funcionando — o problema está nas configurações de notificação do seu navegador ou sistema operacional. Verifique as configurações de notificação do seu sistema operacional para o seu navegador, certifique-se de que o modo Não Perturbe / Foco está desativado e verifique as permissões de notificação no nível do navegador.
Posso alterar o identificador de cliente após a configuração?
Sim. Atualize a configuração no aplicativo Vendo em Settings > Customer Identifier. Alterar o identificador pode criar perfis de usuário separados se os usuários existentes já foram identificados com o método anterior.
A integração Vendo foca em lojas Shopify e push web. Se você também tem um app móvel, certifique-se de que o identificador selecionado na Vendo corresponde ao usado no seu app móvel para que os perfis de usuário permaneçam consistentes.
O que acontece se um visitante nunca for identificado?
Eventos de visitantes não identificados não são enviados ao OneSignal. Assim que o visitante se identifica (inscrevendo-se no push, fazendo login, cadastrando-se em uma newsletter ou concluindo o checkout), a Vendo começa a enviar eventos. Essa abordagem somente para usuários identificados evita usuários duplicados e garante dados limpos.
Por que a Vendo usa uma abordagem somente para usuários identificados?
Versões anteriores rastreavam visitantes anônimos usando o cookie de sessão do Shopify como identificador. Isso criava usuários duplicados do OneSignal que nunca podiam ser mesclados adequadamente, levando a contagens infladas de usuários e dados fragmentados. A abordagem somente para usuários identificados garante que cada usuário do OneSignal seja real e acionável.
