Riferimento per gli strumenti del server MCP Adobe Target target-mcp-tools-reference

Strumento: list_target_activities

Elencare Adobe Target attività con filtro e ordinamento lato server.

Recupera un elenco impaginato di attività. Tutti i filtri vengono applicati lato server dall’API di amministrazione Target. Il server restituisce un massimo di 200 attività per pagina.

Restituisce: oggetto JSON con activities (elenco di oggetti inclusi id, name, state, type, priority, modifiedAt, startsAt, endsAt) e total (il conteggio totale potrebbe superare le dimensioni di pagina restituite).

Prompt di esempio: “Elenca tutti i test A/B attivi ordinati in base all’ultima modifica.”

Strumento: get_activity

Ottieni informazioni dettagliate su un’attività di qualsiasi tipo.

Recupera la configurazione completa di un’attività specifica, rilevando automaticamente il tipo di attività. Supporta le attività Test A/B, Targeting esperienza, Automated Personalization, Allocazione automatica, Test multivariato e Consigli.

Restituisce: Dettagli completi dell’attività, inclusi metadati (nome, stato, priorità, date), esperienze, posizioni e offerte, obiettivi e metriche e regole di targeting.

Prompt di esempio: “Ottieni dettagli per 12345 attività”.

Strumento: create_ab_activity

Crea una nuova attività di test A/B.

Crea un nuovo test A/B con la configurazione specificata, incluse esperienze, offerte e targeting.

Restituisce: l’oggetto attività creato con il relativo ID assegnato.

Esempio di prompt: “Crea un test A/B denominato ‘Test Hero della homepage’ con due esperienze che testano diverse immagini hero sulla mbox homepage-hero.”

Strumento: create_xt_activity

Crea una nuova attività Targeting esperienza.

Crea un’attività Targeting esperienza che fornisce esperienze diverse a tipi di pubblico diversi in base a regole di targeting.

Restituisce: l’oggetto attività creato con il relativo ID assegnato.

Esempio di richiesta: “Crea un’attività Targeting esperienze denominata ‘Geo Personalization’ che mostra contenuti diversi a visitatori da aree geografiche diverse.”

Strumento: update_activity

Aggiorna un test A/B, un targeting delle esperienze o un’attività Automated Personalization esistente.

Utilizza un pattern di lettura-modifica-scrittura: recupera lo stato corrente, unisce le modifiche, convalida e invia l’aggiornamento. Supporta le attività Test A/B, Targeting esperienza e Automated Personalization; le attività Allocazione automatica, Test multivariato e Consigli sono di sola lettura. I parametri strutturati goal, audience_ids e additional_metrics sono supportati solo per test A/B e Targeting esperienza; le attività di Automated Personalization accettano semplici aggiornamenti di unione campi.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “12345 attività di aggiornamento per modificare l’allocazione del traffico in 70/30”.

Strumento: update_activity_schedule

Aggiorna le date di inizio e fine dell’attività.

Aggiorna la pianificazione di un’attività senza modificare altre impostazioni.

Restituisce: conferma dell’aggiornamento della pianificazione.

Prompt di esempio: “Aggiornare la pianificazione dell’attività A/B 12345 eseguire dal 1° maggio al 31 maggio.”

Strumento: update_activity_state

Modifica lo stato dell’attività (attivazione, disattivazione o pausa).

Restituisce: lo stato dell’attività aggiornato.

Prompt di esempio: “Attiva 12345 attività” o “Sospendi test principale homepage”.

Strumento: update_activity_name

Rinominare un’attività.

Aggiorna solo il nome senza modificare la configurazione completa.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Rinominare l’attività 12345 a ‘Test eroe della campagna estiva’.”

Strumento: update_activity_priority

Modifica la priorità dell’attività.

Le attività con priorità più alta hanno la precedenza quando più attività sono indirizzate alla stessa posizione.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Imposta la priorità dell’attività 12345 su 100”.

Strumento: add_activity_variant

Aggiungi una nuova esperienza/variante a un’attività.

