Video Central

El conjunto de datos de ventas de TVOD proporciona datos de ventas a nivel de transacciones para su negocio de vídeo transaccional bajo demanda (TVOD) de Prime Video. Cada registro representa una transacción completada (compra o alquiler). Los datos se envían como un registro de cambios solo adjunto a través de la API de Slate Datasets, lo que le brinda total flexibilidad para crear análisis personalizados y calcular métricas adaptadas a las necesidades de su empresa.

Ventajas clave

Información más rápida: los datos de ventas se agrupan varias veces al día y la mayoría de las transacciones se entregan en un plazo de aproximadamente 9 horas desde su finalización.
Separación entre costes y ventas: las señales de ventas se envían en lotes de 4 horas; la información sobre costes (net_cogs) se actualiza a diario para que pueda obtener las señales de ingresos lo más rápido posible.
Coherencia: formato estandarizado en todos los territorios en una sola fuente.
Ingestión simplificada: modelo de registro de cambios que solo se puede adjuntar, con un patrón simple e insertado para una ingesta automática y sin intervención.
Granularidad a nivel de transacción: acceda a datos individuales a nivel de pedido para realizar análisis personalizados, realizar un seguimiento del rendimiento a nivel de título e integrar sistemas internos.
Integración flexible: integre los datos de ventas de TVOD con sus sistemas internos, almacenes de datos y herramientas de BI.

Característica	API de conjuntos de datos de Slate
Type de acceso	Programático (API REST)
Ideal para	Procesos automatizados, informes empresariales, análisis personalizados
Autentic	Inicie sesión con el perfil de seguridad de Amazon (LWA)
Formato de datos	Archivos CSV (comprimidos con gzip)

Cómo empezar

Prerrequisitos

Asociación activa con Prime Video TVOD
Un inicio de sesión con Amazon (LWA) Security Profile
ID de cliente registrado en su administrador de cuentas de contenido (CAM)
Un código de autorización para solicitar un token
Un token de autenticación LWA válido para todas las solicitudes de API

Configuración de autenticación
Para recuperar conjuntos de datos, primero debe incorporarse al conjunto de API de conjuntos de datos. Puede encontrar más detalles aquí.

Puntos finales de API

Puntos de conexión de descubrimiento
Utilice estos puntos de conexión para buscar sus ID de cuenta y contrato mediante programación:

Punto final	Devoluciones
GET /v2/accounts	Lista de cuentas de Slate a las que puedes acceder
OBTENGA /v2/accounts/ {ACADIA_ID}	Líneas de negocio disponibles (p. ej., canales, transacciones)
OBTENGA /v2/accounts/ {ACADIA_ID} /transactions	Lista de identificadores de contratos de TVOD incluidos en su cuenta
OBTENGA /v2/accounts/ {ACADIA_ID} /transactions/ {CONTRACT_ID} /datasets	Conjuntos de datos disponibles para un contrato

Recuperación de archivos de conjuntos de datos
Utilice este punto final para recuperar enlaces a archivos de conjuntos de datos de transacciones para su contrato:

Parámetros de solicitud

Parámetro	Description
ACADIA_ID	Tu ID de cuenta de Slate. Encuéntrelo mediante GET /v2/accounts.
CONTRACT_ID	Su ID de contrato de TVOD.
Fecha y hora de inicio	Establézcalo como la última vez que tiraste. Formato: aaaa-mm-ddthh:mm:SSZ (UTC).
Fecha y hora de finalización	Definir la hora actual. Formato: aaaa-mm-ddthh:mm:SSZ (UTC).
limitar	Máximo 1000 enlaces por página.

Este punto final devuelve enlaces a archivos CSV descargables (comprimidos con gzip) que contienen los registros de transacciones, no las transacciones directamente.

Paginación Todas las
respuestas están paginadas. Utilice los siguientes parámetros de consulta para navegar por los resultados:

Parámetro	Predeterminado	Description
limitar	10	Number of documents returned per page. Máximo 1000.
compensar	0	Number of pages to skip.

Todas las respuestas paginadas contienen los siguientes campos:

Campo	Description
total	Recuento total de documentos en todas las páginas.
próximo	URL a la página siguiente. Es nulo si está en la última página.

Modelo de datos

Conceptos clave

