Campaigns
Reklamné kampane, vytvorené a spravované pomocou AI.
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).
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ť.
Kampaň je teraz v sieti a pozastavená. Zavolajte set_ad_network_status s "status": "active", aby sa spustila.
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.