Gestisce tutto il coordinamento strutturale, inclusa la creazione di opzioni, la mappatura alle posizioni e il ribilanciamento del traffico.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Aggiungere una nuova variante denominata “Tema festività” all’attività A/B 12345 utilizzando il 67890 di offerta.”

Strumento: update_traffic_split

Aggiorna l’allocazione del traffico tra le varianti.

La somma delle percentuali deve essere esattamente 100.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Cambia la suddivisione del traffico per il 12345 attività in Controllo al 70% e Variante A al 30%.”

Strumento: update_variant_offer

Modifica l’offerta per una variante specifica.

Funziona sia per le attività basate su moduli (utilizzando offer_id) che per le attività VEC (utilizzando modifications).

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Aggiornare l’esperienza ‘Variante A’ in 12345 attività per utilizzare il 99999 delle offerte.”

Strumento: remove_activity_variant

Rimuovi un’esperienza/variante da un’attività.

Rimuove l’esperienza, ripulisce le opzioni orfane e riequilibra il traffico in modo uniforme tra le varianti rimanenti.

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Rimuovere l’esperienza ‘Variante test’ dal 12345 attività A/B.”

Strumento: list_target_offers

Elencare tutte le offerte nel tenant Target.

Recupera un elenco impaginato di offerte di contenuti con filtro opzionale.

Restituisce: oggetto JSON con offers (elenco di oggetti inclusi id, name, type, content, modifiedAt) e total.

Prompt di esempio: “Elenca tutte le offerte JSON”.

Strumento: get_target_offer

Informazioni dettagliate su un’offerta specifica.

Restituisce: dettagli completi dell’offerta, inclusi id, name, type, content, workspace e modifiedAt.

Prompt di esempio: “Ottieni dettagli per 67890 offerte”.

Strumento: create_target_offer

Crea una nuova offerta di contenuti HTML.

Restituisce: l’offerta creata con il relativo ID assegnato.

Prompt di esempio: “Creare un’offerta HTML denominata ‘Banner di vendita estivo’ con un banner promozionale.”

Strumento: create_target_json_offer

Crea una nuova offerta JSON per la distribuzione di dati strutturati.

Restituisce: l’offerta creata con il relativo ID assegnato.

Prompt di esempio: “Creare un’offerta JSON denominata ‘Configurazione flag di funzionalità’ con le impostazioni di attivazione/disattivazione della funzionalità.”

Strumento: update_target_offer

Aggiornare un’offerta esistente.

Restituisce: L’oggetto offerta aggiornato.

Prompt di esempio: “Aggiorna 67890 di offerta con nuovi contenuti promozionali”.

Strumento: list_target_audiences

Elenca tutti i tipi di pubblico nel tenant Target.

Restituisce: oggetto JSON con audiences (elenco di oggetti inclusi id, name, description, origin, modifiedAt) e total.

Esempio di prompt: “Elenca tutti i tipi di pubblico”.

Strumento: get_target_audience

Ottieni i dettagli del pubblico, incluse le regole di targeting.

Recupera la configurazione completa di un pubblico specifico, incluse le relative regole e condizioni di targeting.

Restituisce: dettagli completi sul pubblico, inclusi id, name, description, origin, regole di targeting e conteggio attività associato.

Prompt di esempio: “Ottieni i dettagli per l’12345 del pubblico e mostrami le relative regole di targeting.”

Strumento: create_target_audience

Crea un nuovo pubblico con regole di targeting.

Restituisce: il pubblico creato con il relativo ID assegnato.

Esempio di prompt: “Crea un pubblico denominato “Visitatori mobili dalla California” destinato agli utenti mobili in CA.”

Strumento: list_target_mboxes

Elencare tutte le mbox nel tenant Target.

Restituisce: oggetto JSON con mboxes (elenco di oggetti inclusi name, status, lastRequestTime) e total.

Prompt di esempio: “Elenca tutte le mbox contenenti ‘homepage’.”

Strumento: get_target_mbox

Ottieni informazioni dettagliate su una mbox specifica.

Restituisce: dettagli Mbox inclusi name, status ed elenco di attività che utilizzano Mbox.

Prompt di esempio: “Ottieni dettagli per mbox ‘homepage-hero’.”

