API de plataforma digital: informes históricos

Información general

El informe histórico es el informe de análisis principal de Microsoft Monetize, que ofrece datos completos en una amplia gama de dimensiones y métricas. Consolida más de diez tipos de informes heredados, incluidos Network Analytics, Seller Brand Review y Seller Fill and Delivery. Reduce el número de tipos de informe con los que un usuario debe interactuar, proporcionando características para mejorar la facilidad de uso, como la categorización de y metrics las funcionalidades de dimensions búsqueda completas.

El informe histórico se crea a partir de dos conjuntos de datos accesibles a través de una única interfaz, con dimension incompatibilidades expuestas metric durante la selección. El rango ampliado de opciones proporciona una vista más detallada de los datos en varios aspectos de entrega e inventario, con combinaciones de dimensiones notificables adicionales, como la ubicación y el dispositivo. El informe Histórico incluye la mayoría de los datos disponibles en el sistema de informes heredado.

Nota:

Este informe es de disponibilidad general e incluye datos a partir de October 10, 2024. Las actualizaciones planeadas ampliarán su funcionalidad para alinearse con los informes Análisis de red, Relleno y entrega de vendedores y Video Analytics. En futuras actualizaciones se introducirán datos adicionales, métricas y ajustes.

Tiempo de eventos de informe

El informe histórico permite atribuir las métricas a la hora de la solicitud de anuncio de origen, en lugar de a la hora en que se produce cada evento posterior. Esto garantiza la coherencia al calcular las tasas de eventos que pueden producirse horas después de la llamada de anuncio inicial, como impresiones de vídeo, impresiones nativas y conversiones.

Ejemplo

En el ejemplo siguiente, una solicitud de anuncio de vídeo tiene un TTL de 6 horas y sus eventos relacionados se producen durante varias horas:

Evento Hora del evento
Solicitud de anuncio 08:00
Impresión 10:00
Conversión posterior a la vista 11:00

En el informe Histórico, todos estos eventos se atribuyen a las 08:00 horas cuando se realizó la solicitud de anuncio.

Vista de informe histórico

Hora Solicitudes de anuncios Imps Conversiones posteriores a la vista Tasa de relleno Tasa de conversión
08:00 1 1 1 100 % 100 %

Diferencias en comparación con los informes heredados

Heredado informa de eventos de atributo a la hora real del evento. Con el mismo ejemplo, la vista de informes heredada tendría este aspecto:

Hora Solicitudes de anuncios Imps Conversiones posteriores a la vista Tasa de relleno Tasa de conversión
08:00 1 0 0 0% 0%
10:00 0 1 0 0% 0%
11:00 0 0 1 0% 0%

Dado que las marcas de tiempo se controlan de forma diferente, los recuentos de métricas no coincidirán exactamente entre informes históricos e informes heredados cuando se ven en el nivel de día o hora. Esta diferencia se espera y refleja la lógica de atribución subyacente.

Asignaciones de informes

Los informes de Delivery Analytics e Inventory Analytics se consolidan en una única experiencia del generador de informes históricos. Esta integración simplifica los flujos de trabajo de informes y proporciona información ampliada sobre el rendimiento y el inventario que proporciona:

  • Informes consolidados para un análisis completo del rendimiento
  • Cobertura más amplia de métricas y dimensiones
Nombre del informe heredado Nombre del informe asignado Nombre de LA API
Análisis de entrega Informe histórico monetize_creative_brand_analytics
Análisis de inventario Informe histórico monetize_supply_analytics

Nota:

La cobertura de dimensiones y métricas está en curso. Se agregan campos adicionales para admitir el desuso de los tipos de informe heredados.

Informes heredados

Los informes heredados ya no recibirán datos monetizar de Microsoft a partir de early 2026. Los datos históricos seguirán siendo accesibles en función del período de retención estándar de cada informe o 2 years 6 months, lo que sea más corto, con algunas dimensiones específicas del informe con retenciones más cortas de 99 days o 14 months, reflejando la retención de campos equivalentes en informes heredados pertinentes. Estos nuevos tipos de informe incluyen automáticamente datos para todos los tipos de impresiones, excepto para 7=RTB (una transacción de compra en el suministro de otro puesto a su propio) para los vendedores de Monetización de Microsoft.

Nota:

  • La comunicación se proporcionará de antemano para admitir el proceso de transición.
  • Los informes de Microsoft Invest y SSP externos no se incluyen en estos conjuntos de datos.

Tipos de informe heredados

Tipos de informe de red

Los informes consolidan el análisis de entrega e inventario, lo que simplifica el acceso a los datos. En la tabla siguiente se asignan los informes consolidados a sus homólogos heredados y nombres de API:

Nombre del informe de la interfaz de usuario Nombre del informe de API
Análisis de red network_analytics
Revisión de marca del vendedor seller_brand_review
Revisión de marca del vendedor por hora (alfa) seller_brand_review_hourly (alfa)
Red de relleno y entrega de vendedores seller_fill_and_delivery_network
Dominio del sitio de vendedores seller_site_domain
Rendimiento del dominio del sitio network_site_domain_performance
Análisis de dispositivos network_device_analytics
Carrier Analytics network_carrier_analytics
Prebid Server Analytics prebid_server_analytics
Audio Analytics audio_analytics_network

