Data to AI™ / Gemini/TikTok Ads

Consulte o TikTok Ads no Gemini CLI e no Code Assist

Leve dados de campanhas, criativos e landing pages do TikTok Ads para o terminal ou para a sua IDE, para que notebooks, scripts e checagens antes de um lançamento usem dados pagos atuais.

Respostas melhores, menos tokens.

  • Menores custos de IA para o mesmo trabalho
  • Respostas mais precisas e confiáveis
  • Somente leitura
  • Usa os dados de TikTok Ads que você já sincroniza
  • Certificação SOC 2 Type II
Gemini CLI
Conectado ao Dataddo

Quais campanhas do TikTok converteram mais barato no mês passado e para onde foi a verba?

Gemini Resposta · TikTok Ads

Spring Retargeting converteu mais barato, a US$ 11,40 por conversão, com a menor verba. Creator Launch ficou com o maior investimento, US$ 14.200, mas custou US$ 19,70 por conversão.

Campaign nameSpendConversionCost per conversion
Spring Retargeting TikTok Insights US$ 4.560400US$ 11,40
Creator Launch TikTok Insights US$ 14.200721US$ 19,70
Prospecting Broad TikTok Insights US$ 9.850612US$ 16,09

Spend e Conversion vêm de um relatório Basic no nível de campanha somado por Stat Time Day; Cost per conversion é o Spend do mês dividido por Conversion, e não uma média dos valores diários.

fonte
TikTok Ads · em seg 06:40 UTC
período
1-30 set 2026
Resposta de exemplo · conta e números fictícios
TikTok Ads no Gemini

Perguntas que o Gemini responde com seus dados de TikTok Ads

O TikTok Ads extrai dados de publicidade paga das contas de anunciante do TikTok Ads Manager: investimento, impressões, cliques e conversões por campanha, grupo de anúncios ou anúncio, recortes de público por idade, gênero, país e posicionamento, configurações de campanhas e grupos de anúncios, criativos, materiais criativos do Smart+ e leads do Instant Form.

Dados diários de campanhas para um notebook

Pergunte ao Gemini

Consulte Spend, Impressions, Clicks e Conversion por Campaign name e Stat Time Day dos últimos 90 dias e salve como data/tiktok_daily.csv.

Uma analista de marketing usa o CSV em um notebook de previsão no mesmo repositório. O Gemini CLI pergunta antes de cada chamada ao Dataddo, e o prompt fica na mensagem do commit para a extração poder ser repetida.

Checagem de landing pages antes de publicar o site

Pergunte ao Gemini

Liste cada Landing Page URL dos anúncios ativos do TikTok e compare cada caminho com as rotas em src/pages, marcando as que esta versão remove.

Antes de um deploy do site, um desenvolvedor roda a checagem no terminal, encontra anúncios que cairiam em uma página excluída e avisa o time de mídia paga quais anúncios atualizar antes do lançamento.

Ranking de criativos Smart+ em um script

Pergunte ao Gemini

Com Smart+ Creatives Metrics by Campaign, calcule Clicks a cada 1.000 Impressions para cada Main Material Name e grave os 20 melhores em reports/smart-plus.md.

No modo agente do Gemini Code Assist no VS Code, um profissional de marketing técnico transforma a pergunta em um pequeno script, e o ranking de criativos Smart+ roda do mesmo jeito toda semana.

Datasets de TikTok Ads e as perguntas que o Gemini responde com eles →
Preços

Preço por assento.

O Data to AI™ é cobrado por assento, como os assistentes de IA que sua equipe já usa, com ~25% de desconto no faturamento anual. Precisa de contratos personalizados ou preços por volume? Fale conosco sobre o Enterprise.

Data to AITM

Entregue dados de negócio governados ao Claude, ChatGPT e outras ferramentas de IA via MCP.

$10.49/mês

por assento

Mínimo de 3 assentos

Enterprise

Implante o Dataddo com flexibilidade em qualquer ambiente de nuvem ou híbrido.

Personalizado

Temos um modelo de pagamento que funciona para você

Ver todos os planos e recursos →
Configuração