Strumento: list_target_mbox_profile_attributes

Elenca tutti gli attributi di profilo mbox disponibili per il targeting.

Nessun parametro richiesto.

Restituisce: array JSON di oggetti attributo profilo.

Esempio di prompt: “Quali attributi di profilo sono disponibili per il targeting?”

Strumento: list_target_properties

Elenca tutte le proprietà nel tenant Target.

Le proprietà organizzano le attività e controllano l’accesso.

Nessun parametro richiesto.

Restituisce: Elenco di oggetti proprietà, inclusi id, name, description e channel.

Prompt di esempio: “Elenca tutte le proprietà di Target”.

Strumento: get_activity_performance_report

Ottieni un rapporto sulle prestazioni per un’attività di qualsiasi tipo.

Recupera i tassi di conversione, l’incremento e i livelli di affidabilità. Supporta le attività Test A/B, Targeting esperienza, Automated Personalization, Allocazione automatica, Test multivariato e Consigli.

Restituisce: metriche a livello di esperienza (visitatori, conversioni, tasso di conversione), calcoli di incremento, livelli di affidabilità statistica e metriche dei ricavi (se configurate).

Prompt di esempio: “Visualizza il report delle prestazioni per le 12345 dell’attività negli ultimi 30 giorni.”

Strumento: get_activity_orders_report

Ottieni un rapporto ordini/ricavi per un’attività di qualsiasi tipo.

Supporta le attività Test A/B, Targeting esperienza, Automated Personalization, Allocazione automatica, Test multivariato e Consigli.

Restituisce: i conteggi, le entrate e il valore medio dell’ordine in base all’esperienza.

Prompt di esempio: “Ottieni il report ordini per 12345 attività”.

Strumento: get_activity_report_by_name

Cerca un’attività per nome e ottieni il relativo rapporto sulle prestazioni.

Utile quando conosci il nome dell’attività ma non il relativo ID.

Restituisce: Dettagli attività e metriche delle prestazioni.

Prompt di esempio: “Ottieni il report sulle prestazioni per l’attività ‘Homepage Hero Test’.”

Strumento: get_a4t_report

Recupera un report Analytics for Target (A4T) per un’attività Target.

Convalida la configurazione A4T per l’attività, quindi esegue query GraphQL su Adobe Analytics per recuperare le metriche lato Analytics. Disponibile solo per le attività con reporting A4T configurato.

Restituisce: metriche lato Analytics per l’attività, inclusi conteggi di visitatori, conversioni, ricavi e incremento in base all’esperienza, originati direttamente da Adobe Analytics.

Prompt di esempio: “Recupera il rapporto A4T per il test di ottimizzazione dell’estrazione e riepiloga i dati di conversione lato Analytics.”

Strumento: preview_activity

Genera URL di anteprima Controllo di qualità del browser per un’attività Target.

Crea collegamenti di anteprima cliccabili che forzano la visualizzazione di esperienze specifiche, ignorando le regole di targeting del pubblico. Funziona per attività A/B, XT e Automated Personalization.

Restituisce: informazioni sull’attività (nome, tipo, stato), URL di anteprima per ogni esperienza e nomi e indici di esperienza.

Esempio di prompt: “Genera URL di anteprima per 12345 attività in modo che sia possibile testare ogni esperienza nel browser.”

Strumento: list_target_response_tokens

Elenca tutti i token di risposta nel tenant Target.

Recupera tutti i token di risposta configurati, sia incorporati che personalizzati.

Nessun parametro richiesto.

Restituisce: array JSON di oggetti token di risposta con stato name, type e enabled.

Prompt di esempio: “Elenca tutti i token di risposta.”

Strumento: create_target_response_token

Crea un nuovo token di risposta personalizzato per la raccolta di dati aggiuntivi nelle risposte Target.

Restituisce: L’oggetto token di risposta creato.

Esempio di prompt: “Creare un token di risposta personalizzato denominato ‘campaign_id’ di tipo ACTIVITY.”

Strumento: get_target_revisions

Ottiene il registro di controllo per un tipo di risorsa.

Recupera le modifiche apportate alle risorse Target con filtro facoltativo per autore.

