Informe de métricas de la oferta de vendedores

Artículo
05/17/2024

El informe Métricas de la oferta de vendedores proporciona información clave sobre las métricas de la oferta, el rendimiento y los motivos de rechazo que son relevantes para el vendedor.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente.

Período de tiempo

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

Personalizado
hoy
yesterday
last_2_days
last_7_days (sin incluir hoy)
last_14_days
last_30_days

Sugerencia

Para ejecutar un informe para un período de tiempo personalizado, establezca los campos y end_date en la start_date solicitud de informe. Para obtener más información sobre estos campos, vea Report Service.

Período de retención de datos

El período de retención de datos para este informe es de 30 días.

Dimensions

Column	¿Filtro?	Descripción
`hour`	Sí	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.
`day`	Yes	El día de la subasta.
`month`	Yes	El mes de la subasta.
`buyer_member`	Yes	El identificador y el nombre del miembro cuyo anunciante compró la impresión.
`buyer_member_id`	Yes	El identificador del comprador que compró la impresión.
`buyer_member_name`	Yes	El comprador específico que compró la impresión.
`buyer_seat_id`	Yes	El identificador del asiento del comprador.
`buyer_seat_name`	No	Nombre para mostrar del código de asiento del comprador.
`buyer_seat_code`	No	El id. de asiento del comprador personalizado (enviado por DSP) que se usó para pujar por la impresión.
`seller_member_id`	Yes	El identificador de miembro del vendedor cuyo inventario le interesa.
`deal`	Yes	El trato asociado a la impresión.
`deal_id`	Yes	Identificador de la oferta a la que se aplica la configuración.
`deal_name`	Yes	Trato asociado a la transacción para la impresión.
`ask_price`	Yes	El precio de la oferta.
`start_date`	Yes	El día y la hora en que la oferta comienza a estar disponible para el comprador.
`end_date`	Yes	El día y la hora en que la oferta deja de estar disponible para el comprador.
`metric_type`	Yes	El tipo de métrica que se usa para medir el rendimiento de las campañas.
`deal_auction_type_name`	Yes	Tipo de subasta de la oferta. Una oferta puede tener los siguientes tipos de subasta: primer precio, segundo precio y precio fijo.
`deal_type_name`	Yes	Si el acuerdo es un acuerdo público, privado o garantizado mediante programación.
`deal_alias`	No	Alias de la oferta.
`package_id`	Yes	Identificador del paquete desde el que se creó la oferta. Este valor será `0` si la oferta no se creó a partir de un paquete.
`priority`	Yes	Solo para una subasta privada, la prioridad que el vendedor asignó a la oferta.

Métricas

