Documentação da app

É novo na ROASaurus? Comece pelo tutorial. Os guias de configuração por plataforma estão no centro de ajuda, as respostas curtas nas FAQ.

Como funciona a ROASaurus

Recolher. Um pequeno script na sua loja regista visualizações de página, IDs de clique em anúncios e parâmetros UTM dos visitantes que dão consentimento, no seu próprio domínio.
Associar. Quando uma encomenda é paga, a ROASaurus recebe-a da sua loja online e associa-a ao visitante e ao clique no anúncio que o trouxe.
Enviar. A compra é enviada server-side para cada plataforma de anúncios que ligar, com o mesmo ID de evento do pixel do navegador, para que as plataformas fiquem com uma só cópia.
Reportar. As mesmas encomendas, com os seus custos e investimento em anúncios, dão origem a relatórios de lucro, atribuição e valor vitalício.

A app no seu admin do Shopify

A app da ROASaurus abre dentro do admin do Shopify, sem login separado. Tem cinco páginas:

Início	A lista de configuração, o estado do theme app embed, do pixel web e das suas ligações, e os números dos últimos 30 dias. É aqui que uma nova loja se liga à sua conta ROASaurus.
Ligações	Adicione, pause ou remova as plataformas de anúncios que recebem os seus eventos, como Meta, Google Ads, GA4, TikTok e Pinterest.
Configuração	Definições da loja, Shopify Markets e origens das encomendas, ponto de venda e encomendas em rascunho, e a velocidade da sua loja online.
Relatórios	Receita, encomendas, investimento em anúncios, MER, lucro líquido e encomendas associadas a uma visita para 7, 30 ou 90 dias, com encomendas, receita, investimento e ROAS por canal.
Plano	O seu plano ROASaurus e um link para a app completa, onde a faturação é gerida.

A app completa em app.roasaurus.com tem todos os relatórios e definições: lucro e o P&L, atribuição, valor vitalício, análise de criativos, públicos, Ask AI e faturação. Abra-a a partir da app ou inicie sessão diretamente.

Theme app embed e pixel web

O theme app embed carrega o script da ROASaurus em todas as páginas da loja online. Recolhe IDs de clique em anúncios, guarda o ID do visitante no carrinho e carrega os pixels de navegador das suas plataformas de anúncios depois de o visitante aceitar os cookies de marketing. Ative-o na página Início da app, que abre o editor de temas. O pixel web é instalado com a app e acompanha os passos do checkout e as compras.

Permissões

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

Permissão	Usada para
`read_orders`	Webhooks de encomendas, 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 da ROASaurus no checkout.
`read_products, read_inventory`	Custos dos produtos e planos de reposição.
`read_shopify_payments_disputes`	Chargebacks nos relatórios de lucro.
`read_reports`	Custos das etiquetas do Shopify Shipping.
`read_markets, read_locations`	Pixels por Market e localizações de ponto de venda.

A ROASaurus segue as definições de privacidade de clientes da loja. Um visitante que recusa os cookies de marketing não recebe ID de visitante, e os seus eventos de navegador não são enviados às plataformas de anúncios. Nomes, emails, números de telefone e moradas 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 tratamento de dados.

Desinstalação

Quando desinstala a app, a ROASaurus elimina os tokens de acesso que tinha para a sua loja e deixa de enviar os eventos que ainda estavam em fila. 48 horas depois, quando o Shopify envia o pedido de eliminação de dados da loja, todos os registos da loja são eliminados. Os pedidos dos seus clientes para ver ou eliminar os seus dados chegam à ROASaurus através dos webhooks de conformidade do Shopify e são tratados automaticamente.

Outras lojas online

A ROASaurus também funciona com WooCommerce (através de um plugin), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace e Ecwid, e com qualquer backend através da API de encomendas. Consulte o centro de ajuda para cada uma.

Para programadores

A API REST lê relatórios e envia encomendas e eventos com uma chave de âmbito limitado. Os webhooks, as exportações para armazéns de dados e um servidor MCP para clientes de IA são descritos nas páginas de funcionalidades.

Suporte

Envie um email para hello@roasaurus.com. A forma como protegemos os seus dados está na página de segurança; o que mudou recentemente está no registo de alterações.