[Beta]{class="badge informative"}

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

AVAILABILITY
Il server MCP Adobe Target è disponibile per tutti i clienti in Beta pubblico. Attualmente è supportato in Claude Web, Claude Desktop, Claude Code, Cursor e ChatGPT.

Questa pagina è un riferimento completo per tutti gli strumenti esposti dal server MCP Adobe Target. Per ogni strumento troverai una descrizione, i dettagli dei parametri, il valore restituito e un esempio di prompt in linguaggio naturale. Per le istruzioni di installazione e i casi di utilizzo, vedere Introduzione e Casi di utilizzo e procedure dettagliate.

IMPORTANT
Il Model Context Protocol (MCP) è uno standard open source emergente e può presentare rischi per la sicurezza o l'affidabilità. Le integrazioni server MCP di Adobe e la relativa documentazione vengono fornite "così come sono", senza garanzie di alcun tipo.
La connessione di client o server MCP ai prodotti Adobe è una configurazione scelta dal cliente e i clienti sono responsabili della valutazione della sicurezza e dell’idoneità di qualsiasi integrazione MCP. Adobe non è responsabile dei problemi derivanti da configurazione errata, utilizzo errato di MCP, vulnerabilità in implementazioni di terze parti o azioni non intenzionali eseguite tramite flussi di lavoro abilitati per MCP.
Per ridurre i rischi, Adobe incoraggia a testare le integrazioni in un ambiente sandbox prima di utilizzarle in modo produttivo e a rivedere e convalidare attentamente tutte le azioni e le risposte avviate da MCP prima di confermarle o di fare affidamento su di esse.

Prerequisiti tools-prerequisites

Il tuo ruolo Adobe Target determina quali strumenti sono disponibili:

  • Ruolo osservatore o superiore: accesso a tutti gli strumenti di sola lettura
  • Ruolo Editor o superiore: accesso a strumenti di lettura e strumenti di scrittura (creazione, aggiornamento)
  • Ruolo Approvatore: accesso a tutti gli strumenti, inclusi attivazione e disattivazione

Per istruzioni complete sull’installazione, vedere Introduzione.

Strumenti di attività tools-activities

Elencare attività

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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4
Parametro Tipo Obbligatorio Descrizione
limit numero intero No Numero massimo di attività da restituire (server max: 200)
offset numero intero No Numero di attività da saltare per l’impaginazione
sort_by stringa No Campo in base al quale eseguire l’ordinamento. Prefisso con - per ordine decrescente (ad esempio, -modifiedAt). Opzioni: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId
state stringa No Filtra per stato attività: approved (live/active), deactivated (inactive), paused, saved (draft)
activity_type stringa No Filtra per tipo: ab (test A/B), xt (targeting esperienza), abt (Automated Personalization)
name_contains stringa No Filtra le attività il cui nome contiene questa stringa (senza distinzione maiuscole/minuscole)
starts_after stringa No Data ISO 8601 — attività che iniziano dopo tale data
starts_before stringa No Data ISO 8601 — attività che hanno inizio prima di tale data
modified_after stringa No Data ISO 8601 — Attività modificate dopo tale data
ends_after stringa No Data ISO 8601 — attività che terminano dopo tale data
ends_before stringa No Data ISO 8601 — attività che terminano prima di tale data
workspace stringa No Filtra per ID area di lavoro
segment_id stringa No Filtra per ID segmento di pubblico
profile_attribute_id stringa No Filtra per ID attributo profilo
priority numero intero No Filtra per valore di priorità esatto (0-999)
mbox stringa No Filtra per nome mbox/posizione
offer_id stringa No Filtra per ID offerta
view_id stringa No Filtra per ID visualizzazione SPA

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

Ottenere un’attività A/B

Strumento: get_ab_activity

Ottieni informazioni dettagliate su un’attività A/B.

Recupera la configurazione completa di un test A/B specifico, incluse esperienze, posizioni, metriche e regole di targeting.

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività A/B

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à A/B”.

Ottenere un’attività Targeting esperienze

Strumento: get_xt_activity

Ottieni informazioni dettagliate su un’attività Targeting esperienza.

Recupera la configurazione completa di una specifica attività XT, incluse le mappature esperienza-pubblico, le posizioni e le metriche.

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività XT

Restituisce: dettagli completi sull’attività, inclusi metadati, esperienze con mappature di pubblico, posizioni e offerte, obiettivi e metriche.

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

Ottenere un’attività Automated Personalization

Strumento: get_abt_activity

Ottieni informazioni dettagliate su un’attività di Automated Personalization (AP).

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività di Personalizzazione automatizzata

Restituisce: Dettagli completi dell’attività, inclusi metadati, esperienze, posizioni e impostazioni algoritmiche.

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

Creare un’attività A/B

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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4
Parametro Tipo Obbligatorio Descrizione
name stringa Nome dell’attività
state stringa No Stato iniziale: approved, deactivated o saved (impostazione predefinita: saved)
priority numero intero No Priorità attività (0-999, impostazione predefinita: 0)
starts_at stringa No Data di inizio attività (ISO 8601)
ends_at stringa No Data di fine attività (ISO 8601)
experiences array Elenco delle configurazioni esperienza
locations array Elenco configurazioni posizione/mbox
goals oggetto No Metriche dell’obiettivo primario e secondario
audiences array No Configurazioni del pubblico di destinazione
workspace_id stringa No ID Workspace per l’attività

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

Creare un’attività Targeting esperienze

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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4
Parametro Tipo Obbligatorio Descrizione
name stringa Nome dell’attività
state stringa No Stato iniziale: approved, deactivated o saved (impostazione predefinita: saved)
priority numero intero No Priorità attività (0-999, impostazione predefinita: 0)
starts_at stringa No Data di inizio attività (ISO 8601)
ends_at stringa No Data di fine attività (ISO 8601)
experiences array Elenco di configurazioni di esperienza con mappature pubblico
locations array Elenco configurazioni posizione/mbox
goals oggetto No Metriche dell’obiettivo primario e secondario
workspace_id stringa No ID Workspace per l’attività

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

Aggiornare un’attività A/B

Strumento: update_ab_activity

Aggiornare un’attività A/B esistente.

Utilizza un pattern di lettura-modifica-scrittura: recupera lo stato corrente, unisce le modifiche, convalida e invia l’aggiornamento.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività da aggiornare
activity oggetto Campi da aggiornare (nome, priorità, esperienze, posizioni, obiettivi, ecc.)

Restituisce: l’oggetto attività aggiornato.

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

Aggiornare un’attività Targeting esperienze

Strumento: update_xt_activity

Aggiorna un’attività Targeting esperienza esistente.

Utilizza un pattern di lettura-modifica-scrittura.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività XT da aggiornare
activity oggetto Campi da aggiornare

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Aggiorna l’attività Targeting esperienza 12345 aggiungere una nuova esperienza per i visitatori di dispositivi mobili.”

Aggiornare un’attività di Automated Personalization

Strumento: update_abt_activity

Aggiorna un’attività Automated Personalization esistente.

Utilizza un pattern di lettura-modifica-scrittura.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività AP da aggiornare
activity oggetto Campi da aggiornare

Restituisce: l’oggetto attività aggiornato.

Prompt di esempio: “Aggiorna 12345 attività di Auto-Personalization per modificare l’obiettivo di ottimizzazione.”

Aggiorna pianificazione attività

Strumento: update_activity_schedule

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

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

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività
activity_type stringa Tipo di attività: ab, xt o abt
starts_at stringa No Nuova data di inizio (ISO 8601)
ends_at stringa No Nuova data di fine (ISO 8601)

Restituisce: conferma dell’aggiornamento della pianificazione.

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

Cambia stato attività

Strumento: update_activity_state

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

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività
state stringa Nuovo stato: approved (live/active), deactivated (inactive), paused o saved (draft)

Restituisce: lo stato dell’attività aggiornato.

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

Rinominare un’attività

Strumento: update_activity_name

Rinominare un’attività.

Aggiorna solo il nome senza modificare la configurazione completa.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività
name stringa Nome nuova attività

Restituisce: l’oggetto attività aggiornato.

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

Cambia priorità attività

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.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività
priority numero intero Nuovo valore di priorità (0-999; più alto = priorità più alta)

Restituisce: l’oggetto attività aggiornato.

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

Aggiungere una variante a un’attività

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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero ID dell’attività da modificare
activity_type stringa Tipo di attività: ab, xt o abt
variant_name stringa Nome della nuova esperienza/variante
offer_id numero intero No (Basato su modulo) ID offerta esistente da utilizzare
offer_content stringa No Contenuto HTML (basato su modulo) per una nuova offerta in linea
traffic_percentage numero intero No % traffico per la nuova variante (1-99). Se omesso, il traffico viene riequilibrato in modo uniforme
audience_id numero intero No ID pubblico per la variante (attività XT)
modifications array No (VEC) Elenco di modifiche basate su selettori CSS

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

Aggiorna suddivisione traffico

Strumento: update_traffic_split

Aggiorna l’allocazione del traffico tra le varianti.

La somma delle percentuali deve essere esattamente 100.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero ID dell’attività da modificare
activity_type stringa Tipo di attività: ab o abt (XT non supportato — con targeting di pubblico)
splits oggetto Mappatura del dizionario del nome dell’esperienza in percentuale. Deve includere tutte le esperienze e sommare a 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%.”

Modificare l’offerta di una variante

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

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero ID dell’attività da modificare
activity_type stringa Tipo di attività: ab, xt o abt
variant_name stringa Nome dell’esperienza/variante da aggiornare
offer_id numero intero No (Basato su modulo) Nuovo ID offerta
offer_content stringa No Contenuto HTML (basato su modulo) per una nuova offerta in linea
modifications array No (VEC) Nuovo elenco di modifiche basate su selettori CSS

Restituisce: l’oggetto attività aggiornato.

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

Rimuovere una variante da un’attività

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.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero ID dell’attività da modificare
activity_type stringa Tipo di attività: ab, xt o abt
variant_name stringa Nome dell’esperienza/variante da rimuovere

Restituisce: l’oggetto attività aggiornato.

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

Strumenti di offerta tools-offers

Elencare offerte

Strumento: list_target_offers

Elencare tutte le offerte nel tenant Target.

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

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parametro Tipo Obbligatorio Descrizione
limit numero intero No Numero massimo di offerte da restituire
offset numero intero No Numero di offerte da saltare per l’impaginazione
type stringa No Filtra per tipo di offerta: content (HTML), json o redirect
name stringa No Filtra per nome dell’offerta (corrispondenza parziale)

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

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

Ottieni un’offerta

Strumento: get_target_offer

Informazioni dettagliate su un’offerta specifica.

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
offer_id numero intero Identificatore univoco dell’offerta

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

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

Creare un’offerta HTML

Strumento: create_target_offer

Crea una nuova offerta di contenuti HTML.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
name stringa Nome dell’offerta
content stringa HTML o contenuto di testo per l’offerta
workspace_id stringa No Workspace ID per l’offerta

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

Creare un’offerta JSON

Strumento: create_target_json_offer

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

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
name stringa Nome dell’offerta
content oggetto Contenuto JSON per l’offerta
workspace_id stringa No Workspace ID per l’offerta

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à.”

Aggiornare un’offerta

Strumento: update_target_offer

Aggiornare un’offerta esistente.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
offer_id numero intero Identificatore univoco dell’offerta da aggiornare
name stringa No Nome offerta aggiornato
content stringa o oggetto No Contenuto dell’offerta aggiornato

Restituisce: L’oggetto offerta aggiornato.

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

Strumenti per il pubblico tools-audiences

Elencare tipi di pubblico

Strumento: list_target_audiences

Elenca tutti i tipi di pubblico nel tenant Target.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
limit numero intero No Numero massimo di tipi di pubblico da restituire
offset numero intero No Numero di tipi di pubblico da saltare per l’impaginazione

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

Ottenere un 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.

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
audience_id numero intero Identificatore univoco del pubblico

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

Creare un tipo di pubblico

Strumento: create_target_audience

Crea un nuovo pubblico con regole di targeting.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parametro Tipo Obbligatorio Descrizione
name stringa Nome del pubblico
description stringa No Descrizione del pubblico
targetRule oggetto No Regole di targeting (geo, browser, attributi personalizzati, ecc.)
workspace_id stringa No Workspace ID per il pubblico

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

Strumenti Mbox tools-mboxes

Mbox di elenco

Strumento: list_target_mboxes

Elencare tutte le mbox nel tenant Target.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parametro Tipo Obbligatorio Descrizione
limit numero intero No Numero massimo di mbox da restituire
offset numero intero No Numero di mbox da saltare per l’impaginazione
name stringa No Filtra per nome mbox (corrispondenza parziale)
status stringa No Filtra per stato

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

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

Ottieni una mbox

Strumento: get_target_mbox

Ottieni informazioni dettagliate su una mbox specifica.

table 0-row-4 1-row-4
Parametro Tipo Obbligatorio Descrizione
mbox_name stringa Nome della mbox

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

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

Attributi di profilo della mbox di elenco

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?”

Strumenti proprietà tools-properties

Proprietà elenco

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

Strumenti di reporting tools-reporting

Ottieni un rapporto sulle prestazioni A/B

Strumento: get_ab_performance_report

Ottieni un rapporto sulle prestazioni per un’attività A/B.

Recupera i tassi di conversione, l’incremento e i livelli di affidabilità.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività A/B
report_interval stringa No Periodo di tempo per il report (ad esempio last7days, last30days o un intervallo di date personalizzato)

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 i 12345 di test A/B negli ultimi 30 giorni.”

Ottieni un rapporto ordini A/B

Strumento: get_ab_orders_report

Ottieni un rapporto ordini/ricavi per un’attività A/B.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività A/B
report_interval stringa No Periodo di tempo per il rapporto

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à”.

Ottieni un rapporto sulle prestazioni di Targeting esperienza

Strumento: get_xt_performance_report

Ottieni un rapporto sulle prestazioni per un’attività Targeting esperienza.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività XT
report_interval stringa No Periodo di tempo per il rapporto

Restituisce: metriche delle prestazioni a livello di esperienza.

Prompt di esempio: “Mostra le prestazioni per la mia 54321 di attività Targeting esperienze.”

Ottieni un rapporto sugli ordini di targeting esperienza

Strumento: get_xt_orders_report

Ottieni un rapporto ordini/ricavi per un’attività Targeting esperienza.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività XT
report_interval stringa No Periodo di tempo per il rapporto

Restituisce: Ordina le metriche in base all’esperienza.

Prompt di esempio: “Ottieni dati di ordini per 54321 attività XT”.

Ottieni un rapporto sulle prestazioni per nome 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.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_name stringa Nome dell’attività da cercare
report_interval stringa No Periodo di tempo per il rapporto

Restituisce: Dettagli attività e metriche delle prestazioni.

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

Ottenere un rapporto Analytics for Target (A4T)

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.

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero Identificatore univoco dell’attività Target
report_interval stringa No Periodo di tempo per il report (ad esempio last7days, last30days o un intervallo di date personalizzato)

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

Strumenti di anteprima tools-preview

Visualizzare l’anteprima di un’attività

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.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parametro Tipo Obbligatorio Descrizione
activity_id numero intero L’ID attività Target da visualizzare in anteprima
experience_index numero intero No Indice delle esperienze basato su 0. Se omesso, restituisce gli URL per tutte le esperienze
url stringa No URL della pagina per l’anteprima. Obbligatorio per le attività basate su moduli. Per le attività del Compositore esperienza visivo, se fornito, sostituisce la posizione creata

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

Strumenti token di risposta tools-response-tokens

Elencare i token di risposta

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

Creare un token di risposta

Strumento: create_target_response_token

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

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
token_name stringa Nome del token di risposta
token_type stringa Tipo di token: SCRIPT, ACTIVITY, MBOX, GEO o CRS

Restituisce: L’oggetto token di risposta creato.

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

Strumenti di revisione tools-revisions

Ottieni il registro di audit

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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parametro Tipo Obbligatorio Descrizione
revision_resource_type stringa Tipo di risorsa: activity, offer o audience
modified_by stringa No Filtra per utente che ha apportato modifiche
limit numero intero No Numero massimo di revisioni da restituire
offset numero intero No Numero di revisioni da saltare per l’impaginazione

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à”.

Ottieni revisioni per un’entità specifica

Strumento: get_target_entity_revisions

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

table 0-row-4 1-row-4 2-row-4
Parametro Tipo Obbligatorio Descrizione
revision_resource_type stringa Tipo di risorsa: activity, offer o audience
entity_id numero intero Identificatore univoco dell’entità

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

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

Strumenti modello tools-templates

Elencare i modelli disponibili

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à?”

Riepilogo strumenti tools-summary

Categoria
Conteggio
Strumenti
Attività
17
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity, create_ab_activity, create_xt_activity, update_ab_activity, update_xt_activity, update_abt_activity, update_activity_schedule, update_activity_state, update_activity_name, update_activity_priority, add_activity_variant, update_traffic_split, update_variant_offer, remove_activity_variant
Offerta
5
list_target_offers, get_target_offer, create_target_offer, create_target_json_offer, update_target_offer
Pubblico
3
list_target_audiences, get_target_audience, create_target_audience
Mbox
3
list_target_mboxes, get_target_mbox, list_target_mbox_profile_attributes
Proprietà
1
list_target_properties
Generazione di rapporti
6
get_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_report
Anteprima
1
preview_activity
Token di risposta
2
list_target_response_tokens, create_target_response_token
Revisione
2
get_target_revisions, get_target_entity_revisions
Modello
1
list_target_templates
Totale
41
recommendation-more-help
target-help-main