Campaigns
Annoncekampagner, lavet og kørt med AI.
Syv metoder er åbne for en API-nøgle til kontoen. De virker på en kampagne, der allerede findes: du laver og betaler en kampagne i dashboardet, hvor kortet og vilkårene er, og fra kode kan du skrive dens tekst, sende den til dens netværk, sætte den på pause eller genoptage den og læse, hvordan det går. At oprette en kampagne og betale for den er ikke muligt fra kode i dag.
Hvert kald er en POST til https://xuda.ai/cpi/<method> med din nøgle og et data-objekt. Svar kommer tilbage som { "code": 1, "data": ... }. En negativ code er en afvisning, med årsagen i data.
Fra et oplæg til en kørende kampagne
Find dine kampagner
get_account_advertising viser kontoens kampagner. Hver har et id: det er det app_id, de andre metoder tager.
Se, hvilke netværk der er live
get_advertise_platforms returnerer hvert netværk og dets status: pending, processing eller active. Legitimationsoplysninger er aldrig en del af svaret.
Skriv eller omskriv teksten
generate_ad_creative skriver en overskrift, primær tekst, beskrivelse og knap til en kampagne og et netværk i en tone, du vælger: Professional, Friendly, Bold, Playful, Urgent eller Luxury (Friendly, hvis du udelader den). Det kører på dine AI-kreditter. Når der ingen er tilbage, eller siden ikke kan læses, får du i stedet et generisk udkast, og svaret siger hvilket. Google Ads har sin egen skabelon. De andre netværk deler en feed-skabelon.
Send den til et netværk
launch_ad_campaign opretter kampagnen på et netværk, altid på pause. slug er google-ads eller meta. Uden er den google-ads, og enhver anden værdi afvises. Et andet kald for samme netværk opdaterer den kampagne, der er der, så det er sikkert at gentage. På Google får en konto uden en Google Ads-klientkonto oprettet en under Xudas managerkonto første gang.
Slå den til eller fra
set_ad_network_status sætter de live kampagner på pause eller genoptager dem på hvert netværk, kampagnen blev sendt til. Det er det, kontakten Aktiv i dashboardet gør for netværkene. Send status som active eller paused.
Læs, hvordan det går
get_ad_campaign_report henter de daglige tal fra hvert netværk, kampagnen blev sendt til, for de seneste 1 til 30 dage (14, hvis du udelader det).
En kampagne kører på Google Ads, Meta Ads eller begge. De andre netværk, byggeren viser, er markeret som kommer snart og kan ikke lanceres til.
Kampagnen er nu på netværket og på pause. Kald set_ad_network_status med "status": "active" for at starte den.
Det er de tal, Oversigten tegner, og de er kun din egen kampagnes: et kald for en kampagne, der ikke er din, afvises.
Metoder
get_account_advertising, som viser kontoens kampagner, hører til mikrotjenesten Account. Se Static Websites for den Account-tabel, den står ved siden af.