Conecte TikTok Ads ao Gemini passo a passo

  1. 1
    Conecte o Gemini à Dataddo Adicione o servidor da Dataddo ao settings.json no Gemini CLI, reinicie-o e execute /mcp auth dataddo para entrar. O Gemini Code Assist no VS Code lê o mesmo arquivo.
  2. 2
    Conecte TikTok Ads à Dataddo Faça login com sua conta TikTok Ads na Dataddo e escolha os datasets a sincronizar, por exemplo TikTok Insights: Basic report by campaign e TikTok Insights: Basic report by ad.
  3. 3
    Escolha o que o Gemini vê Selecione os dados de TikTok Ads que o Gemini pode consultar. O acesso é somente leitura, e os dados não selecionados ficam fora do alcance.
Guia de configuração do Gemini →
Com vs. sem

TikTok Ads no Gemini, com e sem Dataddo

Sem Dataddo Com Dataddo Resultado para você
Dados para scripts Um analista baixa um CSV do TikTok Ads Manager, renomeia colunas à mão e faz commit de um arquivo que ninguém consegue atualizar. O Gemini CLI consulta o TikTok Insights pelo servidor dataddo, então o script pode rodar de novo com dados novos e os mesmos nomes de campo. Extrações repetíveis
Segurança nos lançamentos Desenvolvedores publicam mudanças no site sem saber quais anúncios do TikTok ainda apontam para as páginas que eles movem ou excluem. O dataset Ads traz Landing Page URL e Operation Status, então uma checagem antes do deploy compara os anúncios ativos com as rotas do site. Menos cliques em links quebrados
Acesso entre ferramentas Cada script guarda o próprio token da API do TikTok, e ninguém sabe qual ainda é válido. O Gemini guarda as credenciais do Dataddo em ~/.gemini/mcp-oauth-tokens.json e as renova, enquanto o login do TikTok fica no autorizador do Dataddo. Nenhum token de API nos repositórios
Consumo de tokens O Gemini gasta tokens explorando colunas brutas de TikTok Ads, amostrando linhas e tentando de novo até entender os dados. Definições de campos e relações chegam prontas, então o modelo pula a exploração e vai direto à resposta. Menos tokens por resposta
Qualidade das respostas Sujeito a joins errados, campos inventados e números difíceis de conferir. Respostas baseadas em campos definidos. No benchmark da Dataddo, 78,5% das perguntas foram respondidas corretamente, contra 65,5% com arquivos CSV simples. Respostas melhores
Datasets

Datasets de TikTok Ads e as perguntas que o Gemini responde com eles

Os datasets de TikTok Ads que equipes de marketing mais usam, com os nomes reais dos campos. O Gemini consulta cada um pelo nome por meio da camada semântica da Dataddo.

Dataset Métricas e atributos Pergunte ao Gemini
TikTok Insights: Basic report by campaign
  • Campaign name
  • Impressions
  • CTR
  • Stat Time Day
  • Spend
  • + outros
Qual Campaign name teve CTR em queda nos últimos 14 dias enquanto as Impressions continuavam subindo?
TikTok Insights: Basic report by ad
  • Spend
  • CTR
  • Ad name
  • Ad group name
  • Video Views
  • + outros
Quais anúncios tiveram CTR acima da média da conta na semana passada, e quanto Spend consumiram?
TikTok Insights: Audience report Qual faixa de Age gerou mais Clicks por unidade de Spend no mês passado?
Campaigns
  • Objective Type
  • Budget
  • Campaign Name
  • Budget Mode
  • Operation Status
  • + outros
Como o Budget total se divide por Objective Type entre as nossas campanhas do TikTok?
Ad Groups
  • Ad Group Name
  • Placements
  • Campaign Name
  • Optimization Goal
  • Bid Type
  • + outros
Quais Ad Group Name rodam em mais de uma das Placements disponíveis?
Ads
  • Ad Name
  • Ad Text
  • Landing Page URL
  • Ad Format
  • Operation Status
  • + outros
Quais Ad Name usam o mesmo Ad Text mas mandam tráfego para outra Landing Page URL?
Smart+ Creatives Metrics by Campaign
  • Campaign ID
  • Spend
  • Main Material Name
  • Main Material Type
  • Impressions
  • + outros
