Campaigns
Advertentiecampagnes, gemaakt en beheerd met AI.
Zeven methoden staan open voor een API-sleutel van een account. Ze werken op een campagne die al bestaat: je maakt en betaalt een campagne in het dashboard, waar de kaart en de voorwaarden zijn, en vanuit code kun je de tekst ervan schrijven, hem naar zijn netwerken sturen, hem pauzeren of hervatten en lezen hoe het ermee gaat. Een campagne aanmaken en ervoor betalen kan vandaag niet vanuit code.
Elke aanroep is een POST naar https://xuda.ai/cpi/<method> met je sleutel en een data-object. Antwoorden komen terug als { "code": 1, "data": ... }; een negatieve code is een weigering, met de reden in data.
Van briefing naar draaiende campagne
Vind je campagnes
get_account_advertising toont de campagnes van je account. Elke heeft een id: dat is de app_id die de andere methoden nemen.
Zie welke netwerken live zijn
get_advertise_platforms geeft elk netwerk en zijn status terug: pending, processing of active. Inloggegevens zijn nooit onderdeel van het antwoord.
Schrijf of herschrijf de tekst
generate_ad_creative schrijft een kop, hoofdtekst, beschrijving en knop voor een campagne en een netwerk, in een toon die jij kiest: Professional, Friendly, Bold, Playful, Urgent of Luxury (Friendly als je niets opgeeft). Het draait op je AI-credits. Als die op zijn, of de pagina niet kan worden gelezen, krijg je in plaats daarvan een algemeen concept en zegt het antwoord dat. Google Ads heeft zijn eigen sjabloon; de andere netwerken delen een feedsjabloon.
Stuur het naar een netwerk
launch_ad_campaign maakt de campagne aan op een netwerk, altijd gepauzeerd. slug is google-ads of meta; zonder waarde is het google-ads, en elke andere waarde wordt geweigerd. Een tweede aanroep voor hetzelfde netwerk werkt de bestaande campagne bij, dus herhalen is veilig. Op Google krijgt een account zonder Google Ads-klantaccount de eerste keer er een, aangemaakt onder het managementaccount van Xuda.
Zet het aan of uit
set_ad_network_status pauzeert of hervat de live campagnes op elk netwerk waarnaar de campagne is gestuurd. Het is wat de Actief-schakelaar in het dashboard voor de netwerken doet. Geef status mee als active of paused.
Lees hoe het gaat
get_ad_campaign_report haalt de dagcijfers op van elk netwerk waarnaar de campagne is gestuurd, voor de laatste 1 tot 30 dagen (14 als je niets opgeeft).
Een campagne draait op Google Ads, Meta Ads of beide. De andere netwerken die de bouwer toont, zijn gemarkeerd als binnenkort beschikbaar en kunnen niet worden gelanceerd.
De campagne staat nu op het netwerk en is gepauzeerd. Roep set_ad_network_status aan met "status": "active" om hem te starten.
Dit zijn de cijfers die het Overzicht tekent, en ze zijn alleen die van je eigen campagne: een aanroep voor een campagne die niet van jou is, wordt geweigerd.
Methoden
get_account_advertising, dat de campagnes van het account toont, hoort bij de Account-microservice. Zie Statische websites voor de Account-tabel waar hij naast staat.