Google Ads API — reporting only
How Plataforma Prisma uses the Google Ads API
Read-only campaign reporting for each client’s own, explicitly authorized Google Ads account — displayed inside that client’s private dashboard, alongside Meta Ads and Google Analytics 4.
What Plataforma Prisma is
Plataforma Prisma is a subscription-based, multi-tenant analytics platform for Brazilian small and medium-sized e-commerce businesses. It consolidates a store’s sales, inventory, and marketing data — from the storefront, the ERP, Google Analytics 4, Meta Ads, and (once approved) Google Ads — into one dashboard, so owners and their authorized team members can evaluate revenue, advertising efficiency, and stock risk in a single place. Each customer subscribes and works inside an isolated workspace; the platform is not offered as an anonymous data service or a developer-token proxy.
The Google Ads reporting component
The only planned use of the Google Ads API is read-only reporting for accounts that a client has explicitly linked and authorized. Prisma retrieves standard performance metrics on a scheduled basis and displays them only inside that client’s own workspace, next to the equivalent Meta Ads and GA4 numbers already shown today.
Data retrieved
Account, campaign, ad group, and ad identifiers/names; campaign status and reporting date; impressions, clicks, interactions and cost; conversions and conversion value; derived indicators such as CPC, CPA, CTR and ROAS.
Where it is shown
Inside the client’s Paid Channels dashboard, the same reporting layout already used for Meta Ads today — spend, clicks, cost per result, attributed revenue and campaign breakdowns, side by side across channels.
What it never does
No creation, editing, pausing, or removal of campaigns, ads, keywords, bids, budgets, audiences, conversion actions, users, or billing settings. No remarketing. No mobile app conversion tracking or Link ID management.
Planned UI — simulated data
These are static mockups of how the planned Google Ads reporting would look inside the dashboard, using a fictional demo store (“Loja Demonstração”) and a fictional campaign (“Campanha Exemplo A/B”). All figures shown are synthetic. No Google Ads account is connected today, and this integration is not yet functional.
How access will be authorized
This is the planned authorization flow, once the Google Ads integration is approved and enabled. Every advertiser remains the owner and administrator of its own Google Ads account. Prisma never collects an advertiser’s Google password.
The client will provide its Google Ads customer ID inside its Prisma workspace and request the connection.
Prisma will send an account-linking invitation from its own Google Ads manager account.
An authorized administrator of the client’s account accepts the invitation directly in Google Ads — this is a manual approval by the advertiser, not something Prisma can do on their behalf.
Prisma authenticates through its own Google Cloud project and developer token — never a third party’s.
Scheduled, read-only report queries will retrieve data only for that authorized customer ID.
Data will be stored and displayed only inside that client’s isolated, tenant-scoped workspace. Planned connection controls will let the client revoke access at any time, by unlinking the account in Google Ads or disconnecting it from Prisma.
Security and tenant isolation
Versão em português
O que é a Plataforma Prisma
A Plataforma Prisma é um SaaS multi-tenant, por assinatura, de inteligência para pequenos e médios e-commerces brasileiros. Ela reúne vendas, estoque e dados de mídia — da própria loja, do ERP, do Google Analytics 4, do Meta Ads e (assim que aprovado) do Google Ads — num painel só, para que o lojista e sua equipe autorizada avaliem receita, eficiência de anúncios e risco de estoque num único lugar. Cada cliente assina e trabalha dentro de um espaço isolado; a plataforma não é oferecida como serviço anônimo de dados nem como intermediária de token de desenvolvedor.
O uso da Google Ads API
O único uso previsto para a Google Ads API é leitura de relatórios das contas que o próprio cliente vinculou e autorizou explicitamente. A Prisma busca métricas padrão de desempenho em uma rotina agendada e as exibe somente dentro do espaço de trabalho daquele cliente, ao lado dos números equivalentes de Meta Ads e GA4 já exibidos hoje.
Dados obtidos
Identificadores e nomes de conta, campanha, grupo de anúncios e anúncio; status da campanha e data do relatório; impressões, cliques, interações e custo; conversões e valor de conversão; indicadores derivados como CPC, CPA, CTR e ROAS.
Onde aparece
No painel de Canais Pagos do cliente, no mesmo layout de relatório já usado hoje para o Meta Ads — investimento, cliques, custo por resultado, receita atribuída e detalhamento de campanhas, lado a lado entre canais.
O que nunca faz
Nenhuma criação, edição, pausa ou remoção de campanhas, anúncios, palavras-chave, lances, orçamentos, públicos, ações de conversão, usuários ou faturamento. Sem remarketing. Sem rastreamento de conversão de app móvel.
Telas planejadas — dados simulados
Estas são simulações estáticas de como ficaria o relatório planejado de Google Ads dentro do painel, usando uma loja fictícia de demonstração (“Loja Demonstração”) e uma campanha fictícia (“Campanha Exemplo A/B”). Todos os números mostrados são simulados. Hoje nenhuma conta de Google Ads está conectada, e essa integração ainda não está funcional.
Como o acesso será autorizado
Este é o fluxo de autorização planejado, assim que a integração com o Google Ads for aprovada e ativada. O anunciante continua sendo o dono e administrador da própria conta do Google Ads. A Prisma nunca coleta a senha do Google do anunciante.
O cliente informará o ID da conta Google Ads dentro do seu espaço de trabalho na Prisma e pedirá a conexão.
A Prisma enviará um convite de vinculação de conta a partir da própria conta gerenciadora do Google Ads.
Um administrador autorizado da conta do cliente aceita o convite diretamente no Google Ads — essa aprovação é manual, feita pelo próprio anunciante, e não algo que a Prisma faz em nome dele.
A Prisma autentica pelo próprio projeto no Google Cloud e pelo próprio token de desenvolvedor — nunca de terceiros.
Consultas de relatório, só leitura e agendadas, buscarão dados apenas para aquele ID de cliente autorizado.
Os dados serão armazenados e exibidos só dentro do espaço de trabalho isolado daquele cliente. Controles de conexão planejados permitirão que o cliente revogue o acesso a qualquer momento, desvinculando a conta no Google Ads ou desconectando pela Prisma.