[Beta]{class="badge informative"}
Riferimento per gli strumenti del server MCP Adobe Target target-mcp-tools-reference
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.
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
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.”
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”.
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.”
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”.
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 | Sì | 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 | Sì | Elenco delle configurazioni esperienza |
locations |
array | Sì | 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.”
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 | Sì | 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 | Sì | Elenco di configurazioni di esperienza con mappature pubblico |
locations |
array | Sì | 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.”
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 | Sì | Identificatore univoco dell’attività da aggiornare |
activity |
oggetto | Sì | 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”.
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 | Sì | Identificatore univoco dell’attività XT da aggiornare |
activity |
oggetto | Sì | 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.”
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 | Sì | Identificatore univoco dell’attività AP da aggiornare |
activity |
oggetto | Sì | Campi da aggiornare |
Restituisce: l’oggetto attività aggiornato.
Prompt di esempio: “Aggiorna 12345 attività di Auto-Personalization per modificare l’obiettivo di ottimizzazione.”
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 | Sì | Identificatore univoco dell’attività |
activity_type |
stringa | Sì | 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.”
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 | Sì | Identificatore univoco dell’attività |
state |
stringa | Sì | 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”.
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 | Sì | Identificatore univoco dell’attività |
name |
stringa | Sì | Nome nuova attività |
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.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parametro | Tipo | Obbligatorio | Descrizione |
activity_id |
numero intero | Sì | Identificatore univoco dell’attività |
priority |
numero intero | Sì | 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”.
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 | Sì | ID dell’attività da modificare |
activity_type |
stringa | Sì | Tipo di attività: ab, xt o abt |
variant_name |
stringa | Sì | 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.”
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 | Sì | ID dell’attività da modificare |
activity_type |
stringa | Sì | Tipo di attività: ab o abt (XT non supportato — con targeting di pubblico) |
splits |
oggetto | Sì | 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%.”
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 | Sì | ID dell’attività da modificare |
activity_type |
stringa | Sì | Tipo di attività: ab, xt o abt |
variant_name |
stringa | Sì | 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.”
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 | Sì | ID dell’attività da modificare |
activity_type |
stringa | Sì | Tipo di attività: ab, xt o abt |
variant_name |
stringa | Sì | 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
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”.
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”.
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 | Sì | Nome dell’offerta |
content |
stringa | Sì | 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.”
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 | Sì | Nome dell’offerta |
content |
oggetto | Sì | 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à.”
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 | Sì | 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
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”.
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.”
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 | Sì | 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
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’.”
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’.”
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
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
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.”
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à”.
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.”
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”.
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’.”
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
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
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.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parametro | Tipo | Obbligatorio | Descrizione |
token_name |
stringa | Sì | Nome del token di risposta |
token_type |
stringa | Sì | 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
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à”.
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
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
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_variantlist_target_offers, get_target_offer, create_target_offer, create_target_json_offer, update_target_offerlist_target_audiences, get_target_audience, create_target_audiencelist_target_mboxes, get_target_mbox, list_target_mbox_profile_attributeslist_target_propertiesget_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_reportpreview_activitylist_target_response_tokens, create_target_response_tokenget_target_revisions, get_target_entity_revisionslist_target_templates