Naar de inhoud springen

Campaigns

Advertentiecampagnes, gemaakt en beheerd met AI.

Campaigns openen
Gecontroleerd aan de hand van het dashboard op 18 november 2026

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).

Alleen Google Ads en Meta Ads zijn gekoppeld

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.

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'}},
)

De campagne staat nu op het netwerk en is gepauzeerd. Roep set_ad_network_status aan met "status": "active" om hem te starten.

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}},
)

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.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026