Publicidad de Amazon
API v4 de anuncios por formato de Sponsored Brands MCP
Trabaja con un formato de anuncio de Marcas Patrocinadas seleccionado para gestionar los anuncios correspondientes para tu marca. Utiliza la versión 4.
Prompts y casos de uso de API v4 de anuncios por formato de Sponsored Brands
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. Preparar un anuncio de Sponsored Brands
Prompt: Utilice Amazon Ads Manager para preparar un nuevo anuncio de Marcas Patrocinadas [my ad format] para mi cuenta conectada [connection ID], utilizando [my campaign, ad group and creative settings]. Mostrar una vista previa y esperar la aprobación antes de aplicar el cambio.
2. Prepare un anuncio de colección
Prompt: Utilice Amazon Ads Manager para preparar una colección de productos o una colección curada automática o manualmente para la cuenta [connection ID], utilizando [my campaign, ad group and creative settings]. Verificar el formato elegido y sus entradas creativas requeridas, luego mostrar una vista previa y esperar la aprobación antes de cualquier cambio.
3. Prepare un anuncio de vídeo
Prompt: Utilice Amazon Ads Manager para preparar un anuncio de vídeo o marca para la cuenta [connection ID], utilizando [my campaign, ad group and creative settings]. Verificar el formato elegido y sus entradas creativas requeridas, luego mostrar una vista previa y esperar la aprobación antes de cualquier cambio.
4. Prepare un anuncio de Spotlight Store
Prompt: Utilice Amazon Ads Manager para preparar un anuncio de spotlight de la tienda para la cuenta [connection ID], utilizando [my campaign, ad group and creative settings]. Verificar el formato elegido y sus entradas creativas requeridas, luego mostrar una vista previa y esperar la aprobación antes de cualquier cambio.
Qué debes proporcionar
Usa una conexión de Amazon Ads que te pertenezca. Nunca incluyas credenciales del proveedor en un prompt ni en el cuerpo de una solicitud.
Para realizar un cambio, primero revisa una vista previa y después aprueba por separado ese cambio concreto. Que un ejemplo funcione no autoriza a modificar una cuenta.
Algunos campos heredados y detalles de las operaciones no están completamente documentados. Los ejemplos cubren los flujos confirmados; comprueba las limitaciones de entrada y respuesta antes de usar esta ruta.
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/jsonAutenticació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
nexscope_data_amazon_ads_developer_proxy_sb_v4_ads_ad_typehttps://api.nexscope.ai/mcptools/callInicializa 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": "data-amazon-ads-developer-proxy-sb-v4-ads-ad-type-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_sb_v4_ads_ad_type",
"arguments": {
"accept": "application/vnd.sbadresource.v4+json",
"body": "{}",
"contentType": "application/vnd.sbadresource.v4+json",
"method": "POST"
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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 | Una Amazonía Ads connection owned by the autated Nexscope usuario. |
fetchAll | boolean | opcional | Turno automático de página; SP y SB V4 uso de listas de recursos principales `nextToken`, SB Target/BudgetRule usos `nextToken` (BudgetRule query debe contener `pageSize`), SB Palabra clave GET, SB V3 GET y SD uso `startIndex + count`. Ejemplo: true |
maxResults | integer | opcional | Página única 1–100; SD corresponde a contar. Ejemplo: 100 |
skipDepCheck | boolean | opcional | Skip dependency check. Ejemplo: false |
includeExtendedDataFields | boolean | opcional | Algunas entidades devuelven campos ampliados; SD se cambia a través del camino /extended. |
locale | string | opcional | Parámetros de localización (apoyados por algunos scripts de palabras clave). |
method | string | obligatorio | Upstream HTTP método; lista de consultas `POST`. |
body | string | obligatorio | La carga útil debe ser proporcionada; la habilidad la serializará y la enviará al río arriba, y el acceso Amazon token no se puede poner en la carga útil. |
contentType | string | opcional | application/vnd.sbadresource.v4+json. |
accept | string | opcional | `application/vnd.sbadresource.v4+json`。 |
queryString | string | opcional | Pase los parámetros de consulta de arriba cuando sea necesario. |
confirmationToken | string | opcional | Para mutaciones, primera vista previa sin token, luego confirme utilizando el token de uso único devuelto. |
ad_type | string | obligatorio | Identificador de recursos para esta operación. |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
success | boolean | opcional | Si la habilidad completó la llamada con éxito. |
apiVersion | string | opcional | `V3` o `V4` (si lo proporciona el script). |
amazonResourceVersion | string | opcional | La versión real de recursos de Amazon (si es proporcionada por el script). |
ads | array | opcional | Marcas Patrocinadas V4 Array de tipos de anuncios especificados; campos reales devueltos por Amazon. |
total | integer | opcional | El número de entradas agregadas (si se proporciona por el script). |
pagesFetched | integer | opcional | Número de páginas obtenidas. |
truncated | boolean | opcional | Si fue truncado debido al límite de paging. |
name | string | opcional | Nombre (retornado si apoyado por la entidad). |
state | string | opcional | `ENABLED`, `PAUSED` o `ARCHIVED` (SD upstream puede usar minúscula). |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Utilice Amazon Ads Manager para preparar un nuevo anuncio de Marcas Patrocinadas [my ad format] para mi cuenta conectada [connection ID], utilizando [my campaign, ad group and creative settings]. Mostrar una vista previa y esperar la aprobación antes de aplicar el cambio.
Pasos sugeridos
Prepara la cuenta, las entidades afectadas y la configuración propuesta para la vista previa. Muestra los cambios exactos y espera una aprobación independiente antes de aplicarlos. La documentación heredada no define el cuerpo completo de la solicitud original; este ejemplo no afirma que se haya validado el envío ni que se haya modificado la cuenta.
Sobre esta muestra: Solo se ilustra el flujo de trabajo. El cuerpo heredado es una cadena JSON opaca y los marcadores del catálogo no constituyen una carga útil completa y validada del proveedor. Para verificar una solicitud y su respuesta se necesitan el contrato del cuerpo de esa operación y la definición del resultado de la vista previa.
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
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
No hay un ejemplo verificado de solicitud MCP. Consulta Integración y los requisitos documentados antes de preparar una llamada.
Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.