Column	Tipo	Filtro	Descripción
`imps_matched`	Entero	Yes	El número total de impresiones que coinciden con la configuración del vendedor (no la del comprador) en la oferta.
`bid_requests`	Entero	Yes	Número de solicitudes de puja.
`bids`	Entero	Yes	El número de veces que un comprador puja.
`final_bids`	Entero	Yes	El número de subastas en las que un comprador puja.
`imps_won`	Entero	Yes	Número total de impresiones ganadas.
`seller_revenue`	Moneda	Yes	Los ingresos del vendedor en la oferta.
`seller_revenue_ecpm`	Moneda	Yes	Los ingresos del vendedor en la oferta, representados en eCPM.
`average_net_bid`	Moneda	Yes	La oferta neta media de la oferta. Este es el precio de la oferta que es neto de todas las tarifas y se usa para determinar los ingresos del vendedor (antes de cualquier reducción del precio de la oferta que pueda producirse).
`average_floor_price`	Moneda	Yes	El precio medio del piso para la oferta.
`bid_rate`	Entero	Yes	Porcentaje de subastas en las que el comprador puja.
`ineligible_bid_rate`	Entero	Yes	La tasa de ofertas inelegibles en el acuerdo.
`gross_win_rate`	Entero	Yes	La tasa bruta de ganancias para el trato.
`net_win_rate`	Entero	Yes	La tasa neta de ganancias de la oferta.
`reject_count`	Entero	Yes	Número total de ofertas rechazadas.
`reject_bidder_error_count`	Entero	Yes	Número de ofertas rechazadas debido a errores del licitador.
`reject_blocked_by_ad_profile_count`	Entero	Yes	La suma de todas las pujas rechazadas por el perfil de anuncio.
`reject_below_floor_count`	Entero	Yes	El número de ofertas rechazadas porque están por debajo del precio de reserva establecido en la subasta.
`reject_blocked_by_deal_count`	Entero	Yes	La suma de todas las ofertas rechazadas debido a restricciones de la oferta.
`reject_invalid_creative_count`	Entero	Yes	Número de ofertas rechazadas debido a creatividades no válidas con las que el comprador puja.
`reject_blocked_by_dynamic_adserver_count`	Entero	Yes	Número de ofertas rechazadas debido a restricciones de adserver que el vendedor ha pasado dinámicamente en el momento de la solicitud de impresión.
`reject_other_count`	Entero	Yes	El número de ofertas rechazadas por razones que no se enumeran aquí.
`reject_bidder_error_deal_not_available_count`	Entero	Yes	Número de ofertas rechazadas porque la oferta ya no estaba disponible.
`reject_blocked_by_ad_profile_creative_count`	Entero	Yes	Número de pujas rechazadas porque el perfil de anuncio bloqueó el servidor de anuncios creativos.
`reject_blocked_by_ad_profile_language_count`	Entero	Yes	Número de pujas rechazadas porque el perfil del anuncio bloqueó el idioma del anuncio.
`reject_blocked_by_ad_profile_tech_attribute_count`	Entero	Yes	El número de pujas rechazadas porque el perfil del anuncio bloqueó un atributo técnico del anuncio.
`reject_blocked_by_ad_profile_category_count`	Entero	Yes	Número de pujas rechazadas porque el perfil de anuncio no permite la categoría de la creatividad.
`reject_blocked_by_ad_profile_brand_count`	Entero	Yes	Número de pujas bloqueadas por el perfil de anuncio debido a exclusiones de marca.
`reject_blocked_by_ad_profile_adserver_count`	Entero	Yes	Número de pujas rechazadas porque se bloquea un servidor de anuncios asociado a la creatividad con la que puja el comprador.
`reject_blocked_by_ad_profile_member_count`	Entero	Yes	Número de pujas rechazadas porque el perfil de anuncio bloqueó al miembro.
`reject_blocked_by_ad_profile_audit_status_count`	Entero	Yes	Número de pujas bloqueadas por el perfil de anuncio debido a su estado de auditoría. Esto suele ocurrir cuando el comprador está pujando con una creatividad no auditada y el vendedor ha bloqueado las creatividades no auditadas en la calidad del anuncio.
`reject_below_floor_ym_count`	Entero	Yes	El número de ofertas rechazadas porque están por debajo del límite de rendimiento aplicable a la subasta.
`reject_invalid_creative_not_ssl_count`	Entero	Yes	El número de ofertas rechazadas debido a que la creatividad no está aprobada por SSL para una subasta segura.
`reject_blocked_by_deal_creative_count`	Entero	Yes	El número de ofertas bloqueadas por la oferta debido a su número creativo.
`reject_blocked_by_deal_language_count`	Entero	Yes	El número de ofertas bloqueadas por la oferta debido a su configuración de idioma.
`reject_blocked_by_deal_tech_attribute_count`	Entero	Yes	Número de ofertas rechazadas porque la oferta bloqueó un atributo técnico.
`reject_blocked_by_deal_category_count`	Entero	Yes	Número de ofertas rechazadas porque la oferta no permite la categoría de la creatividad.
`reject_blocked_by_deal_brand_count`	Entero	Yes	Número de ofertas rechazadas porque la oferta bloqueó su marca.
`reject_blocked_by_deal_below_floor_count`	Entero	Yes	El número de ofertas rechazadas porque estaban por debajo del piso aplicable para la subasta.
`reject_blocked_by_deal_media_subtype_count`	Entero	Yes	Número de ofertas rechazadas debido a sus subtipos multimedia.
`reject_blocked_by_deal_size_count`	Entero	Yes	El número de ofertas rechazadas porque no coincidían con los requisitos de tamaño de la oferta.
`reject_blocked_by_deal_payment_type_count`	Entero	Yes	Número de pujas rechazadas porque la oferta no permitió su tipo de pago.
`reject_blocked_by_deal_adserver_count`	Entero	Yes	Número de pujas bloqueadas por debido a restricciones de adserver en la oferta.
`reject_blocked_by_dynamic_brand_count`	Entero	Yes	Número de pujas rechazadas porque la solicitud de puja que ha pasado el vendedor bloquea dinámicamente la marca.
`reject_blocked_by_dynamic_language_count`	Entero	Yes	El número de ofertas rechazadas porque el idioma está bloqueado dinámicamente por la solicitud de puja pasada por el vendedor.
`reject_blocked_by_dynamic_tech_attribute_count`	Entero	Yes	El número de pujas rechazadas porque sus atributos techincal se bloquean dinámicamente mediante la solicitud de puja pasada por el vendedor.
`reject_blocked_by_dynamic_category_count`	Entero	Sí	Número de ofertas rechazadas porque la solicitud de puja que ha pasado el vendedor bloquea dinámicamente la categoría creativa.
`reject_other_data_protection_count`	Entero	Sí	Número total de ofertas rechazadas por motivos de seguridad de datos que no se enumeran aquí.
`reject_other_advertiser_exclusion_count`	Entero	Sí	El número total de ofertas rechazadas debido a exclusiones de anunciantes que no se mencionan anteriormente.
`reject_blocked_by_deal_advertiser_exclusion_count`	Entero	Sí	Número de ofertas rechazadas debido a exclusiones de anunciantes que no aparecen aquí.