Como o Spend do Smart+ se distribui entre os materiais criativos de cada Campaign ID?
Lead Generation Leads Em quais dias da semana são criados mais leads, com base em Created Time?
Veja todos os datasets, métricas e atributos de TikTok Ads na página do conector →
Benchmark

Mais respostas certas. Metade dos erros confiantes.

Fizemos 43 perguntas pré-registradas sobre três conjuntos de dados reais - Google Search Console, negócios do HubSpot e Google Ads - e entregamos as mesmas linhas ao mesmo modelo de quatro formas. Só a camada de dados mudou.

78,5%

das perguntas respondidas corretamente - o melhor dos quatro métodos de entrega testados

2x

menos respostas erradas dadas com confiança - 14,0% das execuções contra 24,0% e 26,3%

2,8x

mais respostas corretas em dados de CRM bagunçados - melhor em 8 perguntas, pior em nenhuma

Respostas corretas Todas as 43 perguntas - maior é melhor
Erradas, mas apresentadas como fato Parcela das execuções - menor é melhor

Mesmo modelo, mesmos prompts e mesmas linhas em todas as condições; 759 execuções avaliadas, com o gabarito definido antes de qualquer execução. Só no Google Search Console, os arquivos CSV documentados tiveram o mesmo desempenho do Data to AI™ - a vantagem vem de dados mais complexos, como os negócios do HubSpot.

Ler o benchmark →
Perguntas frequentes

TikTok Ads e Gemini: perguntas frequentes

Como conecto TikTok Ads ao Gemini?

Crie uma fonte do TikTok Ads no Dataddo com datasets do TikTok Insights, Ads ou Smart+ e vincule-a a um destino do Google Gemini ou a um AI Model. Adicione o Dataddo ao ~/.gemini/settings.json com httpUrl https://headless.dataddo.com/mcp-data, reinicie o Gemini CLI, rode /mcp auth dataddo e faça login.

Funciona no app do Gemini ou no Gemini na web?

A configuração documentada cobre o Gemini CLI no terminal e o Gemini Code Assist na IDE. O modo agente do VS Code lê o mesmo settings.json; no IntelliJ, adicione o servidor ao mcp.json do Gemini Code Assist.

Por que o Gemini CLI não consegue se conectar aos dados do TikTok Ads?

Confira se o settings.json usa a chave httpUrl. A chave url recorre ao SSE, que o Dataddo não suporta. Não inclua headers nem bloco oauth, reinicie o Gemini CLI e rode /mcp auth dataddo.

Quais fluxos do TikTok Ads o Gemini consegue acessar?

Depois do login, o Gemini acessa todos os fluxos ou Contexts vinculados a um destino de IA ou AI Model nessa conta do Dataddo, não só os do Google Gemini. Vincule apenas os dados do TikTok Ads que quer consultar.

Um script do Gemini CLI pode alterar minhas campanhas do TikTok?

Não. O Gemini consulta os dados extraídos do TikTok Ads pela camada semântica, por nome de entidade e de campo. O Dataddo nunca aceita SQL do modelo, e nada é gravado de volta no TikTok.

Como adiciono histórico do TikTok Ads anterior ao intervalo de datas?

TikTok Insights, Ads e os datasets do Smart+ leem uma janela relativa que avança a cada execução. Faça uma vez uma ressincronização completa dos dados com um intervalo maior, e o Gemini poderá consultar os meses anteriores.

O que acontece quando minha sessão do Gemini com o Dataddo expira?

Os tokens são renovados automaticamente. Se uma sessão expirar ou for revogada, rode /mcp auth dataddo de novo e faça login com seu e-mail e senha do Dataddo, com MFA se for solicitado.

Novidade da Dataddo · Data to AI™

Pergunte ao Claude ou ao ChatGPT sobre seus anúncios, analytics e CRM

“Quanto nos custou um novo lead na semana passada, por canal pago?”

Conecte mais de 400 fontes uma única vez e receba a resposta direto no seu chat de IA, sem montar um relatório. Respostas melhores: suas métricas são definidas uma só vez, então a IA não precisa adivinhar.