Campanii
Campanii publicitare, create și rulate cu AI.
Șapte metode sunt deschise unei chei API de cont. Funcționează pe o campanie care există deja: o creezi și o plătești în dashboard, unde se află cardul și termenii, iar din cod îi poți scrie textele, o poți trimite în rețelele ei, o poți pune în pauză sau relua și poți citi cum merge. Crearea unei campanii și plata ei nu sunt disponibile din cod în prezent.
Fiecare apel este un POST către https://xuda.ai/cpi/<method> cu cheia ta și un obiect data. Răspunsurile vin ca { "code": 1, "data": ... }; un code negativ este un refuz, cu motivul în data.
De la descriere la o campanie care rulează
Găsește-ți campaniile
get_account_advertising listează campaniile contului tău. Fiecare are un id: acela este app_id pe care îl primesc celelalte metode.
Vezi ce rețele sunt live
get_advertise_platforms returnează fiecare rețea și starea ei: pending, processing sau active. Datele de acces nu fac niciodată parte din răspuns.
Scrie sau rescrie textele
generate_ad_creative scrie un titlu, un text principal, o descriere și un buton pentru o campanie și o rețea, într-un ton la alegere: Professional, Friendly, Bold, Playful, Urgent sau Luxury (Friendly dacă îl omiți). Rulează pe creditele tale AI. Când nu mai ai deloc sau pagina nu poate fi citită, primești în schimb o schiță generică, iar răspunsul spune care este cazul. Google Ads are propriul șablon; celelalte rețele împart un șablon de feed.
Trimite-o într-o rețea
launch_ad_campaign creează campania într-o rețea, mereu în pauză. slug este google-ads sau meta; fără el este google-ads, iar orice altă valoare este refuzată. Un al doilea apel pentru aceeași rețea actualizează campania existentă, deci poate fi repetat în siguranță. Pe Google, un cont fără cont client Google Ads primește unul creat sub contul manager al Xuda prima dată.
Pornește-o sau oprește-o
set_ad_network_status pune în pauză sau reia campaniile live din fiecare rețea în care a fost trimisă campania. Este ceea ce face comutatorul Activ din dashboard pentru rețele. Dă status ca active sau paused.
Citește cum merge
get_ad_campaign_report extrage cifrele zilnice din fiecare rețea în care a fost trimisă campania, pentru ultimele 1 până la 30 de zile (14 dacă îl omiți).
O campanie rulează pe Google Ads, pe Meta Ads sau pe ambele. Celelalte rețele pe care le listează generatorul sunt marcate ca disponibile în curând și nu se poate lansa în ele.
Campania este acum în rețea și în pauză. Apelează set_ad_network_status cu "status": "active" ca să o pornești.
Acestea sunt cifrele pe care le desenează Overview și sunt doar ale propriei tale campanii: un apel pentru o campanie care nu este a ta este refuzat.
Metode
get_account_advertising, care listează campaniile contului, aparține microserviciului Account. Vezi Static Websites pentru tabelul Account lângă care se află.