Campaigns
Campagne pubblicitarie, create e gestite con l'IA.
Sette metodi sono aperti a una chiave API dell'account. Lavorano su una campagna che esiste già: crei e paghi una campagna nella dashboard, dove ci sono la carta e i termini, e da codice puoi scriverne i testi, inviarla alle sue reti, metterla in pausa o riprenderla e leggere come sta andando. Creare una campagna e pagarla oggi non è possibile da codice.
Ogni chiamata è una POST a https://xuda.ai/cpi/<method> con la tua chiave e un oggetto data. Le risposte tornano come { "code": 1, "data": ... }; un code negativo è un rifiuto, con il motivo in data.
Da un brief a una campagna attiva
Trova le tue campagne
get_account_advertising elenca le campagne del tuo account. Ognuna ha un id: è l'app_id che gli altri metodi richiedono.
Vedi quali reti sono attive
get_advertise_platforms restituisce ogni rete e il suo stato, in attesa, in elaborazione o attiva. Le credenziali non fanno mai parte della risposta.
Scrivi o riscrivi il testo
generate_ad_creative scrive un titolo, un testo principale, una descrizione e un pulsante per una campagna e una rete, in un tono a tua scelta: Professional, Friendly, Bold, Playful, Urgent o Luxury (Friendly se lo ometti). Gira sui tuoi crediti AI. Quando non ne restano, o la pagina non può essere letta, ottieni invece una bozza generica e la risposta dice quale. Google Ads ha il suo modello; le altre reti condividono un modello a feed.
Invialo a una rete
launch_ad_campaign crea la campagna su una rete, sempre in pausa. slug è google-ads o meta; se assente è google-ads, e qualsiasi altro valore viene rifiutato. Una seconda chiamata per la stessa rete aggiorna la campagna che c'è, quindi è sicuro ripeterla. Su Google, un account senza un account cliente Google Ads ne vede creare uno sotto l'account manager di Xuda la prima volta.
Attivalo o disattivalo
set_ad_network_status mette in pausa o riprende le campagne attive su ogni rete a cui la campagna è stata inviata. È ciò che fa nella dashboard l'interruttore Attiva per le reti. Passa status come active o paused.
Leggi come sta andando
get_ad_campaign_report ricava i numeri giornalieri da ogni rete a cui la campagna è stata inviata, per gli ultimi 1-30 giorni (14 se lo ometti).
Una campagna gira su Google Ads, su Meta Ads o su entrambe. Le altre reti elencate dal costruttore sono segnate come in arrivo e non si può lanciare su di esse.
La campagna ora è sulla rete e in pausa. Chiama set_ad_network_status con "status": "active" per avviarla.
Sono le cifre che disegna la Panoramica, e sono solo quelle della tua campagna: una chiamata per una campagna che non è tua viene rifiutata.
Metodi
get_account_advertising, che elenca le campagne dell'account, appartiene al microservizio Account. Vedi Siti web statici per la tabella Account accanto a cui si trova.