InSearch.
Tutorial

Como instalar o Insider One na sua Shopify.

O passo a passo inteiro da integração oficial, incluindo as partes que costumam ficar pela metade e envenenam o dado depois.

Sem formulário, sem email, sem pedir seu telefone pra liberar o conteúdo.

Este guia reproduz o fluxo oficial da Insider One, resumido em português e com as observações que a gente aprendeu implantando. A documentação da plataforma muda, então, em caso de divergência, vale o que está na documentação oficial. Somos Official Partner da Insider One, mas não revendemos licença nem ganhamos comissão por instalação.

Antes de começar

O que você precisa ter em mãos.

Metade das instalações que travam no meio travam aqui, por falta de permissão. Vale conferir antes de abrir as duas plataformas.

Papel na InOne

Administrator, ou Editor com acesso a PII. Sem isso a própria tela de External Platform Integrations fica bloqueada.

Acesso na Shopify

Conta de dono da loja, ou usuário com permissão de instalar e gerenciar apps. Usuário restrito não consegue concluir a autorização.

Nome da loja

A parte da URL antes de .myshopify.com. Está em Settings na Shopify.

Storefront customizado

Usando Hydrogen ou storefront próprio, o Insider Object e a tag precisam ser implementados à mão, com o time da Insider.

Passo a passo

Seis partes, na ordem.

01

Conectar o app

  1. Na InOne, vá em Components > Integrations > External Integrations e selecione Shopify.
  2. Informe o nome da loja (a parte antes de .myshopify.com).
  3. Clique em Install e aceite os termos e as autorizações do app.
  4. Depois do redirecionamento e da mensagem de sucesso, clique em Next.
  5. Habilite o Insider Object e a JS Tag e clique em Preview and Enable.
  6. Na aba nova, a Shopify abre o App Embed do tema publicado. Ligue Insider App, Insider Object e Insider JS Tag (ins.js) e clique em Save.
  7. Volte pra InOne e clique em Next.

Na prática: A ativação acontece no tema publicado. Se você ativar no tema de rascunho e publicar outro depois, a integração cai e o sincronismo pausa sem aviso claro.

02

Custom Web Pixel

  1. Copie o código do pixel que a InOne mostra na tela.
  2. Na Shopify, vá em Settings > Customer Events e clique em Add custom pixel.
  3. Dê um nome ao pixel, por exemplo Insider Order Status Custom Pixel.
  4. Marque as permissões Marketing and Analytics e Data collected qualifies as a data sale.
  5. Clique em Connect.
  6. Volte pra InOne, clique em Test Custom Web Pixel, confirme o sucesso e siga em Next.

Na prática: Esta é a parte que mais fica de fora. Sem o Custom Web Pixel, o evento de compra não chega completo, e aí toda métrica de receita da plataforma fica errada pra baixo. Se você vai pular alguma etapa, não pule esta.

03

Atributos e consentimento

  1. No sentido Shopify para InOne, escolha se quer sincronizar consentimento de SMS e de email. Dá pra sincronizar consentimento de WhatsApp historicamente, com base no opt-in de SMS.
  2. Opcionalmente, mapeie metafields da Shopify para atributos que já existem na InOne.
  3. No sentido InOne para Shopify, escolha entre criar perfis novos e atualizar o consentimento dos existentes, ou apenas atualizar os que já existem.

Na prática: Email e telefone que já existem na Shopify não são sobrescritos pela InOne. E mudança de WhatsApp feita na InOne não volta pra Shopify. Depois de ativar, trocar a regra de sincronismo de usuário exige falar com a Insider.

04

Eventos

  1. Revise a lista de eventos que serão coletados da Shopify e siga em Next.

Na prática: Vale ler essa lista com calma em vez de passar batido. É ela que define o que vai dar pra segmentar depois, e voltar atrás custa mais caro do que decidir agora.

05

Produtos e catálogo

  1. Escolha se o dado de produto vem por API e mapeie os metafields desejados.
  2. Mapeie as categorias. As collections já vêm mapeadas por padrão, e mudanças aqui devem ser confirmadas com a Insider antes.
  3. Sincronize as opções de produto, como tamanho e cor. Os nomes das opções precisam ser digitados à mão, e a comparação ignora maiúscula e minúscula.
  4. Mapeie os metafields da Shopify para atributos de produto. Use os botões de Refresh se um campo novo não aparecer.

Na prática: Só o idioma e a moeda principais são sincronizados. Operação com mais de um mercado precisa de outro método de feed, e isso costuma pegar de surpresa quem vende em mais de um país.

06

Revisar e ativar

  1. Na tela de Review, confira tudo e clique em Activate Integration.
  2. A carga histórica de usuários, compras e produtos começa nesse momento.

Na prática: O histórico entra aos poucos, não de uma vez. A retenção padrão é de 2 anos, e só pedidos com status Open ou Archived são coletados.

Depois de ativar

A instalação acabou. A implantação, não.

Integração ativa não é o mesmo que plataforma gerando receita. Estes quatro pontos ficam abertos depois do Activate Integration, e é neles que a maioria das operações para.

System Rules

Precisam ser implementadas à parte. Se existir um template de Shopify em Add a Template, use ele. Se não, o caminho é pelo Insider Object.

Identity Resolution

Os identificadores padrão são email, telefone e ID da Shopify. Quem unifica cliente entre canais precisa revisar isso antes de confiar no perfil único.

Service Worker

Instalado sozinho em /apps/insider/insider-sw-sdk.js. O caminho se muda em Web Push > Web Push Settings > Setup Settings.

Status Action Required

Se a tag ou o objeto quebrarem, o sincronismo ao vivo pausa até alguém arrumar. Chega aviso amarelo e email, e é fácil ignorar por semanas.

Limites que ninguém conta antes

O que a documentação diz em letra miúda.

Desligar um sincronismo não apaga nada

Desativar um toggle só interrompe o sincronismo dali pra frente. O que já foi, fica nas duas plataformas.

Tema muito customizado pode quebrar o fluxo

A compatibilidade varia por tema, e customização pesada afeta o fluxo de dado. Vale testar em tema de rascunho antes de mexer no publicado.

O Insider Object só carrega na visita ou no refresh

Em loja que se comporta como aplicação de página única, o caminho é usar recursos de backend somados ao ins.js.

Multi-mercado fica de fora do sincronismo padrão

Só o idioma e a moeda principais sincronizam. Vender em mais de um país exige outro método de feed.

Usuário de Shopify entra como gdpr_optin

O consentimento é assumido por padrão. Operação na Europa precisa olhar isso com atenção antes de disparar qualquer coisa.

Official Partner Insider One

Travou em alguma etapa?

Manda onde parou que a gente responde. E se a sua operação ainda não precisa de Insider, a gente fala isso também.

Falar no WhatsApp

Voltar para Shopify na InSearch