Restituisce: la cronologia delle revisioni con marche temporali, utenti e descrizioni delle modifiche.

Prompt di esempio: “Visualizza il registro di controllo per le modifiche delle attività”.

Strumento: get_target_entity_revisions

Ottieni tutte le revisioni di un’entità specifica per ID.

Restituisce: array JSON di tutte le revisioni per l’entità specificata.

Prompt di esempio: “Mostra tutte le modifiche apportate al 12345 attività”.

Strumento: list_target_templates

Elencare le risorse MCP disponibili e i modelli per la creazione di attività e offerte.

Nessun parametro richiesto.

Restituisce: oggetto JSON in cui sono elencati i modelli e le risorse disponibili.

Esempio di prompt: “Quali modelli sono disponibili per la creazione di attività?”

Strumenti: list_target_criteria, get_target_criteria, list_target_criteria_by_type, get_target_criteria_by_type, create_target_criteria, update_target_criteria

I criteri sono regole che determinano gli elementi da consigliare, in base a un set predeterminato di comportamenti dei visitatori. I criteri sono raggruppati in 9 famiglie digitate: category, custom, item, cart, popularity, profileattribute, recent, sequence, userhistory.

list_target_criteria e get_target_criteria restituiscono metadati minimi di criteri per più famiglie (id, name, criteriaTitle, criteriaGroup). Utilizza list_target_criteria_by_type / get_target_criteria_by_type (o create_target_criteria / update_target_criteria) con un criteria_type per lavorare con la configurazione completa specifica per il tipo. I requisiti dei campi sono diversi a seconda della famiglia. Per informazioni sullo schema completo per tipo, vedere Adobe Riferimento API per i consigli.

Restituisce: l’oggetto criteri o un elenco impaginato con offset, limit, total e list.

Esempio di prompt: “Elenca tutti i criteri di Recommendations configurati in questo account e riepiloga i tipi di algoritmo in uso.”

Strumenti: list_target_collections, get_target_collection, create_target_collection, update_target_collection

Le raccolte raggruppano le entità catalogo in base alle regole di corrispondenza, per l’utilizzo in criteri e promozioni.

Restituisce: l’oggetto della raccolta, inclusi id, name, description, rules e i metadati dell’ultima modifica.

Esempio di prompt: “Quali raccolte sono disponibili e su quali attributi di catalogo filtrano?”

Strumenti: list_target_designs, get_target_design, create_target_design, update_target_design

Le progettazioni sono modelli Velocity o HTML che controllano il rendering delle entità consigliate.

Restituisce: l’oggetto di progettazione, inclusi id, name, script e type.

Prompt di esempio: “Quali progetti e raccolte ho configurato per Recommendations?”

Strumenti: list_target_promotions, get_target_promotion, create_target_promotion, update_target_promotion

Le promozioni forzano entità specifiche nei risultati dei consigli, dando la precedenza sui criteri e i consigli di backup.

Restituisce: L’oggetto della promozione.

Prompt di esempio: “Creare una promozione esterna che includa la raccolta ‘Backpacking Tents’ fino alla fine di agosto.”

Strumenti: list_target_exclusions, get_target_exclusion, create_target_exclusion, update_target_exclusion

Le esclusioni rimuovono le entità corrispondenti dai risultati dei consigli. Le esclusioni si applicano a livello di account, in tutti i criteri e le attività.

Restituisce: l’oggetto di esclusione.

Esempio di richiesta: “Sono attualmente configurate esclusioni a livello di account e su cosa si filtrano?”

Strumenti: get_target_entity, search_target_catalog

Strumenti di sola lettura per l’ispezione del catalogo di prodotti/contenuti Consigli. Non è disponibile alcuno strumento di creazione, aggiornamento o eliminazione per le entità catalogo tramite il server MCP.

Restituisce: get_target_entity restituisce gli attributi del catalogo dell’entità. search_target_catalog restituisce corrispondenze in un array entities. I nomi dei campi in query devono essere attributi di catalogo reali configurati per il tenant.

Prompt di esempio: “Cerca nel catalogo prodotti con inventario inferiore a 1000”.