Campaigns
Annonsekampanjer, laget og kjørt med AI.
Sju metoder er åpne for en API-nøkkel for kontoen. De virker på en kampanje som allerede finnes: du lager og betaler en kampanje i dashbordet, der kortet og vilkårene er, og fra kode kan du skrive teksten dens, sende den til nettverkene, pause eller gjenoppta den og lese hvordan det går. Å opprette en kampanje og betale for den er ikke tilgjengelig fra kode i dag.
Hvert kall er en POST til https://xuda.ai/cpi/<method> med nøkkelen din og et data-objekt. Svar kommer som { "code": 1, "data": ... }; en negativ code er en avvisning, med årsaken i data.
Fra en kort til en kjørende kampanje
Finn kampanjene dine
get_account_advertising lister kampanjene på kontoen din. Hver har en id: det er app_id de andre metodene tar.
Se hvilke nettverk som er live
get_advertise_platforms returnerer hvert nettverk og statusen, pending, processing eller active. Legitimasjon er aldri en del av svaret.
Skriv eller skriv om teksten
generate_ad_creative skriver en overskrift, hovedtekst, beskrivelse og knapp for en kampanje og et nettverk, i en tone du velger: Professional, Friendly, Bold, Playful, Urgent eller Luxury (Friendly hvis du utelater den). Den bruker AI-kredittene dine. Når det ikke er flere igjen, eller siden ikke kan leses, får du et generisk utkast i stedet, og svaret sier hvilket. Google Ads har sin egen mal; de andre nettverkene deler en feed-mal.
Send den til et nettverk
launch_ad_campaign oppretter kampanjen på et nettverk, alltid pauset. slug er google-ads eller meta; uten verdi er den google-ads, og alle andre verdier avvises. Et nytt kall for samme nettverk oppdaterer kampanjen som finnes, så det er trygt å gjenta. På Google får en konto uten Google Ads-klientkonto opprettet en under Xudas administratorkonto første gang.
Slå den på eller av
set_ad_network_status pauser eller gjenopptar de live kampanjene på hvert nettverk kampanjen ble sendt til. Det er dette bryteren Aktiv i dashbordet gjør for nettverkene. Send status som active eller paused.
Les hvordan det går
get_ad_campaign_report henter de daglige tallene fra hvert nettverk kampanjen ble sendt til, for de siste 1 til 30 dagene (14 hvis du utelater det).
En kampanje kjører på Google Ads, Meta Ads eller begge. De andre nettverkene byggeren lister, er merket som kommer snart og kan ikke lanseres til.
Kampanjen ligger nå på nettverket, pauset. Kall set_ad_network_status med "status": "active" for å starte den.
Dette er tallene Oversikt tegner, og de gjelder bare din egen kampanje: et kall for en kampanje som ikke er din, avvises.
Metoder
get_account_advertising, som lister kontoens kampanjer, hører til Account-mikrotjenesten. Se Static Websites for Account-tabellen den står ved siden av.