Preskočiť na obsah

Campaigns

Reklamné kampane, vytvorené a spravované pomocou AI.

Otvoriť Campaigns
Overené voči nástenke dňa 18. novembra 2026

Sedem metód je otvorených pre API kľúč účtu. Fungujú na kampani, ktorá už existuje: kampaň vytvoríte a zaplatíte v dashboarde, kde sú karta a podmienky, a z kódu môžete napísať jej text, odoslať ju do sietí, pozastaviť alebo obnoviť a čítať, ako sa jej darí. Vytvorenie kampane a jej zaplatenie z kódu dnes nie je dostupné.

Každé volanie je POST na https://xuda.ai/cpi/<method> s vaším kľúčom a objektom data. Odpovede prichádzajú ako { "code": 1, "data": ... }; záporný code je odmietnutie s dôvodom v data.

Od zadania k bežiacej kampani

Nájdite svoje kampane

get_account_advertising vypíše kampane vášho účtu. Každá má id: je to app_id, ktoré berú ostatné metódy.

Pozrite, ktoré siete bežia

get_advertise_platforms vráti každú sieť a jej stav, pending, processing alebo active. Prihlasovacie údaje nie sú nikdy súčasťou odpovede.

Napíšte alebo prepíšte text

generate_ad_creative napíše nadpis, hlavný text, popis a tlačidlo pre kampaň a sieť v tóne, ktorý si vyberiete: Professional, Friendly, Bold, Playful, Urgent alebo Luxury (Friendly, ak ho vynecháte). Beží na vašich AI kreditoch. Keď žiadne nezostali alebo sa stránku nedá prečítať, dostanete namiesto toho všeobecný návrh a odpoveď povie, ktorý. Google Ads má vlastnú šablónu; ostatné siete zdieľajú šablónu pre feed.

Odošlite ju do siete

launch_ad_campaign vytvorí kampaň v sieti, vždy pozastavenú. slug je google-ads alebo meta; bez neho je to google-ads a každá iná hodnota sa odmietne. Druhé volanie pre tú istú sieť aktualizuje kampaň, ktorá tam je, takže ho môžete bezpečne opakovať. Na Google sa účtu bez klientskeho účtu Google Ads pri prvom volaní vytvorí jeden pod manažérskym účtom Xuda.

Zapnite ju alebo vypnite

set_ad_network_status pozastaví alebo obnoví bežiace kampane na každej sieti, do ktorej bola kampaň odoslaná. Robí to, čo vypínač Prebieha v dashboarde robí so sieťami. Zadajte status ako active alebo paused.

Prečítajte, ako sa jej darí

get_ad_campaign_report stiahne denné čísla z každej siete, do ktorej bola kampaň odoslaná, za posledných 1 až 30 dní (14, ak ho vynecháte).

Zapojené sú len Google Ads a Meta Ads

Kampaň beží na Google Ads, Meta Ads alebo na oboch. Ostatné siete, ktoré tvorca uvádza, sú označené ako čoskoro a nedá sa na ne spúšťať.

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

Kampaň je teraz v sieti a pozastavená. Zavolajte set_ad_network_status s "status": "active", aby sa spustila.

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

Toto sú čísla, ktoré kreslí Prehľad, a sú iba z vašej vlastnej kampane: volanie pre kampaň, ktorá nie je vaša, sa odmietne.

Metódy

get_account_advertising, ktorá vypisuje kampane účtu, patrí do mikroslužby Account. Tabuľku Account, vedľa ktorej stojí, nájdete v Static Websites.

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026