PluggzyDocs

Anúncios

Suas contas de anúncios em nove redes, em qualquer app de IA. Pergunte como foram seus anúncios, qual campanha desperdiça dinheiro, ou peça para impulsionar um post: seu app de IA encontra a operação, lê os números e faz a mudança. Tudo o que pode gastar dinheiro espera o seu sim.

9redes de anúncios, cada uma com seu próprio login
3ferramentas, as mesmas em todas as redes
336operações, de campanhas a métricas
Seu simantes de tudo o que gasta ou dá acesso

Contas de anúncios

Uma conta de anúncios é uma conta conectada como qualquer outra, feita para anúncios.

O que éSua conta de anúncios em uma rede, conectada ao Pluggzy. O Meta Ads cobre seus anúncios no Facebook e no Instagram. Seu app de IA lê as campanhas e os números, e muda o que você pedir.
No seu planoUma conta conectada, como qualquer outra. Um login do Meta Ads que acessa várias contas de anúncios conta como uma.
Gasto com anúnciosCobrado por cada rede na sua própria conta de anúncios. O Pluggzy não paga anúncios.
Chave própriaCada conta de anúncios recebe uma chave de acesso que só alcança essa conta e nenhuma outra.
Só anúnciosSem mensagens nem DMs: uma conta de anúncios roda anúncios. As conversas ficam nos canais de caixa de entrada.

Conexão

O login de cada rede, pelo seu painel do Pluggzy. O ChatGPT Ads usa uma chave de API.

RedeLogin comEstrutura
Meta AdsAnúncios no Facebook e no InstagramLoginFacebook Login for BusinessEstruturaCampanha › Conjunto de anúncios › Anúncio
Google AdsLoginLogin do GoogleEstruturaCampanha › Grupo de anúncios › Anúncio
LinkedIn AdsLoginLogin do LinkedInEstruturaGrupo de campanhas › Campanha › Criativo
TikTok AdsLoginLogin do TikTokEstruturaCampanha › Grupo de anúncios › Anúncio
Pinterest AdsLoginLogin do PinterestEstruturaCampanha › Grupo de anúncios › Pin promovido
X AdsLoginDois logins: sua conta do X, depois os anúncios delaEstruturaCampanha › Item de linha › Post promovido
Reddit AdsLoginLogin do RedditEstruturaCampanha › Grupo de anúncios › Anúncio
Microsoft AdsCampanhas de pesquisaLoginLogin da MicrosoftEstruturaCampanha › Grupo de anúncios › Anúncio
ChatGPT AdsLoginUma chave de API do ChatGPT Ads Manager (Settings), colada na página de conexão do PluggzyEstruturaCampanha › Grupo de anúncios › Card de chat
  • Cole a chave do ChatGPT Ads na página de conexão do Pluggzy, nunca em um chat.
  • O X Ads pede dois logins: primeiro sua conta do X, depois o acesso aos anúncios dela.

Três ferramentas

As mesmas três em todas as redes. Seu app de IA escolhe a certa; você só pede.

ads_operationsLeituraPrimeiro, para descobrir o que dá para fazer: 336 operações em campanhas, conjuntos de anúncios, anúncios, orçamentos, impulsionamentos, lances, segmentação, públicos, conversões, criativos, catálogos de produtos, formulários de leads, regras, automações e métricas, cada uma com seus parâmetros.query: "pause campaign"groupoperation
ads_readLeituraPara olhar: gastos, resultados, métricas diárias, a árvore de campanhas, melhores anúncios, alertas, públicos, leads, prévias e estimativas de alcance. Não muda nada.get_ads_timelineget_ad_treelist_ads_alerts
ads_writeEscritaPara mudar: criar campanhas, conjuntos de anúncios e anúncios, impulsionar um post, pausar e retomar, orçamentos, lances, segmentação, públicos, exclusões. Tudo o que pode gastar ou dar acesso espera o seu sim.boost_postupdate_ad_campaign_statusupdate_ad_set

Nada gasta sem o seu sim.

Embutido nas ferramentas, em todas as redes e em todos os apps de IA.

Gasto ou acessoSeu sim
Tudo o que pode gastar dinheiro ou dar acesso a alguém só roda depois do seu sim no chat. Aí seu app de IA envia user_confirmed: true.
PausarA qualquer hora
Pausar nunca precisa de sim. Parar de gastar é sempre permitido, em todas as redes.
Novos anúnciosPausados
Seu app de IA é instruído a enviar novos anúncios pausados, a menos que você diga para lançar.

Quando falta o sim

Nada roda e nada é repetido escondido: a ferramenta responde com um código que seu app de IA entende.

