Integração Maga One com Google Ads

Como a plataforma utiliza a Google Ads API — dados acessados, finalidade, autorização e controles.

O que é a Maga One

A Maga One é uma agência e plataforma de marketing operada com inteligência artificial e supervisão humana. A nossa equipe planeja, produz, executa e acompanha o marketing dos clientes dentro da própria plataforma, que reúne em um só lugar planejamento de campanhas, criação de conteúdo, acompanhamento de desempenho, gestão de contatos comerciais e relatórios. A IA apoia o trabalho; uma pessoa supervisiona e aprova. Operamos no Brasil e nos Estados Unidos.

Modelo de negócio

A Maga One monetiza a sua própria operação de agência e o acesso à plataforma. O cliente contrata a operação do seu marketing pela nossa equipe e o acesso à plataforma onde esse trabalho acontece. O acesso é provisionado pela Maga One para cada cliente contratante — não há cadastro aberto, e um modelo de assinatura self-service permanece no roadmap futuro, não sendo o modelo operacional atual. A verba de mídia é sempre contratada e paga pelo anunciante diretamente à plataforma de anúncios — a Maga One não intermedeia pagamento de mídia, não revende inventário publicitário e não revende nem sublicencia acesso à API.

Quem utiliza a integração

Cada conta conectada fica vinculada ao cliente correspondente dentro da plataforma. Um cliente não acessa os dados de outro cliente: a separação entre clientes é aplicada em todas as consultas da plataforma.

Como utilizamos a Google Ads API

O uso principal é de leitura, relatório e análise das contas que o titular autorizou:

Operações de gerenciamento

A plataforma também é capaz de executar operações de gerenciamento de campanha. O conjunto é fechado e corresponde exatamente ao que está implementado:

Sobre isso, é importante ser preciso:

Conectar uma conta não autoriza a plataforma a alterá-la automaticamente. Operações que modificam a conta de anúncios exigem que a funcionalidade correspondente esteja habilitada para aquele cliente e passam por uma etapa de revisão e aprovação humana antes de qualquer alteração ser aplicada. Nenhuma alteração é consequência automática da simples conexão da conta.

Além disso, quando o anunciante configura a medição de conversões, a plataforma pode enviar conversões offline ao Google Ads, para que as vendas fechadas fora do site sejam atribuídas às campanhas que as originaram. Essa funcionalidade também depende de configuração explícita do titular.

Estado da integração

Duas coisas diferentes, que merecem ser declaradas separadamente: o que está implementado e o que está habilitado para uso em produção.

CapacidadeImplementadaHabilitação para produção
Leitura de contas, campanhas, grupos de anúncios e palavras-chavesimpor cliente
Leitura de métricas (impressões, cliques, custo, conversões)simpor cliente
Relatórios, painéis e recomendaçõessimpor cliente
Criar campanha de Pesquisa (criada pausada)simpor cliente + aprovação humana
Pausar / retomar campanhasimpor cliente + aprovação humana
Atualizar orçamentosimpor cliente + aprovação humana
Palavras-chave negativassimpor cliente + aprovação humana
Envio de conversões offlinesimpor cliente + configuração do titular + aprovação humana

Estado atual: as capacidades de Google Ads da Maga One estão implementadas e atualmente desabilitadas. Nenhuma chamada de produção à Google Ads API foi feita até hoje. Cada capacidade é controlada por cliente e nenhuma fica ativa por padrão.

Fase 1 — uso inicial em produção: somente leitura

Quando o acesso à API estiver disponível, o primeiro uso é de leitura, e não na conta de um cliente:

  1. Provisionamento de credencial — a credencial passa a existir sob controle da plataforma, sem que isso habilite nenhuma ação por si só.
  2. Conta própria da Maga One (House Account) — a validação começa na nossa própria conta de anúncios, não na de um cliente.
  3. Leitura — contas, campanhas, grupos de anúncios, palavras-chave e métricas (impressões, cliques, custo, conversões).
  4. Validação — conferir os recibos das chamadas e os números lidos contra o que a interface do Google Ads mostra, para provar que o que exibimos corresponde à realidade.
  5. Só depois dessa validação, considerar conectar contas de clientes.

Fase 2 — depois: operações de gerenciamento supervisionadas

Concluída a validação de leitura, e por cliente, um conjunto fechado de operações de escrita: criar campanha de Pesquisa (criada pausada), pausar e retomar, atualizar orçamento, gerenciar palavras-chave negativas e, quando o anunciante configura medição de conversões, enviar conversões offline. Todas exigem a capacidade habilitada para aquele cliente E aprovação humana da ação específica. Conectar uma conta não autoriza alteração alguma.

O que a Maga One não faz

Listado explicitamente para não deixar dúvida. Nada disto está implementado, e não pedimos acesso para nada disto:

Não suportadoNão suportado
Campanhas de DisplayPerformance Max
ShoppingCampanhas de Vídeo
Campanhas de AppDemand Gen
Gestão de lances (bid management)Planejamento de palavras-chave
Alterações automáticas no Google AdsGestão autônoma da conta de anúncios

O único tipo de campanha que a Maga One cria é Pesquisa (Search).

Dados acessados

DadoPara que é usado
Identificador da conta de anúncios autorizadavincular a conta ao cliente correto dentro da plataforma
Campanhas, grupos de anúncios e palavras-chavemontar a visão da operação e localizar o que precisa de atenção
Métricas agregadas: impressões, cliques, custo, conversõesrelatórios, painéis e análise de desempenho
Conversões enviadas pelo anunciante (quando configurado)medir o resultado real das campanhas