Concepto	Description
Transacción	Un evento de pedido completado (compra o alquiler). Cada transacción se identifica mediante un order_item_id único.
Modelo de registro de cambios	Los datos solo se adjuntan. Si los atributos de un registro cambian (por ejemplo, si llegan los costes), se publica un registro nuevo con el mismo order_item_id pero con un last_update_time_utc más reciente.
Clave principal	order_item_id es el identificador único de cada transacción. Deduplique siempre en este campo.
Coste frente a ventas	Los datos de ventas llegan en lotes de 4 horas. Los costos (net_cogs) se actualizan a diario, por lo que los registros se actualizan con los costos cuando están disponibles.

Actualización de los datos

Atributo	Objetivo
Entrega de datos de ventas	Cada 4 horas (por lotes)
Actualización de Costing (net_cogs)	Cada 24 horas
Latencia integral	Aproximadamente 9 horas desde la transacción hasta la disponibilidad de los datos
Retención de datos	Máximo 2 años

Precisión de los datos

Atributo	Detalles
Fuente de la verdad	Las ganancias y los estados financieros siguen siendo la fuente final de verdad para los pagos y los costos.
Varianza esperada	Es posible que exista una pequeña variación debido a los matices de fecha y hora y a las diferencias de agregación en comparación con los informes financieros o de regalías.
Alcance	Completadas las órdenes siguiendo el ritmo de las transacciones para el seguimiento del rendimiento. No sustituye a los informes financieros o de regalías.

Este conjunto de datos está diseñado para un seguimiento del rendimiento más rápido y continuo. Se espera una pequeña variación en comparación con los informes financieros (por ejemplo, el Resumen del nivel diario del ASIN en Video) debido a los matices de fecha y hora y a las diferencias de agregación. Se trata de un comportamiento esperado, no de un problema de calidad de los datos.

Definiciones de datos

Campos principales En
la siguiente tabla se describen todos los campos disponibles en el conjunto de datos transactions_event_log:

Nombre del campo	Type	Aceptable a valores nulos	Description	Ejemplo
order_item_id	CADENA	No	Identificador único para cada transacción. Clave principal para la deduplicación.	ABC123XYZ
transacción_datetime_utc	MARCA DE TIEMPO	No	Hora de la transacción en UTC.	2026-01-14T 00:04:41.575
transacción_fecha_tiempo_local	MARCA DE TIEMPO	No	Hora de la transacción en la zona horaria local.	2026-01-14T 01:04:41.575
pv_title_id	CADENA	No	Identificador de título único.	tt1234567
tipo_contenido	CADENA	No	Type de contenido adquirido.	Película, episodio de TV, temporada de TV
tipo_de_compra	CADENA	No	Indicador de compra o alquiler.	EST (compra), VOD (alquiler)
calidad_contenido	CADENA	No	Nivel de calidad de vídeo.	SD, HD, HD
territorio	CADENA	No	Código de Territorio.	EE. UU., GB, DE, JP, AU
clase_dispositivo	CADENA	Sí	Categoría de dispositivo.	Fire TV, móvil, web
nombre_título	CADENA	No	Nombre del título.	La gran aventura
divisa	CADENA	No	Código de moneda ISO 4217.	USD, EUR, JPY
vendedor_sku	CADENA	Sí	SKU proporcionado por el socio.	WB-MOV-001
net_cogs	DECIMAL	Sí	Coste neto de los bienes vendidos, sin impuestos. Se actualiza a diario. Puede ser NULL inicialmente.	4.99
ingresos_netos	DECIMAL	No	Ingresos netos, sin impuestos.	14,99
create_time_utc	MARCA DE TIEMPO	No	Hora de creación del registro en UTC.	2026-01-14T 01:39:06.619
last_update_time_utc	MARCA DE TIEMPO	No	Registre la hora de la última actualización. Se utiliza para la lógica de deduplicación.	2026-01-14T 01:39:06.619

Notas de campo
Los siguientes campos tienen características de comportamiento importantes que las parejas deben conocer:

Campo	Cálculo o lógica	Notas
net_cogs	Se actualiza a diario	Puede aparecer inicialmente como NULL o 0; se actualiza en 24 horas, cuando llega el cálculo de costes.
last_update_time_utc	La última marca de tiempo gana	Si existen varios registros para el mismo order_item_id, conserva solo el registro con la última versión de last_update_time_utc.
territorio	Conjunto de datos único para todos los territorios	No hay archivos por territorio; filtre por código de territorio según sea necesario.
tipo_de_compra	Valores de enumeración fijos	EST = Venta directa electrónica (compra permanente). VOD = alquiler por tiempo limitado.