Tipos de informe de anunciante o publicador

Nombre del informe de la interfaz de usuario Nombre del informe de API
Análisis de anunciantes advertiser_analytics
Rendimiento del dominio del sitio site_domain_performance
Análisis de publicador network_publisher_analytics
Not Available publisher_brand_review
Editor de entrega y relleno del vendedor seller_fill_and_delivery_publisher

Creación de informes históricos

El informe histórico permite la creación simplificada de informes. Los usuarios pueden seleccionar entre varias dimensiones, métricas y filtros para personalizar sus informes.

Descripción de la solicitud de anuncio al embudo de impresiones

El informe histórico, que comienza el 12 de noviembre de 2025, incluye métricas que ayudan a analizar el embudo de solicitudes de impresión y a solucionar problemas de integraciones.

Estas métricas estaban disponibles anteriormente en el informe De relleno y entrega de vendedores . Ahora se exponen con dimensiones y filtros más granulares para admitir un análisis más profundo.

Nota:

Las métricas no transaccionales, como las solicitudes de anuncios, las respuestas de anuncios y las solicitudes filtradas , solo se proporcionan para solucionar problemas direccionales y no se deben usar para la facturación ni la conciliación financiera.

Flujo de solicitud de anuncios

En el diagrama siguiente se muestra cómo progresa una solicitud de anuncio a través de Microsoft Monetize, desde la recepción hasta el resultado final.

En la captura de pantalla se muestra el flujo de solicitudes de anuncios.

Ciclo de vida de la solicitud de anuncios

Solicitudes de anuncios recibidas

Solicitudes de anuncios recibidas cuenta el número total de impresiones únicas enviadas a Microsoft Monetize.

  • Cada impresión se cuenta individualmente.
  • Este recuento es independiente de la estructura del mensaje. Por ejemplo, si se incluyen varias impresiones en una única solicitud OpenRTB, cada impresión se cuenta por separado.
  • Esta métrica admite un conjunto limitado de dimensiones y no se puede notificar con determinadas dimensiones, como El sistema operativo.

Solicitudes de anuncios subastadas

Solicitudes de anuncios Subastadas cuenta las impresiones que se enviaron al proceso de subasta.

  • Las impresiones se cuentan con la misma metodología que las solicitudes de anuncios recibidas.
  • Solo se incluyen las impresiones que entran en la subasta.

Filtrado

El primer paso del proceso de subasta evalúa la calidad del inventario.

  • Si se filtra una impresión antes de pujar, se cuenta como una solicitud filtrada.
  • Las solicitudes filtradas se registran con un motivo de solicitud filtrado.
  • Las solicitudes filtradas no proceden a la puja.

Respuestas de anuncios

Si la subasta da como resultado al menos una oferta válida a partir de la demanda administrada o de terceros, se cuenta una respuesta de anuncio .

Impresiones vendidas

Las impresiones se consideran vendidas cuando se recibe un seguimiento de impresiones dentro del TTL (tiempo de vida) para el tipo de contenido multimedia creativo.

Las impresiones pueden ser:

  • Impresiones guardadas (demanda administrada)
  • Impresiones de reventa (demanda de terceros)

Errores del reproductor de vídeo

Los errores del reproductor de vídeo se cuentan cuando se notifica un error de vídeo una vez finalizada la subasta.

Nota:

Es posible que esta métrica no se alinee con el informe de relleno y entrega del vendedor debido a las actualizaciones en la lógica de procesamiento.

Impresiones predeterminadas y sin respuestas

Si la impresión devuelta es una creatividad predeterminada, se cuenta por separado, lo que incluye:

  • Impresiones predeterminadas
  • No hay respuestas predeterminadas (que no son de vídeo)
  • Vídeo sin respuestas predeterminadas

Si no se recibe un seguimiento de impresiones dentro del TTL, el resultado se cuenta como Bid Sent No Responses (Enviar puja sin respuestas).
Este comportamiento se aplica tanto a las creatividades estándar como a las predeterminadas.

Sin demanda apta

Cuando no se puede optar a ninguna demanda administrada, mediante programación o predeterminada, la solicitud se cuenta como Solicitudes de anuncios Sin demanda válida.

  • Las impresiones en blanco se registran para integraciones específicas (por ejemplo, /UT).
  • Las impresiones en blanco no se registran en las integraciones en las que se espera una subasta de bajada (por ejemplo, Prebid).
  • Las PSA se registran cuando no existe ninguna demanda apta y las PSA están habilitadas para la colocación.

Métricas

