Campaigns
Campanhas de anúncios, criadas e geridas com IA.
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).
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.
A campanha está agora na rede e em pausa. Chame set_ad_network_status com "status": "active" para a iniciar.
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á.