Campaigns
Hirdetési kampányok, AI-val készítve és futtatva.
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).
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.
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.
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.