Nombre de la interfaz de usuario Campo API Description
Solicitudes de anuncios recibidas ad_requests Recuento total de impresiones únicas enviadas a Microsoft Monetize
Solicitudes de anuncios subastadas ad_requests_auctioned Recuento total de impresiones únicas evaluadas para la subasta
Solicitudes filtradas filtered_requests Recuento total de solicitudes en subasta filtradas previa a la puja por la calidad del inventario
Solicitudes de anuncios Sin demanda válida ad_requests_no_creative Recuento total de solicitudes sin ninguna demanda administrada, mediante programación o predeterminada apta
Respuestas de anuncios ad_responses_total Recuento total de subastas con al menos una oferta válida
Respuestas de anuncios de vídeo ad_responses Recuento total de subastas con al menos una oferta de vídeo apta
No se enviaron respuestas a la oferta bid_sent_no_responses Respuestas de puja devueltas, pero en las que la creatividad finalmente no se representó
Valor predeterminado Sin respuestas defaults_no_responses Solicitudes en las que se envió una creatividad predeterminada, pero no se recibió ninguna respuesta
Errores predeterminados de vídeo video_default_errors Errores notificados cuando una creatividad de vídeo predeterminada debería haber servido
Errores del reproductor de vídeo video_player_errors Errores notificados después de la entrega DE VAST XML (máximo 1 por subasta)
Tasa de respuesta response_rate Total de respuestas de anuncios ÷ (solicitudes de anuncios : solicitudes filtradas)
Tasa de victorias win_rate (Impresiones guardadas y revendidas) ÷ total de respuestas de anuncios
Tasa de relleno fill_rate (Impresiones guardadas y revendidas) ÷ solicitudes de anuncios subastadas
RPM de solicitud de anuncios ad_request_rpm Ingresos del vendedor por cada 1000 solicitudes de anuncios subastadas

La oferta no envió respuestas: escenarios comunes

Esta métrica suele producirse cuando Microsoft Advertising devuelve una oferta, pero la creatividad no se representa. Entre los escenarios comunes se incluyen:

  • Un sistema externo (por ejemplo, Prebid o un servidor de anuncios basado en cascada) selecciona una puja diferente.
  • El usuario sale de la página antes de que se active el rastreador de impresiones.
  • La carga diferida impide la representación del anuncio.
  • Se solicita un anuncio de vídeo, pero nunca se reproduce.

Dimensiones disponibles solo para impresiones con transacciones

Para las métricas siguientes:

  • Solicitudes de anuncios recibidas
  • Solicitudes de anuncios subastadas
  • Solicitudes filtradas
  • No se enviaron respuestas a la oferta

Las dimensiones que se enumeran a continuación no se pueden notificar y solo se rellenan cuando se realiza una transacción de una impresión:

  • Métricas de visualización
  • Explorador
  • Creatividad
  • Marca
  • Operador
  • Tipo de oferta
  • Conservador
  • Estado de auditoría

Período de tiempo y retención de datos

Intervalos de tiempo

El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:

  • custom
  • current_hour
  • last_hour
  • today
  • yesterday
  • last_48_hours
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • month_to_yesterday

Período de retención de datos

Nota:

Para ejecutar un informe para un período de tiempo personalizado, establezca los campos start_date y end_date en la solicitud de informe. Para obtener más información sobre estos campos, vea Report Service. En el caso de los informes con una fecha de inicio antes del límite de hora a día, se aplica la hora UTC.

  • Datos por hora: Los datos se conservan durante los últimos 100 días.
  • Datos acumulados: Los datos se conservan durante un máximo de 2 años y 2 meses.
  • Disponibilidad máxima de datos actual: Los datos se conservan durante 90 días (próximas extensiones planeadas).

Intervalos

Los intervalos determinan cómo se agrupan los datos en filas de la respuesta del informe. A continuación se muestra una lista completa de los intervalos disponibles para los informes. Sin embargo, todos los intervalos no están disponibles para cada informe.

  • Cada hora: Los datos se agrupan por hora.
  • Diariamente: Los datos se agrupan por día.
  • Mensual: Los datos se agrupan por mes.
  • Acumulativo: Los datos están cubiertos por un período seleccionado completo.

Filtros

Los filtros permiten limitar los datos mostrados por dimensiones específicas. Los filtros disponibles incluyen:

  • Nombre del anunciante
  • Nombre del publicador
  • Tipo de impresión

Dimensions

Advertencia

Algunas dimensiones, como Device Make y Creative, no se pueden usar juntas. Un mensaje de información indicará combinaciones no disponibles.

