Campaigns
Reklamní kampaně vytvářené a vedené s AI.
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).
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.
Kampaň je nyní v síti a pozastavená. Zavolejte set_ad_network_status s "status": "active", aby se spustila.
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.