Referencia de herramientas del servidor MCP Adobe Target target-mcp-tools-reference

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.

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.

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.

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

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

Herramienta: create_ab_activity

Cree una nueva actividad de prueba A/B.

Crea una nueva prueba A/B con la configuración especificada que incluye experiencias, ofertas y segmentación.

Devuelve: El objeto de actividad creado con su ID asignado.

Mensaje de ejemplo: “Cree una prueba A/B llamada ‘Homepage Hero Test’ con dos experiencias probando distintas imágenes a pantalla completa en el mbox homepage-hero”.

Herramienta: create_xt_activity

Cree una nueva actividad de segmentación de experiencias (XT).

Crea una actividad XT que ofrece diferentes experiencias a diferentes audiencias en función de las reglas de segmentación.

Devuelve: El objeto de actividad creado con su ID asignado.

Mensaje de ejemplo: “Cree una actividad de segmentación de experiencias denominada ‘Geo Personalization’ que muestre contenido diferente a visitantes de diferentes regiones.”

Herramienta: update_ab_activity

Actualice una actividad A/B existente.

Utiliza un patrón de lectura-modificación-escritura: recupera el estado actual, combina los cambios, valida y envía la actualización.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Actualice la actividad 12345 para cambiar la asignación de tráfico a 70/30.”

Herramienta: update_xt_activity

Actualice una actividad de segmentación de experiencias existente.

Utiliza un patrón de lectura, modificación y escritura.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Actualice la actividad XT 12345 para agregar una nueva experiencia para los visitantes móviles”.

Herramienta: update_abt_activity

Actualice una actividad de Automated Personalization existente.

Utiliza un patrón de lectura, modificación y escritura.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Actualice la actividad de Auto-Personalization 12345 para cambiar el objetivo de optimización”.

Herramienta: update_activity_schedule

Actualizar las fechas de inicio y finalización de la actividad.

Actualiza la programación de una actividad sin modificar otros ajustes.

Devuelve: confirmación de la actualización de programación.

Mensaje de ejemplo: “Actualice la programación de la actividad A/B 12345 para que se ejecute del 1 al 31 de mayo”.

Herramienta: update_activity_state

Cambiar estado de actividad (activar, desactivar o pausar).

Devuelve: El estado de actividad actualizado.

Mensaje de ejemplo: “Activar 12345 de actividad” o “Pausar la prueba principal”.

Herramienta: update_activity_name

Cambie el nombre de una actividad.

Actualiza solo el nombre sin modificar la configuración completa.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Cambie el nombre de la actividad 12345 a ‘Prueba Hero de campaña de verano’”.

Herramienta: update_activity_priority

Cambiar la prioridad de actividad.

Las actividades de prioridad más alta tienen prioridad cuando varias actividades se dirigen a la misma ubicación.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Establezca la prioridad de la actividad 12345 en 100”.

Herramienta: add_activity_variant

Añadir una nueva experiencia o variante a una actividad.

Gestiona toda la coordinación estructural, incluida la creación de opciones, la asignación a ubicaciones y el reequilibrio del tráfico.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Agregue una nueva variante denominada ‘Tema de vacaciones’ a la actividad A/B 12345 mediante 67890 de oferta.”

Herramienta: update_traffic_split

Actualizar la asignación del tráfico entre las variantes.

Los porcentajes deben sumar exactamente 100.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Cambie la división de tráfico para la actividad 12345 a 70% Control y 30% Variante A”.

Herramienta: update_variant_offer

Cambie la oferta por una variante específica.

Funciona tanto para actividades basadas en formularios (usando offer_id) como para actividades VEC (usando modifications).

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Actualice la experiencia ‘Variante A’ en la actividad 12345 para usar 99999 de oferta.”

Herramienta: remove_activity_variant

Eliminar una experiencia o variante de una actividad.

Elimina la experiencia, limpia las opciones huérfanas y reequilibra el tráfico de forma uniforme entre las variantes restantes.

Devuelve: El objeto de actividad actualizado.

Mensaje de ejemplo: “Quitar la experiencia ‘Variante de prueba’ del 12345 de actividad A/B.”

Herramienta: list_target_offers

Enumerar todas las ofertas de su inquilino Target.

Recupera una lista paginada de ofertas de contenido con filtrado opcional.

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.

Devuelve: Detalles completos de la oferta, incluidos id, name, type, content, workspace y modifiedAt.

Mensaje de ejemplo: “Obtener detalles para la 67890 de ofertas”.

Herramienta: create_target_offer

Cree una nueva oferta de contenido de HTML.

Devuelve: La oferta creada con su ID asignado.

Mensaje de ejemplo: “Cree una oferta de HTML llamada ‘Banner de venta de verano’ con un banner promocional”.

Herramienta: create_target_json_offer

Cree una nueva oferta JSON para ofrecer datos estructurados.

Devuelve: La oferta creada con su ID asignado.

Mensaje de ejemplo: “Cree una oferta JSON llamada ‘Configuración de indicadores de características’ con la configuración de alternancia de características.”

Herramienta: update_target_offer

Actualizar una oferta existente.

Devuelve: El objeto de oferta actualizado.

Mensaje de ejemplo: “Actualizar 67890 de oferta con contenido promocional nuevo”.

Herramienta: list_target_audiences

Enumerar todas las audiencias de su inquilino de Target.

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.

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

Herramienta: create_target_audience

Cree una nueva audiencia con reglas de segmentación.

Devuelve: La audiencia creada con su ID asignado.

Mensaje de ejemplo: “Cree una audiencia denominada ‘Visitantes móviles de California’ dirigida a usuarios móviles en CA.”

Herramienta: list_target_mboxes

Enumerar todos los mboxes de su inquilino Target.

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.

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

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

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.

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.

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.

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.

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.

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.

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

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.

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

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

Herramienta: create_target_response_token

Cree un nuevo token de respuesta personalizado para recopilar datos adicionales en Target respuestas.

Devuelve: El objeto de token de respuesta creado.

Mensaje de ejemplo: “Cree un token de respuesta personalizado denominado ‘campaign_id’ de tipo ACTIVITY.”

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.

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.

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

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