Přeskočit na obsah

Campaigns

Reklamní kampaně vytvářené a vedené s AI.

Otevřít Campaigns
Ověřeno podle nástěnky dne 18. listopadu 2026

Klíči API účtu je otevřeno sedm metod. Pracují s kampaní, která již existuje: kampaň vytvoříte a zaplatíte v dashboardu, kde jsou karta a podmínky, a z kódu můžete psát její texty, posílat ji do jejích sítí, pozastavovat ji nebo obnovovat a číst, jak se jí daří. Vytvoření kampaně a její zaplacení dnes z kódu možné není.

Každé volání je POST na https://xuda.ai/cpi/<method> s vaším klíčem a objektem data. Odpovědi přicházejí jako { "code": 1, "data": ... }; záporný code je odmítnutí, s důvodem v data.

Od zadání k běžící kampani

Najděte své kampaně

get_account_advertising vypíše kampaně vašeho účtu. Každá má id: to je app_id, které přijímají ostatní metody.

Zjistěte, které sítě běží

get_advertise_platforms vrací každou síť a její stav: pending, processing nebo active. Přihlašovací údaje nikdy nejsou součástí odpovědi.

Napište nebo přepište text

generate_ad_creative napíše nadpis, hlavní text, popis a tlačítko pro kampaň a síť v tónu, který zvolíte: Professional, Friendly, Bold, Playful, Urgent nebo Luxury (Friendly, když ho vynecháte). Běží na vašich AI kreditech. Když žádné nezbyly nebo stránku nelze přečíst, dostanete místo toho obecný návrh a odpověď řekne, který z případů nastal. Google Ads má vlastní šablonu; ostatní sítě sdílejí šablonu feedu.

Pošlete ji do sítě

launch_ad_campaign vytvoří kampaň v síti, vždy pozastavenou. slug je google-ads nebo meta; bez něj je to google-ads a jakákoli jiná hodnota je odmítnuta. Druhé volání pro stejnou síť aktualizuje kampaň, která tam je, takže je bezpečné opakovat. U Google se účtu bez klientského účtu Google Ads poprvé jeden vytvoří pod manažerským účtem Xuda.

Zapněte ji nebo vypněte

set_ad_network_status pozastaví nebo obnoví živé kampaně v každé síti, do které byla kampaň poslána. Je to to, co pro sítě dělá přepínač Probíhá v dashboardu. Předejte status jako active nebo paused.

Přečtěte, jak se jí daří

get_ad_campaign_report stáhne denní čísla z každé sítě, do které byla kampaň poslána, za posledních 1 až 30 dní (14, když to vynecháte).

Zapojeny jsou jen Google Ads a Meta Ads

Kampaň běží na Google Ads, Meta Ads, nebo na obou. Ostatní sítě, které tvůrce uvádí, jsou označeny jako brzy a nelze na ně spouštět.

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 nyní v síti a pozastavená. Zavolejte set_ad_network_status s "status": "active", aby se 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}},
)

Jsou to údaje, které vykresluje Přehled, a jsou jen vaší vlastní kampaně: volání pro kampaň, která není vaše, je odmítnuto.

Metody

get_account_advertising, která vypisuje kampaně účtu, patří do mikroslužby Account. Tabulku Account, vedle které leží, najdete ve Statických webech.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026