Documentação

Integrações

Lojas de ecommerce

Conecte Shopify, WooCommerce, Magento 2, Shoptet ou BiznisWeb para adicionar pedidos, produtos, clientes e margem a um domínio e para gravar links internos na sua loja.

Para uma loja, a pergunta por trás de toda métrica de visibilidade é se isso vende. Conectar sua loja traz pedidos, receita, produtos e clientes para o mesmo domínio das suas citações de IA, do tráfego de busca e do gasto com anúncios. Isso libera os relatórios de Eshop (lucro, custos, produtos, clientes, mercados) e permite julgar as plataformas de anúncios pelos pedidos que realmente chegaram, e não pelas conversões que elas declaram.

As integrações de ecommerce estão disponíveis a partir do plano Pro. Veja planos e limites.

Conecte sua loja#

Todas as cinco são conectadas em Fontes de dados, em Eshops. Somente administradores do workspace podem conectar integrações. Cada loja é conectada com credenciais do seu próprio painel de administração; as abas mostram onde obtê-las.

Shopify

O Shopify exige que as instalações de apps comecem na Shopify App Store.

  1. Clique em Connect Shopify Store. Você é enviado ao app do FlowHunt na Shopify App Store.
  2. Clique em Add app, faça login no painel de administração do Shopify se solicitado, revise e aceite as permissões.
  3. Conclua a instalação para conectar a loja.

Se nada abrir, seu navegador bloqueou o pop-up; permita-o ou abra o link da App Store mostrado na caixa de diálogo.

WooCommerce

  1. No painel de administração do WordPress, vá a WooCommerce → Settings → Advanced → REST API.
  2. Clique em Add key, dê uma descrição e defina Permissions como Read.
  3. Clique em Generate API key e copie a consumer key e o consumer secret (o secret é mostrado apenas uma vez).
  4. No AmICited, informe a Store URL (inclua o subdiretório se o WordPress estiver em um, por exemplo https://example.com/shop), a Consumer key e o Consumer secret e clique em Connect WooCommerce.

A loja precisa ser acessível por HTTPS; o WooCommerce ignora chaves de API enviadas por HTTP simples.

Magento 2

  1. No Admin do Magento 2, vá a System → Extensions → Integrations e clique em Add New Integration.
  2. Dê um nome (por exemplo “FlowHunt”). Na aba API, defina Resource Access como All, ou conceda pelo menos Sales, Catalog, Customers, Stores e Catalog Inventory.
  3. Salve e clique em Activate.
  4. Copie as quatro credenciais OAuth (Consumer Key, Consumer Secret, Access Token, Access Token Secret) e informe-as no AmICited com a Magento Store URL (sem /admin).

Se a loja estiver atrás de HTTP Basic Auth, preencha também os dois campos opcionais de Basic Auth.

Shoptet

  1. Na administração do seu e-shop, vá a Connections → Private API.
  2. Clique em Add, informe uma descrição e deixe todos os grupos de endpoints ativados.
  3. Revele o token, confirme com sua senha e copie-o.
  4. Cole-o como API token (ele começa com o ID do seu e-shop, como 123456-p-…) e clique em Connect Shoptet.

A Private API está disponível apenas na tarifa Shoptet Premium.

BiznisWeb

  1. Faça login no painel de administração do BiznisWeb e vá a Settings → API Access.
  2. Crie um novo token de API com as permissões apropriadas.
  3. No AmICited, informe o API Token, o API Domain (o domínio próprio da sua loja, por exemplo www.yourshop.sk) e o Flox Subdomain usado para autenticação (por exemplo yourshop.flox.sk) e clique em Connect BiznisWeb.

Depois que as credenciais são salvas, clique em Select account no card para associar a loja ao domínio e escolha quanto histórico de pedidos importar. A opção mais longa importa tudo desde o primeiro pedido da loja; cada opção mostra suas linhas projetadas e o custo único antes de você confirmar.

Dados de clientes: anonimizados ou completos#

Antes da primeira importação, você escolhe o que a importação pode armazenar sobre as pessoas que compram. Isso precisa ser respondido logo de início: descreve os pedidos já importados, então alterá-lo depois significa desconectar e conectar a loja de novo.

  • Anonymised (padrão). Nenhum e-mail, nome ou endereço chega ao warehouse. Um cliente é um hash unidirecional do e-mail: suficiente para contá-lo, acompanhar seus pedidos e segmentá-lo, mas não para contatá-lo.
  • Import full customer data. Armazena o e-mail e o nome junto com o pedido, para que um segmento possa ser exportado e trabalhado. São dados pessoais, mantidos sob as regras de retenção do seu workspace.

Todos os relatórios funcionam de qualquer forma.

Configurações da loja#

Os números só são tão bons quanto os custos por trás deles. Abra Shop settings no card da loja para definir:

  • Currency. A moeda em que tudo no domínio é informado e as taxas de câmbio usadas para chegar a ela.
  • Cost inputs. Quanto cada pedido custa além das mercadorias, por período: frete e embalagem líquidos por pedido, % de taxa de pagamento, custos fixos por mês e uma margem presumida. Outros custos (uma campanha, uma agência, um ano de software) podem ser registrados e distribuídos ao longo do período. Enquanto não existir pelo menos um período, a contribuição e o lucro não podem ser calculados.
  • Product costs. Quanto cada produto custou para comprar, o que transforma receita em margem.
  • Order statuses. Quais status da loja contam como venda.
  • Payment methods. Quais métodos têm taxa e de quanto.

A página Shop connection mostra o que foi importado e o que ainda falta para os relatórios de eshop terem números reais. Data health (nos relatórios) mostra quanto de cada número é medido e quanto é presumido.

O que ela libera#

Relatórios → Eshop reúne cerca de 25 relatórios, agrupados assim:

  • Earnings. Cockpit (lucro, o que o moveu, estamos dentro do plano), Sales engine, Economics.
  • Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
  • Ads and the shop. Attribution reality (as afirmações da Meta contra os pedidos que chegaram), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Esses exigem o Meta Ads conectado.
  • Products. Products, Assortment, Product bundles, Entry products.
  • Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (quem deve reabastecer).
  • Markets and timing. Geography, Geo profitability, Calendar, Weather.
  • Operations and data. Metric library, Order mix, Data health.

Os pedidos da loja também alimentam as expectativas de anotação de ecommerce (pedidos, receita líquida, AOV, ROAS, lucro da empresa), e Auditoria → Link building grava links internos na sua loja: cada regra nomeia uma palavra-chave e um destino, e os links são adicionados aos textos de produtos, coleções, páginas e artigos a cada aplicação e removidos quando a regra é pausada ou excluída.

Custo e desconexão#

Como toda fonte de dados: uma importação única cobrada pelas linhas mantidas (1 crédito por milhão de linhas) e uma taxa diária fixa de warehouse por domínio conectado, definida pelo seu plano, ambas mostradas antes de você confirmar. Disconnect interrompe a importação e exclui os dados importados; não pode ser desfeito. Veja créditos.

Relacionados#