Sari la conținut

Campanii

Campanii publicitare, create și rulate cu AI.

Deschide Campanii
Verificat față de tabloul de bord la 18 noiembrie 2026

Șapte metode sunt deschise unei chei API de cont. Funcționează pe o campanie care există deja: o creezi și o plătești în dashboard, unde se află cardul și termenii, iar din cod îi poți scrie textele, o poți trimite în rețelele ei, o poți pune în pauză sau relua și poți citi cum merge. Crearea unei campanii și plata ei nu sunt disponibile din cod în prezent.

Fiecare apel este un POST către https://xuda.ai/cpi/<method> cu cheia ta și un obiect data. Răspunsurile vin ca { "code": 1, "data": ... }; un code negativ este un refuz, cu motivul în data.

De la descriere la o campanie care rulează

Găsește-ți campaniile

get_account_advertising listează campaniile contului tău. Fiecare are un id: acela este app_id pe care îl primesc celelalte metode.

Vezi ce rețele sunt live

get_advertise_platforms returnează fiecare rețea și starea ei: pending, processing sau active. Datele de acces nu fac niciodată parte din răspuns.

Scrie sau rescrie textele

generate_ad_creative scrie un titlu, un text principal, o descriere și un buton pentru o campanie și o rețea, într-un ton la alegere: Professional, Friendly, Bold, Playful, Urgent sau Luxury (Friendly dacă îl omiți). Rulează pe creditele tale AI. Când nu mai ai deloc sau pagina nu poate fi citită, primești în schimb o schiță generică, iar răspunsul spune care este cazul. Google Ads are propriul șablon; celelalte rețele împart un șablon de feed.

Trimite-o într-o rețea

launch_ad_campaign creează campania într-o rețea, mereu în pauză. slug este google-ads sau meta; fără el este google-ads, iar orice altă valoare este refuzată. Un al doilea apel pentru aceeași rețea actualizează campania existentă, deci poate fi repetat în siguranță. Pe Google, un cont fără cont client Google Ads primește unul creat sub contul manager al Xuda prima dată.

Pornește-o sau oprește-o

set_ad_network_status pune în pauză sau reia campaniile live din fiecare rețea în care a fost trimisă campania. Este ceea ce face comutatorul Activ din dashboard pentru rețele. Dă status ca active sau paused.

Citește cum merge

get_ad_campaign_report extrage cifrele zilnice din fiecare rețea în care a fost trimisă campania, pentru ultimele 1 până la 30 de zile (14 dacă îl omiți).

Doar Google Ads și Meta Ads sunt conectate

O campanie rulează pe Google Ads, pe Meta Ads sau pe ambele. Celelalte rețele pe care le listează generatorul sunt marcate ca disponibile în curând și nu se poate lansa în ele.

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

Campania este acum în rețea și în pauză. Apelează set_ad_network_status cu "status": "active" ca să o pornești.

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

Acestea sunt cifrele pe care le desenează Overview și sunt doar ale propriei tale campanii: un apel pentru o campanie care nu este a ta este refuzat.

Metode

get_account_advertising, care listează campaniile contului, aparține microserviciului Account. Vezi Static Websites pentru tabelul Account lângă care se află.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026