A plataforma acessa apenas as contas que o usuário autorizou e apenas os dados necessários às funcionalidades descritas acima.

Como utilizamos os dados

Não vendemos dados, não compartilhamos dados de uma conta com outro cliente e não usamos os dados de uma conta para finalidade diferente da gestão daquela conta. Detalhes na Política de Privacidade.

Como funciona a autorização

  1. O usuário acessa a Maga One com a própria conta na plataforma.
  2. Na área de integrações, escolhe conectar o Google Ads.
  3. É redirecionado ao fluxo de consentimento do Google (OAuth 2.0), no domínio do próprio Google, onde vê o escopo solicitado e decide se autoriza.
  4. Autorizando, o Google devolve a autorização à plataforma. A Maga One recebe somente o escopo necessário às funcionalidades descritas nesta página.
  5. A conta autorizada é vinculada ao cliente correspondente e passa a alimentar os painéis e relatórios daquele cliente.

A Maga One nunca pede a senha da Conta Google. A autenticação acontece inteiramente no Google.

Controle do usuário e revogação

O acesso é do usuário e pode ser interrompido por ele a qualquer momento:

Revogada a autorização, a plataforma deixa de conseguir consultar a conta.

Segurança e governança

Conexões protegidas por HTTPS/TLS. Consulte a Política de Privacidade e os Termos de Serviço.

Documentos: Política de Privacidade · Termos de Serviço · Exclusão de dados · Sobre a Maga One

Contato: contato@magaone.com.br

Maga One — Google Ads integration (English)

What Maga One is

Maga One is an AI-operated marketing agency and platform. Our own team plans, produces, runs and supervises marketing for the businesses we serve, working inside our own platform — campaign planning, content production, performance tracking, contact management and reporting in one place. Artificial intelligence assists the work; a person supervises and approves it. We operate in Brazil and the United States.

Business model

Maga One monetizes its own agency operation and access to the platform. Clients contract us to run their marketing, and access to the platform where that work happens. Access is provisioned by Maga One for each client — there is no open signup, and self-service SaaS is a future roadmap model, not the current operating model. Advertising spend is always contracted and paid by the advertiser directly to the advertising platform — Maga One does not intermediate media payments, does not resell advertising inventory, and does not resell or sublicense API access.

Who uses the integration

The owner of the Google Ads account, and agencies or professionals who manage client accounts with those clients' authorization. Each connected account is linked to its corresponding customer inside the platform. One customer cannot access another customer's data.

How we use the Google Ads API

The primary use case is reporting, analytics and analysis of accounts the owner has authorized:

The platform is also able to perform a closed set of campaign management operations, matching exactly what is implemented: create a Search campaign (created paused), pause and resume a campaign, update a campaign budget, and add negative keywords. Connecting an account does not authorize automatic changes: a management operation only reaches the API when the corresponding capability is enabled for that customer and a person has reviewed and approved that specific action. When the advertiser configures conversion measurement, the platform can also upload offline conversions, so that sales closed outside the website are attributed to the campaigns that generated them.

Integration status

Google Ads capabilities are implemented but currently disabled. No production Google Ads API calls have been made. Every capability is controlled per client and none is on by default.

Phase 1 — initial production use: read only

When API access becomes available, the first use is read-oriented, and not on a client account:

  1. Credential provisioning — the credential comes to exist under platform control; its presence alone authorizes no action.
  2. Maga One House Account — validation starts on our own advertising account, not a client's.
  3. Read — accounts, campaigns, ad groups, keywords and metrics (impressions, clicks, cost, conversions).
  4. Validate — reconcile API receipts and the figures we read against what the Google Ads interface shows, proving that what we display matches reality.
  5. Only after that validation do we consider connecting client accounts.

Phase 2 — later: supervised management operations

After read validation, and per client, a closed set of write operations: create a Search campaign (created paused), pause and resume, update a campaign budget, manage negative keywords, and — where the advertiser has configured conversion measurement — upload offline conversions. Each requires the capability to be enabled for that client AND human approval of that specific action. Connecting an account authorizes no change.

Unsupported — what Maga One does not do

Stated explicitly to leave no doubt. None of this is implemented, and we are not requesting access for any of it: Display campaigns · Performance Max · Shopping · Video campaigns · App campaigns · Demand Gen · bid management · keyword planning · automatic Google Ads changes · autonomous campaign management.

The only campaign type Maga One creates is Search.

Data accessed and how it is used

Authorized account identifiers; campaigns, ad groups and keywords; aggregated performance metrics (impressions, clicks, cost, conversions); and advertiser-configured conversions. This data is used for dashboards, reports, performance analysis, optimization recommendations and to support management of the authorized accounts. We do not sell data, we do not share one customer's data with another, and we do not use account data for any purpose other than managing that account.

Authorization and revocation

Authorization happens through Google's own OAuth 2.0 consent flow, on Google's domain. Maga One never asks for the Google account password and receives only the scope required for the functionality described here. The user can disconnect the integration inside Maga One, revoke access directly at myaccount.google.com/permissions, or request data deletion following the instructions at data deletion. Once revoked, the platform can no longer query the account.

Security and governance

Customer data is isolated per customer; the platform operates strictly within the granted scope; credentials are access-restricted and never displayed in the interface or in reports; every external operation is recorded with its outcome; and operations that modify an advertising account go through review and approval before execution and can be halted by the responsible person. Connections are protected with HTTPS/TLS.

Documents: Privacy Policy · Terms of Service · Data Deletion · About Maga One. Contact: contato@magaone.com.br