Documentação do app

Novo no ROASaurus? Comece pelo tutorial. Os guias de configuração por plataforma estão na central de ajuda, e as respostas curtas nas perguntas frequentes.

Como o ROASaurus funciona

Capturar. Um pequeno script na sua loja registra visualizações de página, IDs de clique de anúncios e parâmetros UTM dos visitantes que dão consentimento, no seu próprio domínio.
Associar. Quando um pedido é pago, o ROASaurus o recebe da sua loja virtual e o associa ao visitante e ao clique no anúncio que o trouxe.
Enviar. A compra vai server-side para cada plataforma de anúncios que você conectar, com o mesmo ID de evento do pixel do navegador, para que as plataformas fiquem com uma só cópia.
Reportar. Os mesmos pedidos, com seus custos e investimento em anúncios, viram relatórios de lucro, atribuição e valor vitalício.

O app no seu admin do Shopify

O app ROASaurus abre dentro do admin do Shopify, sem login separado. Ele tem cinco páginas:

Início	O checklist de configuração, o status do embed do tema, do pixel web e das suas conexões, e os números dos últimos 30 dias. É aqui que uma nova loja se conecta à sua conta ROASaurus.
Conexões	Adicione, pause ou remova as plataformas de anúncios que recebem seus eventos, como Meta, Google Ads, GA4, TikTok e Pinterest.
Configuração	Configurações da loja, Shopify Markets e origens de pedidos, ponto de venda e pedidos em rascunho, e a velocidade da sua vitrine.
Relatórios	Receita, pedidos, investimento em anúncios, MER, lucro líquido e pedidos associados a uma visita em 7, 30 ou 90 dias, com pedidos, receita, investimento e ROAS por canal.
Plano	Seu plano ROASaurus e um link para o app completo, onde a cobrança é gerenciada.

O app completo em app.roasaurus.com reúne todos os relatórios e configurações: lucro e o P&L, atribuição, valor vitalício, análise de criativos, públicos, Ask AI e cobrança. Abra-o a partir do app ou faça login diretamente.

Embed do tema e pixel web

O embed do tema carrega o script do ROASaurus em todas as páginas da vitrine. Ele captura IDs de clique de anúncios, salva o ID do visitante no carrinho e carrega os pixels de navegador das suas plataformas de anúncios depois que o visitante aceita os cookies de marketing. Ative-o na página Início do app, que abre o editor de temas. O pixel web é instalado junto com o app e rastreia as etapas do checkout e as compras.

Permissões

O app pede estas permissões do Shopify e usa cada uma apenas para o que está listado:

Permissão	Usada para
`read_orders`	Webhooks de pedidos, lucro e atribuição.
`read_customers`	O estado de consentimento do cliente e segmentos de clientes para públicos.
`write_pixels, read_customer_events`	Instala e executa o pixel web do ROASaurus no checkout.
`read_products, read_inventory`	Custos de produtos e planos de reposição.
`read_shopify_payments_disputes`	Chargebacks nos relatórios de lucro.
`read_reports`	Custos de etiquetas do Shopify Shipping.
`read_markets, read_locations`	Pixels por Market e locais de ponto de venda.

O ROASaurus segue as configurações de privacidade do cliente da loja. Um visitante que recusa os cookies de marketing não recebe ID de visitante, e os eventos do navegador dele não são enviados às plataformas de anúncios. Nomes, emails, telefones e endereços passam por hash SHA-256 antes de serem enviados a uma plataforma de anúncios. Os detalhes estão no guia de consentimento, na política de privacidade e no acordo de processamento de dados.

Desinstalação

Quando você desinstala o app, o ROASaurus exclui os tokens de acesso que tinha para a sua loja e para de enviar os eventos que ainda estavam na fila. 48 horas depois, quando o Shopify envia a solicitação de remoção de dados da loja, todos os registros da loja são excluídos. Solicitações dos seus clientes para ver ou excluir os dados deles chegam ao ROASaurus pelos webhooks de conformidade do Shopify e são tratadas automaticamente.

Outras lojas online

O ROASaurus também funciona com WooCommerce (por meio de um plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace e Ecwid, e com qualquer backend pela API de pedidos. Veja a central de ajuda para cada um.

Para desenvolvedores

A API REST lê relatórios e envia pedidos e eventos com uma chave de escopo limitado. Webhooks, exportações para data warehouses e um servidor MCP para clientes de IA são descritos nas páginas de recursos.

Suporte

Escreva para hello@roasaurus.com. Como protegemos seus dados está na página de segurança; o que mudou recentemente está nas novidades.