Column Tipo ¿Filtrar? Descripción
advertiser string No El anunciante que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
advertiser_id Entero Sí El identificador del anunciante que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
advertiser_name string No Nombre del anunciante que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
bidder Entero No El objeto Bidder (en la mayoría de los casos, se trata de un DSP).
bidder_id Entero Sí Identificador del objeto Xandr Bidder (en la mayoría de los casos se trata de un DSP).
bidder_name Entero No Nombre del objeto Xandr Bidder (en la mayoría de los casos se trata de un DSP).
billing_period_id Entero Sí Identificador del período de facturación
billing_period.booked_imps_budget_daily Entero No Presupuesto diario de impresiones del período de facturación del pedido de inserción.
billing_period.booked_imps_budget_lifetime Entero No Presupuesto de impresiones de duración del período de facturación del pedido de inserción.
billing_period.start_date datetime No La fecha más temprana del período de facturación del pedido de inserción. Nota: Alpha-Beta Aviso: Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
billing_period.end_date datetime No La última fecha del período de facturación del pedido de inserción. Nota: Alpha-Beta Aviso: Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
billing_period.external_code Entero No Código personalizado para el período de facturación.
buyer_member string No Nombre con id. entre corchetes del miembro comprador de Xandr que compró la impresión
buyer_member_id Entero Sí El identificador del miembro comprador de Xandr que compró la impresión
buyer_member_name string No Nombre del miembro comprador de Xandr que compró la impresión
buyer_seat string No El asiento para el Licitador. Esto permite informar sobre los puestos secundarios para los licitadores que no tienen buyer_member_id desgloses.
buyer_seat_id Entero Sí El identificador del asiento para el Licitador. Esto permite informar sobre los puestos secundarios para los licitadores que no tienen buyer_member_id desgloses.
buyer_seat_name string No El nombre del asiento para el Licitante. Esto permite informar sobre los puestos secundarios para los licitadores que no tienen buyer_member_id los desgloses.
buyer_seat_code string No El identificador de asiento del comprador personalizado (enviado por DSP) que se usó para pujar por la impresión
flight_id Entero No Id. del vuelo de artículo de línea con el que se compró la impresión.
flight_booked_impressions_budget_daily Entero No Presupuesto diario de impresiones para el vuelo del artículo de línea.
flight_booked_impressions_budget_lifetime Entero No Presupuesto de impresiones de duración para el vuelo del elemento de línea.
flight_start_date datetime No Fecha de inicio del vuelo del elemento de línea.
flight_end_date datetime No Fecha de finalización del vuelo del elemento de línea.
insertion_order string Sí Orden de inserción que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
insertion_order_id Entero No Identificador del pedido de inserción que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
insertion_order_name string No Nombre del pedido de inserción que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
insertion_order.billing_code string No El código de facturación asociado al pedido de inserción (si hay uno).
insertion_order.end_date datetime No Fecha de finalización del pedido de inserción (para pedidos de inserción heredados).
insertion_order.start_date datetime No Fecha de inicio del pedido de inserción (para pedidos de inserción heredados).
insertion_order.state string No Estado del orden de inserción (por ejemplo, activo, inactivo).
insertion_order.type Entero Sí Tipo de orden de inserción asociado a la impresión (por ejemplo, heredado, sin conexión).
line_item string No Pedido de artículo de línea que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
line_item_id Entero Sí Id. de elemento de línea que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
line_item_name string No Nombre del elemento de línea que compró la impresión. Este será un objeto propiedad del vendedor y se rellenará para una impresión de compra o transacción administrada v2.
line_item.comments string No Cualquier comentario que se haya escrito para este elemento de línea.
line_item.start_date datetime No Fecha de inicio del elemento de línea.
line_item.end_date datetime No Fecha de finalización del elemento de línea.
line_item.status string No Estado del elemento de línea (por ejemplo, activo, inactivo).
line_item_code string No Código externo opcional aplicado al elemento de línea.
li_priority string Sí Prioridad de puja de un elemento de línea que tiene como destino el inventario directo. Para obtener más información, consulte Prioridad de las pujas en la documentación de la interfaz de usuario. Valores posibles: 1 a 20, donde 20 es la prioridad más alta.
li_subtype string Sí Subtipo de elemento de línea (por ejemplo, Aumentada, Oferta, Garantizada).
li_subtype_id Entero No Identificador del subtipo de elemento de línea.
li_subtype_name string No Nombre del subtipo de elemento de línea.
salesrep_for_line_item string Sí Campo de etiqueta de informes personalizado que contiene el representante de ventas. Solo puede seleccionar una etiqueta de informe por informe.
trafficker_for_line_item string Sí Campo de etiqueta de informes personalizado que contiene el tratante. Solo puede seleccionar una etiqueta de informe por informe.
type_for_line_item string Sí Campo de etiqueta de informes personalizado que se usa para enumerar el tipo de elemento de línea (por ejemplo, Retargeting LI). Esto no es lo mismo que el atributo Type descrito anteriormente. Solo puede seleccionar una etiqueta de informe por informe.
insertion_order_type string Sí Campo de etiqueta de informes personalizado que se usa para enumerar el tipo de orden de inserción (por ejemplo, E/S de personalización de marca). Esto no es lo mismo que el atributo Type descrito anteriormente. Solo puede seleccionar una etiqueta de informe por informe.
insertion_order.sales_rep_label string Sí Campo de etiqueta de informes de cliente que se usa para enumerar el representante de ventas asociado al pedido de inserción. Solo puede seleccionar una etiqueta de informe por informe.
insertion_order.trafficker_label string Sí Campo de etiqueta de informes de cliente que se usa para enumerar el tratante asociado al pedido de inserción. Solo puede seleccionar una etiqueta de informe por informe.
placement string No Ubicación de Xandr para la impresión.
placement_id Entero Sí Identificador de la ubicación de Xandr para la impresión.
placement_name string No Nombre de la ubicación de Xandr para la impresión.
placement.code string No Código de la ubicación de Xandr para la impresión.
placement.code2 string No Código de la ubicación de Xandr para la impresión.
placement.code3 string No Código de la ubicación de Xandr para la impresión.
plmt_grp string No Grupo de selección de ubicación de Xandr para la impresión.
plmt_grp_id Entero Sí Identificador del grupo de selección de ubicación de Xandr para la impresión.
plmt_grp.name string No Nombre del grupo de selección de ubicación de Xandr para la impresión.
plmt_grp.code string No Código del grupo de selección de ubicación de Xandr para la impresión.
publisher string No El publicador de Xandr para la impresión.
publisher_id Entero Sí Identificador del publicador de Xandr para la impresión.
publisher_name string No Nombre del publicador de Xandr para la impresión.
brand string No Marca determinada por la auditoría creativa de Xandr o autoasignada para el tráfico administrado
brand_id Entero Sí Identificador de la marca determinado por la auditoría creativa de Xandr o autoasignado para el tráfico administrado
brand_name string No Nombre de la marca determinado por la auditoría creativa de Xandr o autoasignado para el tráfico administrado.
brand_category_id Entero Sí Identificador de categoría primaria de la marca asignada por el creativo
brand_category_name string No Nombre de la categoría primaria de la marca asignada por la creatividad
creative string No Creativo que sirvió. Solo se rellenará para las impresiones administradas.
creative_id Entero Sí El id. de Xandr para el creativo que sirvió.
creative_name string No El nombre Xandr para el creativo que sirvió. El nombre solo se rellenará para las impresiones administradas.
creative_code string No Código de la creatividad.
creative_type string No El tipo de medio de la creatividad que se transi-
creative_type_id Entero No El identificador de tipo de medio de la creatividad que ha transaccionado
size string Sí En el caso de las creatividades de visualización, este es el ancho creativo x alto en píxeles.
domains_exposed_id Entero No Si los dominios de este inventario se exponen para que los compradores los dirijan. Valores permitidos: "Expuesto", "No expuesto"
domains_exposed Entero No Si los dominios de este inventario se exponen para que los compradores los dirijan. Valores permitidos: "Expuesto", "No expuesto"
exposed_for_resale string No Perfil de visualización, utilizado por los vendedores para exponer u ocultar su información de content_categories a los compradores
exposed_for_resale_id Entero No Perfil de visualización, utilizado por los vendedores para exponer u ocultar la información del publicador a los compradores
allowed_media_types_bitmap_name string No Matriz de los tipos de medios permitidos para la impresión
audit_type string No Tipo de auditoría realizada en el dominio donde se produjo la impresión.
audit_type_id Entero Sí Identificador del tipo de auditoría realizada en el dominio donde se produjo la impresión.
audit_type_name string No Nombre del tipo de auditoría realizada en el dominio donde se produjo la impresión.
browser string No El nombre y el identificador del explorador en el que se ha proporcionado la impresión. Para recuperar una lista completa de los identificadores y nombres del explorador, use el Servicio de explorador.
browser_id Entero Sí Identificador del explorador en el que se ha servido la impresión. Para recuperar una lista completa de los identificadores y nombres del explorador, use el Servicio de explorador.
content_category string No Identificador y nombre de la categoría de contenido universal asociada al dominio auditado.
content_category_id Entero Sí Identificador de la categoría de contenido universal asociada al dominio auditado.
content_category_name string No Nombre de la categoría de contenido universal asociada al dominio auditado.
fold_position string No La posición del plegado, es decir, donde se encuentra la ubicación en la página. Para ver los valores permitidos, consulte fold_position_id.
fold_position_id Entero Sí Identificador de la posición del pliegue, es decir, dónde se encuentra la ubicación en la página. Valores posibles para las impresiones: 0 = "unknown", 1 = "above", 2 = "below".
supply_type_id Entero Sí Identificador del tipo de inventario.
supply_type_name string No Tipo de inventario. Valores posibles: "web", "mobile_web", "mobile_app", "facebook_sidebar".
prebid_server_eligible Entero Sí Sí, si PSP era apta para pujar en la subasta por la impresión.
prebid_server_eligible_name string No Sí, si PSP era apta para pujar en la subasta por la impresión.
ssp string No Cuando PSP (bidder_id=443) compra la transacción, este campo mostrará el SSP individual que ha realizado la transacción. De lo contrario, el SSP se registrará como Monetizar.
ssp_id Entero No Cuando PSP (bidder_id=443) compra la transacción, este campo mostrará el SSP individual que ha realizado la transacción. De lo contrario, el SSP se registrará como Monetizar.
ssp_name string No Cuando PSP (bidder_id=443) compra la transacción, este campo mostrará el SSP individual que ha realizado la transacción. De lo contrario, el SSP se registrará como Monetizar.
deal string No El nombre y el identificador de la oferta afectada.
deal_id Entero Sí El identificador de la transacción.
deal_name string No Nombre de la oferta afectada.
deal_type string Sí Valores posibles: Subasta abierta (1), Subasta privada (2), Primer aspecto (3), Garantizado mediante programación (4), Seleccionado (5 - solo relevante para curadores).
revenue_type string No Para los artículos de línea administrados, esta es la base en la que los ingresos reservados se registran para el Vendedor.
revenue_type_id Entero Sí La base en la que el anunciante ha aceptado pagarle por la impresión.
carrier string No El operador del dispositivo en el que se atendió la impresión.
carrier_id Entero Sí Identificador del operador del dispositivo en el que se ha notificado la impresión.
carrier_name string No Nombre del operador del dispositivo en el que se ha servido la impresión.
device_make string No El fabricante del dispositivo
device_make_id Entero Sí Identificador del dispositivo en el que se ha servido la impresión. La marca suele ser el fabricante del dispositivo (es decir, Apple).
device_make_name string No Nombre del dispositivo en el que se ha servido la impresión. La marca suele ser el fabricante del dispositivo (es decir, Apple). Para recuperar una lista completa de identificadores y nombres de creación de dispositivos, use el servicio Device Make.
device_model string No El identificador y el nombre del modelo de dispositivo en el que se ha proporcionado la impresión. El modelo suele ser el producto específico (es decir, iPhone).
device_model_id Entero Sí Identificador del modelo de dispositivo en el que se ha proporcionado la impresión. El modelo suele ser el producto específico (es decir, iPhone).
device_model_name string No Nombre del modelo de dispositivo en el que se ha proporcionado la impresión. El modelo suele ser el producto específico (es decir, iPhone).
device_type string No El tipo de dispositivo del que se originó la impresión. 0=Unknown, 1=PC, 2=Phone, 3=Tablet, 4=TV, 5=Game Console, 6=Media Player, 7=Set top box
device_type_id Entero Sí Identificador del tipo de dispositivo del que se originó la impresión. 0=Unknown, 1=PC, 2=Phone, 3=Tablet, 4=TV, 5=Game Console, 6=Media Player, 7=Set top box
operating_system string No Nombre del sistema operativo del dispositivo seguido del identificador (formato de Microsoft Advertising).
operating_system_id Entero Sí Identificador del sistema operativo del dispositivo.
operating_system_name string No Nombre del sistema operativo del dispositivo.
operating_system_family string No Nombre de la familia del sistema operativo (por ejemplo, Android, Microsoft Windows) del dispositivo seguido del identificador (formato de Microsoft Advertising).
operating_system_family_id Entero Sí Identificador de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
operating_system_family_name string No Nombre de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
curator_member string No Identificador del conservador que estaba presente en la transacción
curator_member_id Entero Sí Identificador del conservador que estaba presente en la transacción
curator_member_name string No Nombre del conservador que estaba presente en la transacción
is_curated booleano Sí Sí si la transacción se produjo a través de un conservador
demand_channel string No El tipo de demanda que compró la impresión. Valores posibles: Administrado (imp_type=5), PSP (bidder_id=443), Standard Deal, Priority Deal, PG Deal, Curation (curator_member_id > 0) y Open Exchange (imp_type=6).
demand_channel_id Entero Sí El tipo de demanda que compró la impresión. Valores posibles: Administrado (imp_type=5), PSP (bidder_id=443), Standard Deal, Priority Deal, PG Deal, Curation (curator_member_id > 0) y Open Exchange (imp_type=6).
demand_channel_name string No El tipo de demanda que compró la impresión. Valores posibles: Administrado (imp_type=5), PSP (bidder_id=443), Standard Deal, Priority Deal, PG Deal, Curation (curator_member_id > 0) y Open Exchange (imp_type=6).
imp_type string No Tipo de transacción. (1=blank, 2=PSA, 3=Default Error, 4=default, 5=kept, 6=resold, 7=RTB, 8=PSA Error, 9=External Impression, 10=External Click, 11=Inserción)
imp_type_id Entero Sí Tipo de transacción. (1=blank, 2=PSA, 3=Default Error, 4=default, 5=kept, 6=resold, 7=RTB, 8=PSA Error, 9=External Impression, 10=External Click, 11=Inserción)
call_type string Sí El controlador impbus del que se originó la impresión
sdk_version string No Versión del SDK de Xandr (AST o Mobile SDK) que se usa para generar la solicitud de anuncio.
mobile_application string No Dominio o aplicación La aplicación a la que se ha asignado la agrupación en la solicitud de anuncio
mobile_application_id Entero No Dominio o aplicación Identificador de la aplicación a la que se ha asignado la agrupación en la solicitud de anuncio
mobile_application_name string No Dominio o aplicación Nombre de la aplicación a la que se ha asignado la agrupación en la solicitud de anuncio
site_domain string No Dominio o aplicación Dominio detectado para la solicitud de anuncio
geo_country string Sí Geografía El código de 2 dígitos del país o región en el que se produjo la impresión. En el caso de las solicitudes de impresiones para las que Xandr no recibió ninguna indicación de que el anuncio se representó (es decir, sin transacciones), no se proporciona información de país o región. La dirección IP del usuario detecta la información de país o región. Nota: Algunas discrepancias son normales con los orígenes de datos externos debido a diferencias entre los métodos de detección de país o región.
geo_country_name string No Nombre del país o región en el que se produjo la impresión. En el caso de las solicitudes de impresiones para las que Xandr no recibió ninguna indicación de que el anuncio se representó (es decir, sin transacciones), no se proporciona información de país o región. La información de país o región se detecta mediante
day date No El día de la subasta
hour date No La hora de la subasta. Nota: En el caso de las impresiones anteriores a 100 días, el día se devolverá en lugar de la hora.
month date No El mes de la subasta
filtered_request_reason string No La razón por la que la solicitud de impresión fue filtrada por los controles de calidad de inventario de Xandr y no se realizó la subasta. Los motivos posibles son: "Dominio no válido" (1), "IP no válida" (2), "Sospecha de manipulación de detección de dominio" (3, 4, 5), "Unknown" (6, 7), "White Ops: General IVT" (17) - consiste en tráfico identificado a través de medios rutinarios de filtración, ejecutado a través de la aplicación de listas o con otras comprobaciones de parámetros estandarizados, "White Ops: Sophisticated IVT" (18) - consta de situaciones más difíciles de detectar que requieren análisis avanzados, corroboración/coordinación de varios puntos, intervención humana significativa, etc., para analizar e identificar, "Impresión válida" (0) también es una razón válida de solicitud filtrada, pero en ese caso, se celebró una subasta y no se filtró.
filtered_request_reason_id Entero No La razón por la que la solicitud de impresión fue filtrada por los controles de calidad de inventario de Xandr y no se realizó la subasta. Los motivos posibles son: "Dominio no válido" (1), "IP no válida" (2), "Sospecha de manipulación de detección de dominio" (3, 4, 5), "Unknown" (6, 7), "White Ops: General IVT" (17) - consiste en tráfico identificado a través de medios rutinarios de filtración, ejecutado a través de la aplicación de listas o con otras comprobaciones de parámetros estandarizados, "White Ops: Sophisticated IVT" (18) - consta de situaciones más difíciles de detectar que requieren análisis avanzados, corroboración/coordinación de varios puntos, intervención humana significativa, etc., para analizar e identificar, "Impresión válida" (0) también es una razón válida de solicitud filtrada, pero en ese caso, se celebró una subasta y no se filtró.
supply_chain_node_count Int Y Número de nodos en el SCHAIN de solicitud de anuncios.
supply_chain_is_complete Cadena Y Indica si schain está marcado como completo en la solicitud de anuncio.
is_gpid_present Cadena Y Indica si un identificador de selección de ubicación global (GPID) estaba presente en la impresión.
Nota:
Este campo es una característica de solo informes y no afecta al valor de GPID en el momento de la subasta. Solo se admite para métricas de impresiones . Un subconjunto de solicitudes de anuncios que no dan lugar a una impresión con transacciones no se puede notificar mediante GPID. Como resultado, es posible que el uso de este campo junto con las métricas de solicitud de anuncios o respuesta no refleje con precisión la cobertura de GPID verdadera y no se recomienda.

