Hopp til innholdet

Campaigns

Annonsekampanjer, laget og kjørt med AI.

Åpne Campaigns
Kontrollert mot oversiktspanelet 18. november 2026

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

Bare Google Ads og Meta Ads er koblet til

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.

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

Kampanjen ligger nå på nettverket, pauset. Kall set_ad_network_status med "status": "active" for å starte den.

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

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.

Hvordan er denne veiledningen?

Sist oppdatert 19. november 2026