Ugrás a tartalomhoz

Campaigns

Hirdetési kampányok, AI-val készítve és futtatva.

Campaigns megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 18.

Hét metódus érhető el a fiók API-kulcsával. Egy már létező kampányon dolgoznak: a kampányt a vezérlőpulton hozza létre és fizeti ki, ahol a kártya és a feltételek vannak, kódból pedig megírhatja a szövegét, elküldheti a hálózataira, szüneteltetheti vagy folytathatja, és elolvashatja, hogyan teljesít. Kampány létrehozása és kifizetése ma nem érhető el kódból.

Minden hívás egy POST a https://xuda.ai/cpi/<method> címre a kulcsával és egy data objektummal. A válaszok { "code": 1, "data": ... } alakban érkeznek; a negatív code elutasítás, az okával a data-ban.

A leírástól a futó kampányig

Keresse meg a kampányait

A get_account_advertising felsorolja a fiókja kampányait. Mindegyiknek van azonosítója: ez az app_id, amelyet a többi metódus kér.

Nézze meg, mely hálózatok élnek

A get_advertise_platforms visszaadja az egyes hálózatokat és az állapotukat: pending, processing vagy active. A hitelesítő adatok soha nem részei a válasznak.

Írja meg vagy írja át a szöveget

A generate_ad_creative címsort, elsődleges szöveget, leírást és gombot ír egy kampányhoz és egy hálózathoz, az Ön által választott hangnemben: Professional, Friendly, Bold, Playful, Urgent vagy Luxury (Friendly, ha kihagyja). Az AI krediteiből fut. Ha elfogytak, vagy az oldal nem olvasható, egy általános vázlatot kap helyette, és a válasz megmondja, melyiket. A Google Ads-nak saját sablonja van; a többi hálózat egy közös feed-sablont használ.

Küldje el egy hálózatra

A launch_ad_campaign létrehozza a kampányt egy hálózaton, mindig szüneteltetve. A slug google-ads vagy meta; ha nincs megadva, google-ads, és bármely más értéket elutasítunk. Ugyanarra a hálózatra érkező második hívás frissíti a meglévő kampányt, így biztonságosan megismételhető. A Google-nél az a fiók, amelynek nincs Google Ads ügyfélfiókja, az elsőre kap egyet a Xuda manager-fiókja alatt.

Kapcsolja be vagy ki

A set_ad_network_status szünetelteti vagy folytatja az élő kampányokat minden olyan hálózaton, amelyre a kampányt elküldték. Ezt teszi a vezérlőpulton az Aktív kapcsoló a hálózatokkal. A status értéke active vagy paused.

Olvassa el, hogyan teljesít

A get_ad_campaign_report lekéri a napi számokat minden olyan hálózatról, amelyre a kampányt elküldték, az utolsó 1-30 napra (14, ha kihagyja).

Csak a Google Ads és a Meta Ads van bekötve

A kampány a Google Ads-on, a Meta Ads-en vagy mindkettőn fut. Az építő által felsorolt többi hálózat jelölése: hamarosan, és nem lehet rájuk indítani.

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

A kampány most a hálózaton van, szüneteltetve. Az indításhoz hívja meg a set_ad_network_status metódust "status": "active" értékkel.

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

Ezek azok a számok, amelyeket az Áttekintés megrajzol, és kizárólag a saját kampányáéi: a nem az Öné kampányra irányuló hívást elutasítjuk.

Metódusok

A get_account_advertising, amely felsorolja a fiók kampányait, az Account mikroszolgáltatáshoz tartozik. A mellette lévő Account táblázatot lásd: Statikus weboldalak.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.