confirmation_requiredPode gastar dinheiro ou dar acesso. Seu app de IA diz o que vai rodar e chama de novo quando você concordar.
unsupportedEssa operação não existe nessa rede, como um impulsionamento no Microsoft Ads.
invalid_requestA rede recusou um valor; fields diz qual.
rate_limitedA própria rede pediu para ir mais devagar. retry_after_seconds é exatamente a espera que ela pediu.
Exemplo de recusa
isError
{
  "error": "boost_post can spend money or grant access. Tell the user exactly what it will do, then call again with user_confirmed: true once they agree.",
  "code": "confirmation_required"
}

Limites

O Pluggzy não adiciona limites próprios a uma conta de anúncios: nada de limite diário, limite por minuto ou espaçamento. Uma mudança sai assim que seu app de IA pede. Só valem os limites de taxa de cada rede.

AçãoLimite próprio do PluggzyFerramentas
Leiturasgastos, resultados, métricas, leadsNenhumvalem os limites de taxa da redeads_read
Mudanças que gastamnovos anúncios, impulsionamentos, orçamentos, lances, retomadasNenhumvalem os limites de taxa da redeads_write
Outras mudançaspausas, públicos, criativos, palavras-chave, conversõesNenhumvalem os limites de taxa da redeads_write
Exclusõescampanhas, conjuntos de anúncios, anúncios, públicosNenhumvalem os limites de taxa da redeads_write
LeiturasNenhum
gastos, resultados, métricas, leads
valem os limites de taxa da rede
ads_read
Mudanças que gastamNenhum
novos anúncios, impulsionamentos, orçamentos, lances, retomadas
valem os limites de taxa da rede
ads_write
Outras mudançasNenhum
pausas, públicos, criativos, palavras-chave, conversões
valem os limites de taxa da rede
ads_write
ExclusõesNenhum
campanhas, conjuntos de anúncios, anúncios, públicos
valem os limites de taxa da rede
ads_write
  • Quando uma rede pede para ir mais devagar, o Pluggzy espera exatamente o tempo pedido, ao segundo, e responde rate_limited com retry_after_seconds. Seu app de IA chama de novo depois. Nada fica enfileirado escondido.
  • Seu sim continua vindo primeiro: tudo o que pode gastar dinheiro ou dar acesso espera por ele no chat.
  • Pausar conta como mudança, nunca como gasto: nunca espera um sim.

Dinheiro e números

O que são os números que seu app de IA lê, e de onde vêm.

Na moeda da sua conta.

Gastos, orçamentos, custo por resultado e valor de compra vêm na moeda da própria conta de anúncios.

Da própria rede.

Os números são os que cada rede informa: gastos, impressões, alcance, cliques, conversões e o resto.

90 dias do Meta ao conectar.

O Meta Ads traz os últimos 90 dias quando uma conta se conecta. O histórico mais antigo chega depois.

Cortado para caber, e avisa.

Uma resposta muito longa volta encurtada com truncated: true. Restrinja: datas, um limite, uma campanha.

Como sua IA pede

Você não cita operações. Peça como pediria a um colega; seu app de IA transforma em chamadas.

“Como foram meus anúncios do Meta nesta semana em comparação com a semana passada?”ads_read({ operation: "get_ads_timeline", params: { compare: true } })
Gastos e resultados dia a dia na semana, ao lado da semana anterior, na moeda da conta.
“Qual campanha do Google Ads tem o pior custo por conversão? Pausa ela.”ads_write({ operation: "update_ad_campaign_status", body: { status: "paused" } })
Lê as campanhas primeiro e pausa a pior. Pausar não precisa de sim.
“Impulsiona meu último post do Instagram com R$ 50 por dia durante 5 dias para pessoas de 25 a 40 anos no Brasil.”ads_write({ operation: "boost_post", …, user_confirmed: true })
Seu app de IA informa orçamento, datas e público, espera o seu sim e cria pausado ou no ar, como você disse.
“Aumenta em 20% o orçamento do meu melhor grupo de anúncios do TikTok.”ads_write({ operation: "update_ad_set", …, user_confirmed: true })
Aumentar orçamento pode gastar mais, então ele pergunta antes.
“Lista os leads do meu formulário do LinkedIn deste mês.”ads_read({ operation: "list_leads", … })
Os leads que seu formulário coletou, só leitura.
“Qual dos meus anúncios tem um alerta ou foi reprovado?”ads_read({ operation: "list_ads_alerts" })
Os anúncios que precisam de atenção, na conta inteira.
Cada entrada e saídaads_operations, ads_read e ads_write, com suas recusas, na referência.
Ferramentas de anúncios
Gerado a partir de pluggzy.com/api/docs · 42 ferramentasAlgo não ficou claro? Fale com o suporte · Status