Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Datos disponibles a través de la API de Amazon Selling Partner
La [API Amazon Selling Partner](https://developer-docs.amazon.com/sp-api/docs/welcome) (SP-API) es una API basada en REST que ayuda a los vendedores y vendedores de Amazon a acceder mediante programación a sus datos sobre pedidos, envíos, pagos y mucho más. Los datos de esta API pueden aumentar la eficiencia de las ventas, reducir los requisitos de mano de obra y mejorar el tiempo de respuesta a los clientes. Esta guía se centra en los datos a los que puedes acceder a través de la [API de Selling Partner para los informes](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide) (API de informes) y la [API de Selling Partner para Data Kiosk](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) (API de Data Kiosk).
## API de informes
Los datos de la API de informes están diseñados para ayudarte a gestionar tu negocio en el mercado de Amazon. [Los informes analíticos](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics) proporcionan información valiosa sobre tus productos, clientes y rendimiento general, como:
+ **Rendimiento de ventas: el** análisis de los datos de ventas puede ayudarle a identificar las tendencias y los patrones de compra de los clientes. Puede utilizar esta información para optimizar su estrategia de ventas.
+ **Rendimiento del producto**: analizar los datos del producto puede ayudarlo a identificar qué productos se venden bien y cuáles no. Puede utilizar esta información para optimizar su oferta de productos.
+ **Comportamiento** de los clientes: analizar los datos de los clientes puede ayudarlo a comprender las preferencias y necesidades de sus clientes. Puede utilizar esta información para personalizar sus estrategias de marketing y ventas.
En la siguiente tabla se explica cada informe de [análisis de marca](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports). Los siguientes informes están disponibles para los vendedores y vendedores de Amazon que tengan la función de API de socio vendedor de Brand Analytics y estén registrados en el Registro de marcas en Amazon.
****
| Informar | Description (Descripción) | Parameters |
| --- | --- | --- |
| [Informe de análisis de la cesta de mercado](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | Proporciona datos sobre los artículos que se compran con más frecuencia en combinación con los artículos de la cesta (carrito) del cliente al finalizar la compra | El informe se puede solicitar para diferentes períodos de presentación de informes (DAYWEEK,MONTH, oQUARTER). Los datos se proporcionan a lo largo de esos períodos. |
| [Informe de términos de búsqueda de Amazon](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | Contiene datos sobre los números de identificación estándar de Amazon (ASINs) seleccionados con más frecuencia, por palabra clave de búsqueda y departamento para un mercado | El informe se puede solicitar para diferentes períodos de informe (DAYWEEK,MONTH, oQUARTER). Las solicitudes no pueden abarcar varios períodos de presentación de informes. |
| [Repetir el informe de compra](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | Contiene datos sobre la cantidad de compras repetidas de artículos del socio vendedor | El informe se puede solicitar para diferentes períodos de informe (WEEK,MONTH, oQUARTER). Los datos pueden abarcar varios períodos de presentación de informes. |
En la siguiente tabla se explican los informes de [análisis de venta minorista de cada proveedor](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports) y de [venta](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports) minorista.
****
| Informar | Description (Descripción) | Disponibilidad. | Parameters |
| --- | --- | --- | --- |
| [Informe de inventario de Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | Contiene datos de inventario a nivel de ASIN, agregados con una granularidad horaria | Proveedores | El informe solo se puede solicitar. Los datos pueden abarcar varios períodos de intervalo de fechas, incluido el día actual. |
| [Informe de tráfico de Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | Contiene datos sobre el tráfico de clientes a las páginas de detalles de los artículos del proveedor, con una granularidad horaria | Proveedores | El informe solo se puede solicitar. Los datos pueden abarcar varios períodos de intervalo de fechas. |
| [Informe de ventas de Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | Contiene datos de ventas a nivel de ASIN, agregados con una granularidad horaria | Proveedores | El informe solo se puede solicitar. Los datos pueden abarcar varios períodos de intervalo de fechas. |
| [Informe de ventas de proveedores](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | Contiene las principales métricas de ventas minoristas (como los ingresos y las unidades pedidos y enviados), informados a nivel de catálogo y a nivel de ASIN | Proveedores | El informe se puede solicitar para diferentes tipos de:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [Informe de margen neto de producto puro](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | Contiene datos sobre los márgenes netos puros de Amazon para la venta de productos de un proveedor, informados a nivel de catálogo y a nivel de ASIN | Proveedores | El informe se puede solicitar para distintos períodos de informe (DAY,WEEK, MONTHQUARTER, oYEAR). |
| [Informe de tráfico de proveedores](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | Contiene las principales métricas del tráfico minorista, como las vistas generales, informadas a nivel de catálogo y a nivel de ASIN | Proveedores | El informe se puede solicitar para distintos períodos de informe (DAY,WEEK, MONTHQUARTER, oYEAR). |
| [Informe de previsión de proveedores](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | Contiene previsiones prospectivas de la demanda de los clientes semanales de 70, 80 y 90 semanas anteriores, informadas a nivel de ASIN para la fecha de generación de la previsión semanal más reciente | Proveedores | El informe se puede solicitar para distintos programas de venta (RETAILo). FRESH |
| [Informe de inventario del proveedor](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | Contiene métricas de inventario y estado operativo (como las unidades disponibles para la venta y la tasa de confirmación de proveedores), informadas a nivel de catálogo y a nivel de ASIN | Proveedores | El informe se puede solicitar para diferentes tipos de:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [Informe comercial de ventas y tráfico](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | Contiene estadísticas clave sobre el rendimiento de las ventas (como las ventas de productos pedidos, los ingresos, las unidades pedidas y el importe reclamado) y las estadísticas del tráfico de la página (como el porcentaje de visitas a la página y el porcentaje de cajas de compra) para todo el catálogo del vendedor, agrupadas por fecha y ASIN | Vendedores | El informe se puede solicitar o programar. Los datos se pueden proporcionar para diferentes niveles de agregación de intervalos de fechas (DAYWEEK, oMONTH) y niveles de agregación de ASIN (PARENT,CHILD, oSKU). |
## API de Data Kiosk
La API Data Kiosk proporciona un conjunto de informes dinámicos basado en [GraphQL](https://graphql.org/). Te ayuda a generar consultas GraphQL personalizadas y a acceder a datos masivos de los conjuntos de datos de Amazon. Puedes usar esta API para acceder a una amplia gama de datos, que incluyen:
+ [Datos de ventas y tráfico del vendedor](#data-kiosk-api-seller-sales-traffic-data)
+ [Datos de análisis de proveedores](#data-kiosk-api-vendor-analytics-data)
+ [Datos económicos del vendedor](#data-kiosk-api-seller-economics-data)
Las funciones clave de la API Data Kiosk son las siguientes:
+ **Informes dinámicos basados en GraphQL**: la API admite operaciones de consulta de GraphQL, lo que te ayuda a crear consultas personalizadas para recuperar los datos específicos que necesitas.
+ Acceso **masivo a datos: puedes acceder a** grandes conjuntos de datos a través de la API, lo que facilita el análisis y la elaboración de informes exhaustivos.
+ **Exploración de datos flexible**: el enfoque basado en GraphQL permite una exploración de datos dinámica y ad hoc. Esta flexibilidad le ayuda a iterar las consultas y a extraer información.
+ **Cobertura de datos integral**: la API proporciona acceso a una amplia gama de datos de vendedores y proveedores, lo que permite un análisis holístico del rendimiento y una inteligencia empresarial.
Los esquemas y las directivas de la API Data Kiosk proporcionan una forma estructurada de acceder a sus datos a través de una API GraphQL, con la capacidad de agregar y filtrar los datos en función de sus necesidades específicas. Al utilizar la API Data Kiosk, puede obtener información más detallada y procesable sobre los datos de ventas, tráfico y análisis. Esto le permite tomar decisiones informadas y basadas en datos para optimizar sus estrategias comerciales.
**nota**
La retención de una consulta varía en función de los campos solicitados. Cada campo de un esquema está anotado con una `@resultRetention` directiva que define durante cuánto tiempo se conservará una consulta que contenga ese campo. Cuando una consulta contiene varios campos con retenciones diferentes, se aplica la retención más corta (mínima). La retención de los documentos resultantes de una consulta siempre coincide con la retención de la consulta.
### Datos de ventas y tráfico del vendedor
En la API de Data Kiosk, `Analytics_SalesAndTraffic_2024_04_24` es el tipo raíz de las consultas de ventas y tráfico. Hay dos consultas disponibles para este tipo de raíz:
+ `salesAndTrafficByAsin`recupera los datos de ventas y tráfico agregados por ASIN (`PARENT``CHILD`, o`SKU`).
+ `salesAndTrafficByDate`recupera los datos de ventas y tráfico agregados por fecha (`DAY`,`WEEK`, o). `MONTH`
Tenga en cuenta lo siguiente acerca de estas consultas:
+ Los tipos enumerados (enumeraciones), como `AsinGranularity` y`DateGranularity`, especifican el nivel de agregación.
+ Los tipos escalares, como la [fecha](https://the-guild.dev/graphql/scalars/docs/scalars/date), se utilizan para representar los datos.
### Datos de análisis de proveedores
En la API de Data Kiosk, `Analytics_vendorAnalytics_2024_09_30` es el tipo raíz de las consultas de análisis de los proveedores. Hay dos vistas disponibles para este tipo de raíz:
+ `manufacturingView`recupera las métricas sobre los productos que usted fabrica, agregadas por la fecha especificada.
+ `sourcingView`recupera las estadísticas sobre los productos que compras directamente en Amazon, agregadas por la fecha especificada.
Accedes a la vista correspondiente y a las métricas asociadas en función de la función que se te asigne como proveedor (`SOURCING`o`MANUFACTURING`). Estas consultas incluyen las fechas de inicio y finalización, el identificador del mercado, las métricas agregadas y las métricas totales. Ten en cuenta lo siguiente acerca de estas consultas:
+ Las métricas se agrupan por varios atributos (como el ASIN o la marca) mediante los `SourcingViewMetricsGroupedBy` tipos `ManufacturingViewMetricsGroupedBy` y.
+ Los tipos de métricas, como`costs`,`customerSatisfaction`, y `orders``productAvailability`, representan los distintos grupos de métricas.
+ La `DateGranularity` enumeración especifica el nivel de agregación de fechas.
### Datos económicos del vendedor
El informe económico del vendedor ofrece una visión completa de tu rendimiento y tus finanzas en el mercado de Amazon. Abarca los datos de ventas, el gasto en publicidad, las comisiones, los costes y los ingresos netos. Puede agregar los datos por fecha e identificador del producto.
En la API de Data Kiosk, `Analytics_Economics_2024_03_15` es el tipo raíz de las consultas económicas de los vendedores. Los datos económicos del vendedor de un producto determinado se representan mediante el `Economics` tipo. Este tipo incluye los siguientes aspectos clave:
+ `ads`— Los datos de gasto publicitario del producto dentro del intervalo de fechas especificado.
+ `cost`— El coste de descuento en Amazon proporcionado por el vendedor para este producto (por unidad).
+ `fees`— Las tarifas aplicadas al producto dentro del intervalo de fechas especificado.
+ `fnsku`— La unidad de mantenimiento de existencias (FNSKU) de la red logística del producto.
+ `msku`— La unidad de mantenimiento de existencias comerciales (MSKU) del producto.
+ `netProceeds`— Los ingresos netos de este producto dentro del intervalo de fechas especificado.
+ `sales`— Los datos de ventas del producto dentro del intervalo de fechas especificado.