[Beta]{class="badge informative"}
Referencia de herramientas del servidor MCP Adobe Target target-mcp-tools-reference
Esta página es una referencia completa para todas las herramientas de solo lectura expuestas por el servidor MCP Adobe Target. Para cada herramienta encontrará una descripción, detalles de parámetros, un valor devuelto y un ejemplo de petición de datos en lenguaje natural. Para obtener instrucciones de configuración y casos de uso, consulte Introducción y Casos de uso y tutoriales.
Requisitos previos tools-prerequisites
La función Adobe Target determina qué herramientas están disponibles para usted:
- Función de Observer o superior: acceso a las 23 herramientas de solo lectura
Para obtener instrucciones de configuración completas, consulte Introducción.
Herramientas de actividad tools-activities
Herramienta: list_target_activities
Enumerar Adobe Target actividades con filtrado y ordenación del lado del servidor.
Recupera una lista paginada de actividades. La API de administración de Target aplica todos los filtros del lado del servidor. El servidor devuelve un máximo de 200 actividades por página.
| 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 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
limit |
entero | No | Número máximo de actividades que se van a devolver (servidor máximo: 200) |
offset |
entero | No | Número de actividades que se omitirán para la paginación |
sort_by |
string | No | Campo por el que ordenar. Prefijo con - para orden descendente (por ejemplo, -modifiedAt). Opciones: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId |
state |
string | No | Filtrar por estado de actividad: approved (activo/activo), deactivated (inactivo), paused, saved (borrador) |
activity_type |
string | No | Filtrar por tipo: ab (prueba A/B), xt (segmentación de experiencias), abt (Automated Personalization) |
name_contains |
string | No | Filtrar actividades cuyo nombre contenga esta cadena (sin distinción de mayúsculas y minúsculas) |
starts_after |
string | No | Fecha ISO 8601 — actividades que comienzan después de esta fecha |
starts_before |
string | No | Fecha ISO 8601 — Actividades que comienzan antes de esta fecha |
modified_after |
string | No | Fecha ISO 8601 — Actividades modificadas después de esta fecha |
ends_after |
string | No | Fecha ISO 8601 — Actividades que finalizan después de esta fecha |
ends_before |
string | No | Fecha ISO 8601 — Actividades que finalizan antes de esta fecha |
workspace |
string | No | Filtrar por ID de Workspace |
segment_id |
string | No | Filtrar por ID de segmento de audiencia |
profile_attribute_id |
string | No | Filtrar por ID de atributo de perfil |
priority |
entero | No | Filtrar por valor de prioridad exacto (0-999) |
mbox |
string | No | Filtrar por nombre de mbox/ubicación |
offer_id |
string | No | Filtrar por ID de oferta |
view_id |
string | No | Filtrar por ID de vista de SPA |
Devuelve: objeto JSON con activities (lista de objetos que incluye id, name, state, type, priority, modifiedAt, startsAt, endsAt) y total (el recuento total puede superar el tamaño de página devuelto).
Mensaje de ejemplo: “Enumerar todas las pruebas A/B activas ordenadas por las últimas modificadas”.
Herramienta: get_ab_activity
Obtenga información detallada sobre una actividad A/B.
Recupera la configuración completa de una prueba A/B específica, incluidas experiencias, ubicaciones, métricas y reglas de segmentación.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad A/B |
Devuelve: detalles completos de la actividad, incluidos metadatos (nombre, estado, prioridad, fechas), experiencias, ubicaciones y ofertas, objetivos y métricas, y reglas de segmentación.
Mensaje de ejemplo: “Obtener detalles de la actividad A/B 12345.”
Herramienta: get_xt_activity
Obtenga información detallada sobre una actividad de segmentación de experiencias (XT).
Recupera la configuración completa de una actividad XT específica, incluidas las asignaciones, ubicaciones y métricas de experiencia de audiencia.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad XT |
Devuelve: detalles completos de la actividad, incluidos metadatos, experiencias con asignaciones de audiencia, ubicaciones y ofertas, y objetivos y métricas.
Mensaje de ejemplo: “Obtenga detalles para la actividad de segmentación de experiencias 12345”.
Herramienta: get_abt_activity
Obtenga información detallada sobre una actividad de Automated Personalization (AP).
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad AP |
Devuelve: detalles completos de la actividad, incluidos metadatos, experiencias, ubicaciones y configuración algorítmica.
Mensaje de ejemplo: “Obtener detalles de la 12345 de actividad de Auto-Personalization”.
Herramientas de oferta tools-offers
Herramienta: list_target_offers
Enumerar todas las ofertas de su inquilino Target.
Recupera una lista paginada de ofertas de contenido con filtrado opcional.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
limit |
entero | No | Número máximo de ofertas que devolver |
offset |
entero | No | Número de ofertas que se omitirán para la paginación |
type |
string | No | Filtrar por tipo de oferta: content (HTML), json o redirect |
name |
string | No | Filtrar por nombre de oferta (coincidencia parcial) |
Devuelve: objeto JSON con offers (lista de objetos que incluye id, name, type, content, modifiedAt) y total.
Mensaje de ejemplo: “Enumerar todas las ofertas JSON”.
Herramienta: get_target_offer
Obtenga información detallada sobre una oferta específica.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
offer_id |
entero | Sí | El identificador único de la oferta |
Devuelve: Detalles completos de la oferta, incluidos id, name, type, content, workspace y modifiedAt.
Mensaje de ejemplo: “Obtener detalles para la 67890 de ofertas”.
Herramientas de audiencia tools-audiences
Herramienta: list_target_audiences
Enumerar todas las audiencias de su inquilino de Target.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
limit |
entero | No | Número máximo de audiencias que se devolverán |
offset |
entero | No | Número de audiencias que se omitirán para la paginación |
Devuelve: objeto JSON con audiences (lista de objetos que incluye id, name, description, origin, modifiedAt) y total.
Mensaje de ejemplo: “Enumerar todas las audiencias”.
Herramienta: get_target_audience
Obtenga detalles de audiencia, incluidas las reglas de segmentación.
Recupera la configuración completa de una audiencia específica, incluidas las reglas y condiciones de segmentación.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
audience_id |
entero | Sí | El identificador único de la audiencia |
Devuelve: detalles completos de la audiencia, incluidos id, name, description, origin, reglas de segmentación y recuento de actividades asociadas.
Mensaje de ejemplo: “Obtenga detalles de 12345 de audiencia y muéstreme sus reglas de segmentación”.
Herramientas de Mbox tools-mboxes
Herramienta: list_target_mboxes
Enumerar todos los mboxes de su inquilino Target.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
limit |
entero | No | Número máximo de mboxes que devolver |
offset |
entero | No | Número de mboxes que se omitirán para la paginación |
name |
string | No | Filtrar por nombre de mbox (coincidencia parcial) |
status |
string | No | Filtrar por estado |
Devuelve: objeto JSON con mboxes (lista de objetos que incluye name, status, lastRequestTime) y total.
Mensaje de ejemplo: “Enumerar todos los mboxes que contienen ‘homepage’.”
Herramienta: get_target_mbox
Obtenga información detallada sobre un mbox específico.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
mbox_name |
string | Sí | El nombre del mbox |
Devuelve: detalles de mbox, incluidos name, status y la lista de actividades que usan el mbox.
Mensaje de ejemplo: “Obtener detalles para mbox ‘homepage-hero’”.
Herramienta: list_target_mbox_profile_attributes
Enumera todos los atributos de perfil de mbox disponibles para el direccionamiento.
No se requieren parámetros.
Devuelve: matriz JSON de objetos de atributo de perfil.
Mensaje de ejemplo: “¿Qué atributos de perfil están disponibles para el direccionamiento?”
Herramientas de propiedad tools-properties
Herramienta: list_target_properties
Enumerar todas las propiedades del inquilino Target.
Las propiedades organizan las actividades y controlan el acceso.
No se requieren parámetros.
Devuelve: Lista de objetos de propiedad, incluidos id, name, description y channel.
Mensaje de ejemplo: “Enumerar todas las propiedades de Target”.
Herramientas de informes tools-reporting
Herramienta: get_ab_performance_report
Obtenga un informe de rendimiento para una actividad A/B.
Recupera las tasas de conversión, el alza y los niveles de confianza.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad A/B |
report_interval |
string | No | Período de tiempo del informe (por ejemplo, last7days, last30days o un intervalo de fecha personalizado) |
Devuelve: métricas de nivel de experiencia (visitantes, conversiones, tasa de conversión), cálculos de alza, niveles de confianza estadística y métricas de ingresos (si están configuradas).
Mensaje de ejemplo: “Mostrarme el informe de rendimiento para 12345 de prueba A/B durante los últimos 30 días”.
Herramienta: get_ab_orders_report
Obtenga un informe de pedidos/ingresos de una actividad A/B.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad A/B |
report_interval |
string | No | Período de tiempo del informe |
Devuelve: recuentos de pedidos, ingresos y valor de pedido promedio por experiencia.
Mensaje de ejemplo: “Obtener el informe de pedidos de la actividad 12345”.
Herramienta: get_xt_performance_report
Obtenga un informe de rendimiento para una actividad de segmentación de experiencias.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad XT |
report_interval |
string | No | Período de tiempo del informe |
Devuelve: métricas de rendimiento de nivel de experiencia.
Mensaje de ejemplo: “Mostrar rendimiento para mi 54321 de actividad de segmentación de experiencias”.
Herramienta: get_xt_orders_report
Obtenga un informe de pedidos/ingresos de una actividad de segmentación de experiencias.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad XT |
report_interval |
string | No | Período de tiempo del informe |
Devuelve: métricas de pedidos por experiencia.
Mensaje de ejemplo: “Obtener datos de pedidos para 54321 de actividad XT”.
Herramienta: get_activity_report_by_name
Busque una actividad por su nombre y obtenga su informe de rendimiento.
Resulta útil cuando conoce el nombre de la actividad pero no su ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_name |
string | Sí | Nombre de la actividad que se busca |
report_interval |
string | No | Período de tiempo del informe |
Devuelve: detalles de actividad y métricas de rendimiento.
Mensaje de ejemplo: “Obtener el informe de rendimiento para mi actividad ‘Prueba Hero de página principal’”."
Herramienta: get_a4t_report
Busque un informe de Analytics for Target (A4T) para una actividad Target.
Valida la configuración de A4T para la actividad y, a continuación, ejecuta consultas de GraphQL con Adobe Analytics para recuperar métricas de Analytics. Solo está disponible para actividades que tienen configurados informes de A4T.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | El identificador único de la actividad Target |
report_interval |
string | No | Período de tiempo del informe (por ejemplo, last7days, last30days o un intervalo de fecha personalizado) |
Devuelve: métricas del lado de Analytics para la actividad que incluyen recuentos de visitantes, conversiones, ingresos y alza por experiencia, obtenidas directamente de Adobe Analytics.
Mensaje de ejemplo: “Extraiga el informe A4T para mi prueba de optimización de cierre de compra y resuma los datos de conversión del lado de Analytics”.
Herramientas de previsualización tools-preview
Herramienta: preview_activity
Generar URL de vista previa de control de calidad del explorador para una actividad Target.
Crea vínculos de vista previa en los que se puede hacer clic y que fuerzan a que se muestren experiencias específicas, omitiendo las reglas de segmentación de audiencia. Funciona para actividades A/B, XT y Automated Personalization.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
activity_id |
entero | Sí | Identificador de actividad Target que se va a previsualizar |
experience_index |
entero | No | Índice de experiencia basado en 0. Si se omite, devuelve las direcciones URL de todas las experiencias |
url |
string | No | URL de página para vista previa. Necesario para actividades basadas en formularios. Para las actividades de VEC, anula la ubicación creada si se proporciona |
Devuelve: información de la actividad (nombre, tipo, estado), URL de vista previa para cada experiencia y nombres e índices de experiencias.
Mensaje de ejemplo: “Genere direcciones URL de vista previa para 12345 de actividad para poder probar cada experiencia en mi explorador”.
Herramientas de token de respuesta tools-response-tokens
Herramienta: list_target_response_tokens
Enumerar todos los tokens de respuesta del inquilino Target.
Recupera todos los tokens de respuesta configurados, tanto integrados como personalizados.
No se requieren parámetros.
Devuelve: matriz JSON de objetos de token de respuesta con estado name, type y enabled.
Mensaje de ejemplo: “Enumerar todos los tokens de respuesta”.
Herramientas de revisión tools-revisions
Herramienta: get_target_revisions
Obtenga el registro de auditoría para un tipo de recurso.
Recupera los cambios realizados en Target recursos con filtrado opcional por autor.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
revision_resource_type |
string | Sí | Tipo de recurso: activity, offer o audience |
modified_by |
string | No | Filtrar por el usuario que hizo los cambios |
limit |
entero | No | Número máximo de revisiones que se devolverán |
offset |
entero | No | Número de revisiones que se omitirán para la paginación |
Devuelve: historial de revisiones con marcas de tiempo, usuarios y descripciones de cambios.
Mensaje de ejemplo: “Mostrarme el registro de auditoría para los cambios de la actividad”.
Herramienta: get_target_entity_revisions
Obtener todas las revisiones de una entidad específica por ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parámetro | Tipo | Requerido | Descripción |
revision_resource_type |
string | Sí | Tipo de recurso: activity, offer o audience |
entity_id |
entero | Sí | El identificador único de la entidad |
Devuelve: matriz JSON de todas las revisiones para la entidad especificada.
Mensaje de ejemplo: “Mostrarme todos los cambios realizados en el 12345 de la actividad.”
Herramientas de plantilla tools-templates
Herramienta: list_target_templates
Enumere los recursos y plantillas de MCP disponibles para crear actividades y ofertas.
No se requieren parámetros.
Devuelve: objeto JSON que enumera las plantillas y los recursos disponibles.
Mensaje de ejemplo: “¿Qué plantillas están disponibles para crear actividades?”
Resumen de herramientas tools-summary
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activitylist_target_offers, get_target_offerlist_target_audiences, get_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_tokensget_target_revisions, get_target_entity_revisionslist_target_templates