Deduplicación

Descripción general
El conjunto de datos utiliza un modelo de registro de cambios. Cuando se actualiza un registro (por ejemplo, se publica un cálculo de costes), se publica una nueva versión con el mismo order_item_id y un last_update_time_utc más reciente. Para mantener la precisión de los datos, aplique siempre la lógica de deduplicación antes de escribir los registros en su destino.

Consulta de deduplicación
Utilice el siguiente patrón de SQL para deduplicar y conservar solo la versión más reciente de cada transacción:

Patrón ascendente
Utilice este patrón para mantener una tabla local con el estado más reciente de cada transacción:

Tubería ETL

Descripción general
Siga este proceso de cuatro pasos para crear un canal de ingesta automatizado y confiable de los datos de ventas de TVOD.

Pasos de canalización

Obtención inicial de datos: extraiga todos los archivos de su contrato dentro del intervalo de tiempo deseado mediante el punto final de la API. Descarga todos los archivos devueltos. Cada archivo contiene registros de transacciones en formato CSV (comprimido con gzip).
Deduplicación: si existen varios registros para el mismo order_item_id mientras se procesan varios días de datos, conserve solo el último registro last_update_time_utc mediante la consulta de deduplicación de la sección 6.2.
Interrumpir con el destino: combine los registros deduplicados en la tabla de destino utilizando order_item_id como clave. Consulte el patrón de alteración en la sección 6.3.
Procesamiento incremental: para cargas de datos continuas, establezca StartDateTime en la última vez que extrajo y EndDateTime en la hora actual. Procesa todos los archivos devueltos y colócalos en tu destino.

Establezca los siguientes parámetros para las ejecuciones incrementales:

Cadencia de ingestión recomendada

Recomendación	Detalles
Cadencia recomendada	Cada 4-6 horas para mantenerse lo más actualizado posible.
Estrategia de procesamiento incremental	Establezca StartDateTime en la última marca de tiempo recuperada y EndDateTime en la hora actual. Procesa todos los archivos devueltos.
Consumidores diarios/semanales	Si los va a buscar a diario o semanalmente, asegúrese de procesar todos los archivos durante todo el período para evitar que falten registros.
Hora de inicio recomendada	En el caso de los trabajos diarios, comience a la 1 AM UTC para registrar los trabajos completados el día anterior.

Consultas de muestra

Use estos patrones de SQL para comenzar con los casos de uso de análisis más comunes. Sustituya [START_DATE], [END_DATE] y [X] por los valores que desee.

Los 10 títulos principales por ingresos durante un período

Ingresos totales por tipo de compra

Resumen de ventas diarias

Ingresos por Territorio

Normas de Calidad

Objetivos de Calidad de Datos

Dimensión de Calidad	Objetivo	Medición
Integridad	> 99% de las transacciones capturadas	Comparación con los informes financieros
Puntualidad	Aproximadamente 9 horas de latencia de extremo a extremo	Tiempo desde la transacción hasta la disponibilidad de los datos
Coherencia	Formato único estandarizado	Todos los territorios en un conjunto de datos

Limitaciones conocidas

Limitación	Description	Impacto
Retraso en los costes	net_cogs se actualiza a diario, no en tiempo real.	Los registros pueden mostrar inicialmente un coste NULO o 0; se actualizan en 24 horas.
Retención de datos	Máximo 2 años de datos históricos.	Las solicitudes con marcas de tiempo de más de 2 años no arrojarán resultados.
Expiración del token	Los tokens de acceso a la LWA caducan después de 1 hora.	Debe implementar una lógica de token de actualización para un acceso ininterrumpido.
Entrega basada en archivos	La API devuelve enlaces a archivos, no filas de datos directas.	Requiere un paso de descarga en tu proceso de procesamiento antes del procesamiento.
Desviación en el ámbito de las Finanzas	Variación menor en comparación con los informes financieros o de regalías.	El comportamiento esperado se debe a un matiz de fecha y hora; no a un problema de calidad de los datos.

Preguntas frecuentes

Este conjunto de datos proporciona los pedidos completados en el grano de las transacciones para un seguimiento del rendimiento más rápido y continuo. No sustituye a los informes financieros o de regalías. Las ganancias y los estados financieros siguen siendo la última fuente de información veraz para los pagos y los costos. Es de esperar una pequeña variación debido a los matices de fecha y hora y a las diferencias de agregación.

API de conjunto de datos de ventas de TVOD