Amazon Advertising

Informe de audiencias de Sponsored Products de Amazon Ads MCP

Crea un informe de audiencias de Sponsored Products con los parámetros documentados.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Informe de audiencias de Sponsored Products de Amazon Ads

Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.

¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.

1. Obtenga datos del público diario

Prompt: Crear un informe diario Productos patrocinados para mi conexión Amazon Ads [CONNECTION_ID] desde [START_DATE] a través de [END_DATE]. Utilice una fecha final a más tardar hoy y no antes de la fecha de inicio. Devuélvele la referencia y el estado de su informe, a continuación, utilice esa referencia para los controles de seguimiento.

2. Obtener datos de audiencia resumen

Prompt: Crear un resumen Productos patrocinados informe de audiencia para mi conexión Amazon Ads [CONNECTION_ID] desde [START_DATE] a través de [END_DATE]. Utilice una fecha final a más tardar hoy y no antes de la fecha de inicio. Devuélvele la referencia y el estado de su informe, a continuación, utilice esa referencia para los controles de seguimiento.

3. Consulta audiencia por cuenta

Prompt: Crear un informe de audiencia de productos patrocinados a nivel de cuenta para mi conexión [CONNECTION_ID] desde [START_DATE] a través de [END_DATE], utilizando totales diarios y fechas inclusivas válidas terminando a más tardar hoy.

4. Ver audiencia por campaña

Prompt: Crear un informe de audiencia de Productos Patrocinados a nivel de campaña para mi conexión [CONNECTION_ID] desde [START_DATE] a través de [END_DATE], utilizando totales diarios y fechas inclusivas válidas terminando a más tardar hoy.

5. Ver audiencia por grupo de anuncios

Prompt: Crear un informe de audiencia de productos patrocinados a nivel de grupo de anuncios para mi conexión [CONNECTION_ID] desde [START_DATE] a través de [END_DATE], utilizando totales diarios y fechas inclusivas válidas terminando a más tardar hoy.

6. Utilice una cuenta de anunciante específica

Prompt: Crear un informe de audiencia de Productos Patrocinados [CONNECTION_ID] y cuenta del anunciante de recuperación [ADVERTISER_ACCOUNT_ID], de [START_DATE] a través de [END_DATE]. Terminando a más tardar hoy. Utilice esta cuenta explícita sólo cuando el mapeo normal de conexión necesita recuperación.

Qué debes proporcionar

Usar una Amazonía Ads connection you own. Mantengan las credenciales fuera de los avisos. Un informe que todavía se procesa no es un resultado completado; reutilizar su referencia en lugar de crearlo de nuevo.

Los cambios de publicidad requieren una vista previa y su confirmación explícita. Estos ejemplos no autorizan cambios por sí mismos.

Los ejemplos de múltiples solicitudes tienen un punto de parada explícito. Deje de cometer un error o falta de información requerida en lugar de continuar indefinidamente.

Paso 1 · Conectar

Conecta tu asistente de IA

Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Autenticación

Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.

Llamar a esta herramienta MCP

Nombre de la herramienta MCP

nexscope_amazon_ads_sp_audience_report

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-ads-sp-audience-report-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_sp_audience_report",
    "arguments": {
      "connectionId": 123,
      "endDate": "2026-08-07",
      "startDate": "2026-08-01"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`connectionId`	`integer`	obligatorio	Owned Amazon Conexión de anuncios ID; perfil y región se resuelven por el backend. Ejemplo: 123
`startDate`	`string`	obligatorio	Fecha de inicio del informe inclusivo YYYY-MM-DD. Ejemplo: 2026-08-01
`endDate`	`string`	obligatorio	Inclusive YYYY-MM-DD fecha, no después de hoy o antes startDate. Ejemplo: 2026-08-07
`advertiserAccountId`	`string`	opcional	Cuenta de recuperación explícita ID; omitted significa mapeo único del perfil autorizado.
`timeUnit`	`string`	opcional	DAILY o SUMMARY; predeterminados a DAILY.
`detailLevel`	`string`	opcional	ACCOUNT, CAMPAIGN o AD_GROUP; predeterminados a ACCOUNT.

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma.
`cost`	`string`	obligatorio	Milliseconds pasados, nunca créditos; -1 solicitudes fuera de la web.
`data`	`any`	obligatorio	Valor de Data usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Valor de Msg usado por esta operación de API.
`time`	`string`	obligatorio	Tiempo local del servidor: yyyy-MM- No. HH:mm:ss.
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Época milisegundos.

Opción 1 de cualquier alternativa — requiere reportId

Nombre	Tipo	Obligatorio	Descripción
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.completedReportParts`	`array`	opcional	Completado CSV partes; cada parte contiene un backend documentToken en lugar de una firma URL. Ejemplo: []
`data.costTime`	`integer`	opcional	Tiempo de ejecución reportado por el proveedor de corriente. Ejemplo: null
`data.costToken`	`integer`	opcional	Costo de ficha reportado por el proveedor de corriente. Ejemplo: null
`data.dataSnapshotMonth`	`string`	opcional	Data snapshot month returned by the upstream provider. Ejemplo: null
`data.page`	`integer`	opcional	Página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageItemCount`	`integer`	opcional	El artículo cuenta con la página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageSize`	`integer`	opcional	Tamaño de página devuelto por el proveedor de corriente. Ejemplo: null
`data.reportId`	`string`	obligatorio	Identificador de informe creado o preguntado. Ejemplo: report-id
`data.reportParts`	`array`	opcional	Provider alias for completed parts, when present. Ejemplo: []
`data.sourceTool`	`string`	opcional	Nombre de la herramienta de fuente específico del proveedor. Ejemplo: null
`data.sourceType`	`string`	opcional	Tipo de plataforma de fuente específica del proveedor. Ejemplo: null
`data.status`	`string`	opcional	Informe del proveedor indica cuándo está presente. Ejemplo: PENDING
`data.title`	`string`	opcional	Título de respuesta específico del proveedor. Ejemplo: null
`data.totalPage`	`integer`	opcional	Conteo total de página devuelto por el proveedor de corriente. Ejemplo: null
`data.type`	`string`	opcional	Tipo de renderizado o carga de pago específico del proveedor. Ejemplo: null

Opción 2 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`null`	obligatorio	Valor de Data usado por esta operación de API.

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Solicite mi informe de clientes de Productos Patrocinados del 1 al 7 de agosto de 2026.

Explicación ilustrativa de la respuesta

La solicitud del ejemplo devuelve el informe report-example-001 con estado PENDING. El informe de audiencias todavía se está preparando. Conserva el ID del informe y consulta su estado antes de intentar descargarlo.

Sobre esta muestra: Ejemplo meramente ilustrativo: los nombres, identificadores y cifras son ficticios y no se hizo una llamada real. Tus resultados dependen de tu cuenta, las entradas y los datos disponibles.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos