API de plataforma digital: métricas de ofertas de vendedores multiventas
El informe Métricas de la oferta de vendedores multi-comprador 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
- yesterday
- hoy
- last_2 _days
- last_7_days (sin incluir hoy)
- last_14_Days
- last_30_days
Período de retención de datos
El período de retención de datos para este informe es de 30 días.
Nota:
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.
Dimensions
| Column | ¿Filtro? | Descripción |
|---|---|---|
ask_price |
Sí | El precio de la oferta. |
bidder_id |
Yes | Id. del postor (DSP) para la impresión. |
bidder_name |
No | Nombre del postor (DSP) para la impresión. |
buyer_member_name |
Sí | El comprador específico que compró la impresión. |
buyer_member_id |
Yes | El identificador del comprador que compró la impresión. |
deal_auction_type_name |
Yes | Tipo de subasta de la oferta. Una oferta puede tener los siguientes tipos de subasta: - first price - second price - fixed price |
deal_buyer_type |
Yes | Seleccione esta opción para filtrar por el tipo de comprador por el que se ha servido la impresión. Posibles valores: - "Entire Deal" - "Bidder" - "Buyer Member" - "Buyer Seat"Nota: Esta dimensión es obligatoria en el informe de métricas de ofertas de varios compradores. Para no ver los datos desglosados por tipo de comprador de la oferta, filtre por Oferta completa. |
deal_name |
Yes | Trato asociado a la transacción para la impresión. |
deal_type_name |
Yes | Si el acuerdo es un acuerdo público, privado o garantizado mediante programación. |
end_date |
Yes | El día y la hora en que la oferta deja de estar disponible para el comprador. |
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. |
start_date |
Yes | El día y la hora en que la oferta comienza a estar disponible para el comprador. |
Métricas
| Column | Tipo | ¿Filtro? | Description |
|---|---|---|---|
hour |
time | 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. |
day |
time | No | El día de la subasta. |
month |
time | No | El mes de la subasta. |
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 | Número de ofertas completadas. |
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_biased_bid |
Moneda | Yes | La oferta media sesgada para el acuerdo. Este es el precio de la oferta utilizado con fines de clasificación en la subasta. |
average_floor_price |
Moneda | Yes | El precio medio del piso para la oferta. |
deal_type_name |
string | Sí | Si el acuerdo es un trato público o privado. |
bid_rate |
Entero | Yes | La tasa de pujas en el trato. |
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. |
ask_price |
Moneda | Yes | El precio 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 configuración de idioma. |
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 ofertas rechazadas porque sus atributos técnicos se bloquean dinámicamente mediante la solicitud de puja pasada por el vendedor. |
reject_blocked_by_dynamic_category_count |
Entero | Yes | 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 | Yes | Número total de ofertas rechazadas por motivos de seguridad de datos que no se enumeran aquí. |
reject_other_advertiser_exclusion_count |
Entero | Yes | El número total de ofertas rechazadas debido a exclusiones de anunciantes que no se mencionan anteriormente. |
Ejemplo
Create una solicitud de informe con formato JSON
El archivo JSON debe incluir el report_type de "multi_buyer_seller_deal_metrics", así como ( columns 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", "excel"o "html"). daymonthyear Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.
$ cat multi_buyer_seller_deal_metrics
{
"report": {
"report_type": "multi_buyer_seller_deal_metrics",
"columns": [
"hour",
"buyer_member_name",
"deal_name",
"start_date",
"end_date",
"average_net_bid",
"imps_won",
"seller_revenue",
"reject_count"
],
"filters": [{
"deal_buyer_type": ["Buyer Member"]
}],
"report_interval": "last_7_days",
"format": "csv"
}
}
POST la solicitud al servicio de informes
$ curl -b cookies -X POST -d @multi_buyer_seller_deal_metrics 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"b97897a7864dd8f34e7457226c7af592"
}
}
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=b97897a7864dd8f34e7457226c7af592'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2010-05-25 19:19:53",
"json_request": "{\"report\":{\"report_type\":\"multi_buyer_seller_deal_metrics\",\"columns\":[\"hour\",\
"buyer_member_name\",\"deal_name\",\"start_date\",\"end_date\",\"average_net_bid\",\"imps_won\",\"seller_revenue\,\"reject_count\"],\
"row_per\":[\"hour\",\"buyer_member_id\",\"deal_id\"],\
"report_interval\":\"last_7_days\"}}",
"url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"execution_status": "ready"
}
}
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.
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/multi_buyer_seller_deal_metrics.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.