Vai al contenuto

Campaigns

Campagne pubblicitarie, create e gestite con l'IA.

Apri Campaigns
Verificato rispetto alla dashboard il 18 novembre 2026

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).

Sono collegate solo Google Ads e Meta Ads

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.

curl -s https://xuda.ai/cpi/launch_ad_campaign \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","slug":"google-ads"}}'
const res = await fetch('https://xuda.ai/cpi/launch_ad_campaign', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    data: { app_id: 'YOUR_CAMPAIGN_APP_ID', slug: 'google-ads' },
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/launch_ad_campaign',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'slug': 'google-ads'}},
)

La campagna ora è sulla rete e in pausa. Chiama set_ad_network_status con "status": "active" per avviarla.

curl -s https://xuda.ai/cpi/get_ad_campaign_report \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","data":{"app_id":"YOUR_CAMPAIGN_APP_ID","days":7}}'
const res = await fetch('https://xuda.ai/cpi/get_ad_campaign_report', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', data: { app_id: 'YOUR_CAMPAIGN_APP_ID', days: 7 } }),
});
const { data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_ad_campaign_report',
    json={'api_key': 'YOUR_API_KEY', 'data': {'app_id': 'YOUR_CAMPAIGN_APP_ID', 'days': 7}},
)

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.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026