Shopify

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.

​

Pré-requisitos

Antes de começar, certifique-se de ter:

• Uma loja Shopify com o aplicativo Vendo instalado
• Uma conta e app OneSignal (plataforma Web)
• Seu App ID do OneSignal (obrigatório)
• Sua REST API Key do OneSignal (necessária para eventos do lado do servidor como sincronização de pedidos e marcação de usuários)

​

Configuração do OneSignal

​

Configuração da Vendo

​

Rastreamento

​

Identificação de usuários

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.

​

Fusão de identidades

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.

​

Tags de clientes

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).

​

Eventos do lado do cliente

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.

​

Eventos do lado do servidor

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.

​

Propriedades comuns de eventos

Todos os eventos incluem estas propriedades (como strings):

​

Frequência de sincronização de dados

​

Detalhes da plataforma

​

Casos de uso

​

Recuperação de carrinho abandonado

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.

​

Atualizações de status do pedido

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.

​

Engajamento de clientes VIP

Crie um segmento onde total_spent seja maior que um limite, depois envie ofertas exclusivas personalizadas com a tag first_name.

​

Campanhas de reengajamento

Direcione clientes inativos criando um segmento onde last_order_date seja há mais de 90 dias e envie campanhas de reconquista.

​

Fontes compatíveis

O OneSignal funciona com as seguintes fontes de dados da Vendo: 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.

---

​

Testes

---

​

Solução de problemas

​

O service worker retorna 404

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.

​

O prompt push não aparece

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 não aparecem no OneSignal

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.

​

Os eventos não estão sendo disparados

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.

---

​

Perguntas frequentes

​

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 suporta apps móveis?

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.

---

​

Páginas relacionadas