Ejemplo

Create una solicitud de informe con formato JSON

El archivo JSON debe incluir el report_type de "seller_deal_metrics_report", así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (, , ) y especificar en el "format" que se deben devolver los datos (csv, excelo html). daymonthyear Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.

$ cat seller_deal_metrics_report
 
{
    "report": {
        "report_type": "seller_deal_metrics_report",
        "columns": [
            "hour",
            "buyer_member_name",
            "deal_name",
            "start_date",
            "end_date",
            "bids",
            "average_net_bid",
            "imps_won",
            "seller_revenue",
            "reject_count"
        ],
        "report_interval": "last_7_days",
        "format": "csv"
    }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -X POST -d @seller_deal_metrics_report 'https://api.appnexus.com/report'
{
    "response": {
        "report_id": "2630ab93193a0b14257f154b7912ac5f",
        "status": "OK",
        "dbg_info": {
            "user::read_limit": 100,
            "user::write_limit": 60,
            "read_limit": 100,
            "write_limit": 60,
            "user::read_limit_seconds": 60,
            "user::write_limit_seconds": 60,
            "read_limit_seconds": 60,
            "write_limit_seconds": 60,
            "instance": "50.bm-report-processor.prod.nym2",
            "version": "1.73.249",
            "time": 280.62701225281,
            "start_microtime": 1694609672,
            "warnings": [],
            "api_cache_hit": "0",
            "output_term": "report_id"
        }
    }
}

`GET` estado del informe del servicio de informes

Realice una GET llamada 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=2630ab93193a0b14257f154b7912ac5f'
{
    "response": {
        "status": "OK",
        "report": {
            "id": "2630ab93193a0b14257f154b7912ac5f",
            "name": "",
            "created_on": "2023-09-13 12:54:32",
            "cache_hit": true,
            "fact_cache_hit": false,
            "fact_cache_error": "",
            "json_request": "{\"report\":{\"report_type\":\"seller_deal_metrics_report\",\"columns\":[\"hour\",\"buyer_member_name\",\"deal_name\",\"start_date\",\"end_date\",\"bids\",\"average_net_bid\",\"imps_won\",\"seller_revenue\",\"reject_count\"],\"report_interval\":\"last_7_days\",\"format\":\"csv\",\"grouping\":{\"additional_grouping_sets\":[],\"unselected_implicit_groupings\":[],\"additional_groups_on_bottom\":true},\"timezone\":\"UTC\",\"filters\":[{\"seller_member_id\":\"958\"},{\"metric_type\":{\"value\":[\"0\"],\"operator\":\"=\"}}],\"reporting_decimal_type\":\"decimal\",\"use_cache\":true},\"extraction_version\":\"refactored\",\"end_date\":1694563200,\"start_date\":1693958400,\"user_id\":\"4814\"}",
            "header_info": "Report type: seller_deal_metrics_reports\nReport ID: 2630ab93193a0b14257f154b7912ac5f\nRun at: 2023-09-13 12:55:17 UTC\nRequested Start date: 2023-09-06 00:00:00 UTC\nRequested End date: 2023-09-13 00:00:00 UTC\nTimezone: UTC\n",
            "user_id": "4814",
            "member_id": "958",
            "bidder_id": "2",
            "entity_id": "958",
            "row_count": 29112,
            "report_size": 3271276,
            "url": "report-download?id=2630ab93193a0b14257f154b7912ac5f"
        },
        "execution_status": "ready",
        "_was_this_status_cached_": 0,
        "dbg_info": {
            "user::read_limit": 100,
            "user::write_limit": 60,
            "read_limit": 100,
            "write_limit": 60,
            "user::read_limit_seconds": 60,
            "user::write_limit_seconds": 60,
            "read_limit_seconds": 60,
            "write_limit_seconds": 60,
            "instance": "47.bm-report-processor.prod.nym2",
            "version": "1.73.249",
            "time": 550.46796798706,
            "start_microtime": 1694609717,
            "warnings": [],
            "api_cache_hit": "0",
            "output_term": "report"
        }
    }
}

`GET` 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.

Sugerencia

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=2630ab93193a0b14257f154b7912ac5f' > /tmp/seller_deal_metrics_report.csv

Compartir a través de

Informe de métricas de la oferta de vendedores

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe con formato JSON

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes

Recursos adicionales

Compartir a través de

Informe de métricas de la oferta de vendedores

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe con formato JSON

POST la solicitud al servicio de informes

GET estado del informe del servicio de informes

GET los datos del informe del servicio de descarga de informes

Recursos adicionales

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes