DocumentazioneTargetGuida di Target

[Beta]{class="badge informative"}

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

Ultimo aggiornamento: 22 aprile 2026

Creato per:

  • Intermediate
  • Experienced
  • Developer
  • User
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 di sola lettura 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 i 23 strumenti di sola lettura
NOTE
Gli strumenti di scrittura (creazione, aggiornamento, attivazione, disattivazione) non sono esposti tramite il catalogo MCP pubblico in Public Beta. Tutti i 23 strumenti elencati in questa pagina sono di sola lettura. L’accesso in scrittura sarà disponibile in una versione futura.

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

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

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

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

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 Sì 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 Sì Tipo di risorsa: activity, offer o audience
entity_id numero intero Sì 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à
4
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity
Offerta
2
list_target_offers, get_target_offer
Pubblico
2
list_target_audiences, get_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
1
list_target_response_tokens
Revisione
2
get_target_revisions, get_target_entity_revisions
Modello
1
list_target_templates
Totale
23
recommendation-more-help
target-help-main