Vai al contenuto principale

1. Cos'è HilltopAds MCP e cosa puoi fare con esso

Gestisci il tuo account HilltopAds direttamente dalla chat: chiedi informazioni sul saldo, sulle campagne, sulle zone e sulle statistiche utilizzando un linguaggio naturale. Questa guida ti mostra, passo dopo passo, come collegare il connettore HilltopAds

Scritto da HilltopAds

Che cos'è HilltopAds MCP?

Il server MCP (Model Context Protocol) è un connettore ufficiale di HilltopAds per i client di intelligenza artificiale. Una volta connesso, l'IA può accedere ai dati del tuo account e, con la tua autorizzazione, apportare modifiche, ad esempio creare o aggiornare campagne, attraverso un canale dedicato e sicuro, senza che tu debba copiare e incollare manualmente i dati.

Le tue credenziali di accesso non vengono mai condivise con il client IA. L'autorizzazione avviene tramite una chiave API che puoi generare direttamente dal tuo account.

Il connettore espone il tuo account HilltopAds tramite una serie di strumenti (Tools). L'IA seleziona automaticamente lo strumento più adatto alla tua richiesta, lo esegue e trasforma il risultato in una risposta facile da leggere, come una tabella, un riepilogo o persino un grafico.

Cosa puoi fare con esso?

Gli strumenti disponibili si dividono in due categorie:

Operazioni di lettura (Read Operations): recuperano dati come saldo, inventario, statistiche, dettagli di una singola campagna o gli elenchi delle sorgenti di traffico associati a una campagna.

\Operazioni di modifica (Action Operations): apportano modifiche al tuo account, ad esempio creando o aggiornando campagne, avviandole o interrompendole, modificando le offerte (Bid), gli URL di destinazione e gestendo blacklist e whitelist delle sorgenti di traffico.

Gli strumenti disponibili dipendono dal tipo di account: Inserzionista (Advertiser), Publisher oppure entrambi. Attualmente il connettore supporta 27 operazioni: 23 per gli inserzionisti e 4 per i publisher.

Le operazioni di modifica vengono eseguite solo dopo la tua approvazione. I client IA identificano gli strumenti come sola lettura oppure scrittura/eliminazione e richiedono la tua conferma prima di apportare qualsiasi modifica.

Strumenti per account e reportistica

Strumento

Funzione

advertiser_get_balance

Mostra il saldo attuale dell'account inserzionista.

advertiser_list_inventory

Visualizza le tue campagne e i relativi annunci.

advertiser_get_stats

Mostra statistiche filtrate o raggruppate per data, zona, GEO, campagna, sistema operativo, ora o sorgente di traffico.

advertiser_get_campaign

Visualizza tutti i dettagli di una campagna specifica tramite il suo ID.

Strumenti di gestione delle campagne

Nota: Negli esempi riportati più avanti in questa guida, l'assistente crea ogni campagna nello stato Inattiva, così puoi verificarla prima che inizi a spendere budget. Si tratta di un comportamento predefinito scelto dall'assistente, non di una regola fissa. Se desideri che una campagna venga creata inattiva (oppure avviata immediatamente), specificalo chiaramente nella tua richiesta.

Strumento

Funzione

advertiser_create_campaign

Crea una nuova campagna.

advertiser_update_campaign

Aggiorna parzialmente le impostazioni di una campagna.

advertiser_start_campaign

Attiva una campagna approvata.

advertiser_stop_campaign

Disattiva una campagna attiva.

advertiser_archive_campaign

Archivia una campagna.

advertiser_unarchive_campaign

Ripristina una campagna dall'archivio.

advertiser_set_bid

Modifica l'offerta (Bid) per il Wildcard GEO.

advertiser_set_destination_url

Modifica l'URL di destinazione di una campagna Popunder.

advertiser_replace_domain

Sostituisce un dominio in tutti gli annunci dell'account inserzionista.

Strumenti per la blacklist delle sorgenti di traffico

Strumento

Funzione

advertiser_get_blacklist

Visualizza la blacklist delle sorgenti di una campagna.

advertiser_add_to_blacklist

Aggiunge sorgenti alla blacklist.

advertiser_remove_from_blacklist

Rimuove sorgenti dalla blacklist.

advertiser_clear_campaign_blacklist

Svuota la blacklist di una campagna.

advertiser_set_blacklist

Sostituisce l'intera blacklist e imposta la campagna in modalità BLACKLIST.

Strumenti per la whitelist delle sorgenti di traffico

Strumento

Funzione

advertiser_get_whitelist

Visualizza la whitelist delle sorgenti di una campagna.

advertiser_add_to_whitelist

Aggiunge sorgenti alla whitelist.

advertiser_remove_from_whitelist

Rimuove sorgenti dalla whitelist.

advertiser_clear_campaign_whitelist

Svuota la whitelist di una campagna.

advertiser_set_whitelist

Sostituisce l'intera whitelist e imposta la campagna in modalità WHITELIST.

Hai ricevuto la risposta alla tua domanda?