Métricas

Nota:

Los ingresos de ajuste no se pueden notificar actualmente. Las métricas de ingresos pueden tener discrepancias menores debido a distintos niveles de agregación.

Columna Tipo Descripción
imps Entero El número de impresiones registradas, de cualquier imp_type. N.B. Para algunos call_types como /OpenRTB2 y /prebid las impresiones en blanco no se registran como imps, ya que normalmente hay una nueva subasta cuando Xandr devuelve ofertas, y no se conocería si la impresión final en blanco o Xandr perdió en la subasta final.
sold_network_rpm double Los ingresos por cada 1000 impresiones que no eran espacios en blanco, valores predeterminados o errores.
total_revenue_ecpm dinero Ingresos totales por 1000 impresiones.
revenue dinero Los ingresos netos totales.
imps_blank Entero Número total de impresiones en las que se ha servido una creatividad en blanco.
imps_default Entero El número total de impresiones en las que se ha servido una creatividad predeterminada porque no había pujas válidas.
imps_default_error Entero Número total de impresiones en las que se ha servido una creatividad predeterminada debido a un problema de tiempo de espera.
imps_kept Entero El número total de impresiones en las que uno de tus anunciantes administrados atendió a un creativo.
imps_resold Entero El número total de impresiones vendidas a un comprador de terceros.
imps_primary_creative Entero Número de obstáculos de nivel de página que sirvieron al maestro creativo. Nota: Alpha-Beta Aviso: Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
imps_psa Entero Número total de impresiones en las que se ha notificado un anuncio de servicio público porque ninguna otra creatividad era apta.
imps_psa_error Entero Número total de impresiones en las que se ha servido un anuncio de servicio público debido a un problema de tiempo de espera.
seller_revenue dinero Los ingresos netos resultantes de un comprador de terceros (al vendedor)
booked_revenue dinero Los ingresos netos aplicados en el elemento de línea que ganó la impresión.
clicks Entero Número de clics grabados. Los clics se desduplican por subasta (por lo que el máximo de 1 clic por subasta única) y tienen un TTL de 6 horas para registrarse. Los clics se pueden medir para los elementos de visualización comprados por Xandr Invest y para creativos de vídeo y nativos de todos los compradores.
total_revenue_ecpc dinero Ingresos totales por clic.
cost dinero El costo de comprar el inventario de terceros a través de un artículo de línea
cpm dinero El costo por 1000 impresiones.
starts Entero Número de eventos de inicio recibidos por Xandr, máximo 1 por subasta.
25_pcts Entero Número de primeros eventos de cuartil recibidos por Xandr, máximo 1 por subasta.
50_pcts Entero Número de eventos de segundo cuartil recibidos por Xandr, máximo 1 por subasta.
75_pcts Entero Número de terceros eventos de cuartil recibidos por Xandr, máximo 1 por subasta.
completions Entero Número de eventos de finalización recibidos por Xandr, máximo 1 por subasta.
errors Entero Número de eventos de error recibidos por Xandr, máximo 1 por subasta.
skips Entero Número de eventos de omisión recibidos por Xandr, máximo 1 por subasta.
start_rate double video_starts/imps
video_25_pct_completion_rate double video_25_pcts/video_starts
video_50_pct_completion_rate double video_50_pcts/video_starts
video_75_pct_completion_rate double video_75_pcts/video_starts
video_skip_rate double video_skips/video_starts
started_video_completion_rate double Finalizaciones de vídeo por carga (video_completions/video_starts)
revenue_per_video_complete double Ingresos por finalización de vídeo.
view_measured_imps Entero Número total de impresiones medidas para la visibilidad
imps_viewed Entero Número total de impresiones medidas como visibles por el script de visualización de Xandr
view_measurement_rate double Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver imps/imps medidos)
view_rate double Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. (Imps/View Measured Imps)
total_revenue_vcpm dinero Ingresos totales por 1000 impresiones visibles.
ad_requests Entero El número de subastas únicas que Xandr consideró para la subasta, antes de que se aplicara cualquier filtración. N.B. Una llamada de anuncio puede contener varias etiquetas. En este escenario, contaríamos una solicitud de anuncio para cada etiqueta dentro del mensaje de solicitud de anuncio.
filtered_requests Entero Número de subastas únicas que Xandr filtró debido a las comprobaciones de calidad del inventario
external_click Entero Hace clic según lo registrado por el clicktracker externo.
external_impression Entero Imps según lo registrado por el rastreador de impresiones externo.
total_revenue_ecpa dinero Ingresos totales por adquisición.
ad_requests Recuento total de impresiones únicas enviadas a Microsoft Monetize
ad_requests_auctioned Recuento total de impresiones únicas evaluadas para la subasta
filtered_requests Recuento total de solicitudes en subasta filtradas previa a la puja por la calidad del inventario
ad_requests_no_creative Recuento total de solicitudes sin ninguna demanda administrada, mediante programación o predeterminada apta
ad_responses_total Recuento total de subastas con al menos una oferta válida
ad_responses Recuento total de subastas con al menos una oferta de vídeo apta
bid_sent_no_responses Respuestas de puja devueltas, pero en las que la creatividad finalmente no se representó
defaults_no_responses Solicitudes en las que se envió una creatividad predeterminada, pero no se recibió ninguna respuesta
video_default_errors Errores notificados cuando una creatividad de vídeo predeterminada debería haber servido
video_player_errors Errores notificados después de la entrega DE VAST XML (máximo 1 por subasta)
response_rate Total de respuestas de anuncios ÷ (solicitudes de anuncios : solicitudes filtradas)
win_rate (Impresiones guardadas y revendidas) ÷ total de respuestas de anuncios
fill_rate (Impresiones guardadas y revendidas) ÷ solicitudes de anuncios subastadas
ad_request_rpm Ingresos del vendedor por cada 1000 solicitudes de anuncios subastadas

