Saltar para o conteúdo

Campaigns

Campanhas de anúncios, criadas e geridas com IA.

Abrir Campaigns
Verificado com o painel em 18 de novembro de 2026

Sete métodos estão abertos a uma chave de API da conta. Funcionam numa campanha que já existe: cria e paga uma campanha no dashboard, onde estão o cartão e os termos, e a partir de código pode escrever o seu texto, enviá-la para as suas redes, pausá-la ou retomá-la e ler como está a correr. Criar uma campanha e pagá-la não está disponível a partir de código hoje.

Cada chamada é um POST para https://xuda.ai/cpi/<method> com a sua chave e um objeto data. As respostas voltam como { "code": 1, "data": ... }; um code negativo é uma recusa, com a razão em data.

De um briefing a uma campanha em execução

Encontre as suas campanhas

get_account_advertising lista as campanhas da sua conta. Cada uma tem um id: esse é o app_id que os outros métodos recebem.

Veja que redes estão ativas

get_advertise_platforms devolve cada rede e o seu estado, pending, processing ou active. As credenciais nunca fazem parte da resposta.

Escreva ou reescreva o texto

generate_ad_creative escreve um título, texto principal, descrição e botão para uma campanha e uma rede, num tom à sua escolha: Professional, Friendly, Bold, Playful, Urgent ou Luxury (Friendly se o omitir). Corre com os seus créditos de IA. Quando já não restam, ou a página não pode ser lida, recebe em vez disso um rascunho genérico e a resposta diz qual. O Google Ads tem o seu próprio modelo; as outras redes partilham um modelo de feed.

Envie-a para uma rede

launch_ad_campaign cria a campanha numa rede, sempre em pausa. slug é google-ads ou meta; sem nenhum é google-ads, e qualquer outro valor é recusado. Uma segunda chamada para a mesma rede atualiza a campanha que lá está, por isso é seguro repeti-la. No Google, uma conta sem conta de cliente Google Ads tem uma criada sob a conta de gestor da Xuda à primeira vez.

Ligue-a ou desligue-a

set_ad_network_status pausa ou retoma as campanhas ativas em todas as redes para onde a campanha foi enviada. É o que o interruptor Ativo do dashboard faz pelas redes. Passe status como active ou paused.

Leia como está a correr

get_ad_campaign_report obtém os números diários de cada rede para onde a campanha foi enviada, dos últimos 1 a 30 dias (14 se o omitir).

Só o Google Ads e o Meta Ads estão ligados

Uma campanha corre no Google Ads, no Meta Ads ou em ambos. As outras redes que o construtor lista estão marcadas como em breve e não é possível lançar para elas.

curl -s https://xuda.ai/cpi/launch_ad_campaign \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","slug":"google-ads"}}'
const res = await fetch('https://xuda.ai/cpi/launch_ad_campaign', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    data: { app_id: 'YOUR_CAMPAIGN_APP_ID', slug: 'google-ads' },
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/launch_ad_campaign',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'slug': 'google-ads'}},
)

A campanha está agora na rede e em pausa. Chame set_ad_network_status com "status": "active" para a iniciar.

curl -s https://xuda.ai/cpi/get_ad_campaign_report \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","days":7}}'
const res = await fetch('https://xuda.ai/cpi/get_ad_campaign_report', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', data: { app_id: 'YOUR_CAMPAIGN_APP_ID', days: 7 } }),
});
const { data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_ad_campaign_report',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'days': 7}},
)

Estes são os valores que a Visão geral desenha, e são apenas da sua própria campanha: uma chamada para uma campanha que não é sua é recusada.

Métodos

get_account_advertising, que lista as campanhas da conta, pertence ao microsserviço Account. Consulte Sites estáticos para a tabela Account ao lado da qual está.

Que tal está este guia?

Última atualização em 16 de novembro de 2026