Ejemplos

Creación de la solicitud de informe con formato JSON

El archivo JSON debe incluir el report_type monetize_supply_analytics o monetize_creative_brand_analytics, así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (año, mes, día) y especificar el formato en el que se deben devolver los datos (csv, excel o html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte [Report Service[(report-service.md)].


$ cat monetize_supply_analytics.json
{
    "report": {
        "report_type": "monetize_supply_analytics",
        "columns": ["hour", "seller_member_name", "buyer_member_name", "advertiser_name", "publisher_name", "imps", "clicks"],
        "report_interval": "last_48_hours",
        "format": "csv"
    }
}

POST the request to the Reporting service


$ curl -b cookies -X POST -d @ monetize_supply_analytics 'https://api.appnexus.com/report'
{
   "response": {
      "status": "OK",
      "report_id": "097f59fc3ab7d02c5d60db42081d9b69"
   }
}

OBTENER el estado del informe del servicio de informes

Después de enviar una solicitud de informe, use el método GET para comprobar el estado.

Ejemplo de solicitud

Realice una llamada GET con el identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status sea ready. A continuación, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.

$ curl -b cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69' 

{ 

   "response":{ 
      "status":"OK", 
      "report":{ 
         "name":null, 
         "created_on":"2010-05-25 19:19:53", 
         "json_request":"{\"report\":{\"report_type\":\"monetize_supply_analytics\",\"columns\":[\"hour\",\"seller_member_name\", 
            \"buyer_member_name\",\"advertiser_name\",\"publisher_name\",\"imps\",\"clicks\"], 
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"], 
            \"report_interval\":\"last_48_hours\"}}", 
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592" 
      }, 
      "execution_status":"ready" 
   } 
}

OBTENER los datos del informe del servicio de descarga de informes

Para descargar los datos del informe en un archivo, realice otra GET llamada con el identificador de informe, pero esta vez al servicio de descarga de informes. Puede encontrar el servicio y el identificador de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo de format que especificó en su inicial POST.

Nota:

Si se produce un error durante la descarga, el encabezado de respuesta incluirá un código de error HTTP y un mensaje. Use -i o -v en la llamada para exponer el encabezado de respuesta.

curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/monetize_supply_analytics.csv

Sugerencia

Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.

  • Last updated on