API de plataforma digital: informe de red de entrega y relleno de vendedores

Artículo
05/17/2024

El informe de entrega y relleno de vendedores se diseñó como una herramienta de solución de problemas para proporcionar a los vendedores información pormenorizada sobre todas las impresiones enviadas a Xandr para la subasta y para ayudar a diagnosticar problemas de entrega hasta el nivel de etiqueta y dominio. Con los nuevos campos descriptivos, es posible ver una aproximación de la tasa de relleno general en Xandr mediante las métricas "Total de respuestas de anuncios" y "Total de solicitudes de anuncios".

Nota:

Este informe solo proporciona instrucciones direccionales sobre posibles áreas para solucionar problemas. Las cifras de este informe pueden ver ligeras discrepancias con otros informes estándar, incluidos el informe de Análisis de red y el informe de Video Analytics.
Se recomienda ver cada informe de forma independiente y no comparar las cifras direccionales del informe de entrega y relleno del vendedor con otros informes Xandr, para evitar confusiones innecesarias.

Los datos contenidos en este informe ayudarán a identificar los problemas que contribuyen a impresiones no transactadas derivadas de:

Configuración incorrecta de etiquetas predeterminadas o de devolución de contraseña
Listas de bloqueo de inventario relacionadas con el bloqueo de ip o dominio
Errores del reproductor de vídeo, etc.

Nota:

Solo para los vendedores de vídeos

Como resultado del almacenamiento en caché de vídeo por parte de los reproductores de vídeo, la canalización de datos Xandr permite que una ventana de seis horas registre una respuesta de un reproductor de vídeo una vez completada la subasta y el archivo XML vasto creativo se haya enviado a la página, antes de considerar una impresión de vídeo "no sensible" (Bid Sent No Response). Xandr actualizará algunos recuentos, solo para etiquetas de vídeo, seis horas después de la hora de la subasta. Por lo tanto, para recibir la vista más precisa de los recuentos de vídeo en todas las dimensiones, programe que los informes se ejecuten después de la ventana de seis horas para una hora determinada de datos.

Diagrama que muestra el proceso implicado en la generación del total de respuestas de anuncios.

Período de tiempo

El report_interval campo de la solicitud JSON debe establecerse en uno de los siguientes:

last_48_hours
hoy
yesterday
last_7_days
last_24_days
last_14_days
last_2_days
month_to_date
quarter_to_date
last_month
last_available_day
last_7_available_days
last_14_available_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 403 días.

El time_granularity valor de los datos es hourly. Para obtener instrucciones sobre cómo recuperar un informe, consulte report service o el ejemplo siguiente.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
`month`	date	No	`"2010-02"`	El mes de la subasta.
`day`	date	No	`"2010-02-01"`	El día de la subasta.
`hour`	time	No	`"2010-02-01 06:00:00"`	La hora de la subasta.
`seller_member_id`	Entero	Yes	`2718`	Id. de miembro Xandr del vendedor.
`seller_member_name`	string	No	`"MegaSeller"`	El nombre del vendedor.
`seller_member`	string	No	`"MegaSeller (2718)"`	Una descripción completa del vendedor, incluidos los `seller_member_name` valores y `seller_member_id`.
`placement_id`	Entero	Yes	`737099`	Identificador de la ubicación donde se produjo la impresión.
`placement_name`	string	No	`"Webmail.com ROS 728x90"`	Nombre de la ubicación donde se produjo la impresión.
`publisher_id`	Entero	Yes	`44389`	Identificador asociado al publicador en cuyo sitio se produjo la impresión.
`publisher_name`	string	No	`"LOL - US"`	Nombre del publicador en cuyo sitio se produjo la impresión.
`publisher`	string	Sí	`"LOL - US (44389)"`	Descripción completa del publicador en cuyo sitio se produjo la impresión, incluidos y `publisher_namepublisher_id`.
`geo_country`	string	Sí	`"US"`	El código del país geográfico.
`geo_country_name`	string	No	`"United States"`	Nombre del país geográfico.
`site_id`	Entero	Yes	`223936`	Identificador del sitio que contiene esta ubicación.
`site_name`	string	No	`"Total-Web Email"`	Nombre del sitio donde se produjo la impresión.
`site`	string	No	`"Total-Web Email (223936)"`	Una descripción completa del sitio donde se produjo la impresión, incluidos y `site_namesite_id`.
`deal_id`	Entero	Yes	`2345`	El identificador de la transacción. Para obtener más información sobre las ofertas negociadas entre compradores y vendedores, consulte Servicio de oferta y Servicio de acceso de compradores de ofertas.
`deal_name`	string	No	`"Private deal for buyer 1085 with floor of $2.50"`	Nombre de la oferta.
`deal`	string	No	`"Private deal for buyer 1085 with floor of $2.50 (45)"`	Nombre de la oferta seguido del identificador (formato Xandr).
`mobile_application_id`	string	No	`'343200656' (iOS) or 'com.rovio.angrybirds' (Android)`	Un identificador de apple App Store de destino, un nombre de paquete de Google Play o un identificador de aplicación de Windows.
`site_domain`	string	No	`"gwar-rules-forever.org"`	Dominio donde se produjo la impresión. Hay un valor adicional que puede aparecer en lugar de un dominio: `"---"`: esto significa que no recibimos un dominio válido como referencia. Por ejemplo, el dominio puede estar en blanco o de otro modo malformado.
`supply_type`	string	Sí	`mobile_web`	El canal clasificado por el vendedor para denominar el suministro en términos de web, web optimizado para dispositivos móviles e impresiones de aplicaciones móviles. Los valores posibles son: - `'web'` - `'mobile_app'` - `'mobile_web'`.
`call_type`	string	Sí	`"/ttj"`	Tipo de controlador que se usó para enviar la impresión a Xandr (por ejemplo, `ttj`, , `utmob`, , `ptvopenrtb`)
`allowed_media_types`	string	No	`Banner`, `Expandable`, `Native`	Los tipos de medios que pueden participar en la subasta. Los tipos de medios permitidos son una combinación que se habilita a través de la configuración de llamada de anuncio y ubicación.
`openrtb2_request_subdomain`	string	No	`wrapper-emea`	Subdominio de la dirección URL a la que se envió la solicitud de anuncio de OpenRTB2. Nota: Este valor está en blanco para los tipos de llamada que no son de OpenRTB2. Un valor en blanco en OpenRTB2 indica que no se usó ningún subdominio.

Métricas

Column	Tipo	Fórmula	Description
`filtered_requests`	Entero		Solicitudes de anuncios filtradas previamente por Xandr para la calidad del inventario.
`imps_kept`	Entero		Una impresión en la que la creatividad de un anunciante administrado sirve en el sitio de un publicador administrado.
`imps_resold`	Entero		Una impresión que se revendió a un comprador de terceros.
`seller_revenue`	Dinero		Ingresos obtenidos por el Vendedor.
`defaults`	Entero		Solicitudes de anuncios en las que se ha servido una creatividad predeterminada porque no había pujas válidas.
`video_player_errors`	Entero		Errores notificados desde el reproductor de vídeo después de que se haya entregado EL XML VAST.
`video_default_errors`	Entero		Errores notificados desde el reproductor de vídeo cuando una creatividad predeterminada debería haber servido.
`bid_sent_no_responses`	Entero		Respuestas de puja devueltas por Xandr en las que, en última instancia, la creatividad no se representa. El escenario más común en el que esto ocurre es cuando Xandr recibe una solicitud de anuncio de un sistema externo (como un servidor de anuncios del publicador que usa prebid o una cascada tradicional) y devuelve una respuesta, pero el sistema externo selecciona una puja diferente. Otros ejemplos de motivos por los que esto puede ocurrir son: - El usuario final sale de la página antes de que se active el rastreador de impresiones. - Se solicita un anuncio, pero nunca se carga debido a la carga diferida. - Un reproductor de vídeo solicita un anuncio, pero nunca reproduce el anuncio.
`default_no_responses`	Entero		Solicitudes de anuncios en las que se envió una creatividad predeterminada, pero no se recibió ninguna respuesta del servidor de anuncios final. Esto podría ser el resultado de un error o el servidor de anuncios final eligió una etiqueta predeterminada alternativa.
`psas_or_blanks`	Entero		Número de espacios en blanco o PSA servidos.
`total_ad_requests`	Entero	filtered_requests + imps_kept + imps_resold + valores predeterminados + video_player_errors + video_default_errors + bid_sent_no_responses + default_no_responses + psas_or_blanks	Número total de solicitudes de anuncios enviadas a Xandr para la subasta.
`total_ad_responses`	Entero	imps_kept + imps_resold + video_player_errors + bid_sent_no_responses	Número total de respuestas de anuncios que se cuentan en Xandr.
`response_rate`	double	total_ad_responses/ (total_ad_requests - filtered_requests)	La tasa de número total de respuestas de anuncios que Xandr cuenta con el número de solicitudes de anuncios que Xandr no ha filtrado previamente a la puja.
`win_rate`	double	(imps_resold+imps_kept)/total_ad_responses	Tasa del número total de impresiones administradas y mantenidas en el número total de respuestas de anuncios que se cuentan en Xandr.
`filtered_request_rate`	double	filtered_requests/total_ad_requests	Tasa de solicitudes filtradas al número total de solicitudes de anuncios enviadas a Xandr para la subasta.
`fill_rate`	double	(imps_resold+imps_kept)/total_ad_requests	Tasa del número total de revendidas y impresiones guardadas en el número total de solicitudes de anuncios enviadas a Xandr para la subasta.
`rpm`	Dinero	(seller_revenue/total_ad_requests)*1000	Para obtener una definición de `rpm`, consulte el Glosario. En este informe, las rpm son ingresos del vendedor obtenidos por cada 1000 solicitudes de anuncios enviadas a Xandr para la subasta.
`ecpm`	Dinero	(seller_revenue/imps_resold)*1000	Para obtener una definición de `ecpm`, consulte el Glosario. En este informe, ecpm es ingresos del vendedor obtenidos por cada 1000 impresiones revendidas a un comprador de terceros.

Ejemplo

Create una solicitud de informe JSON

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

$ cat seller_fill_and_delivery_network

{"report":
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["geo_country"],
        "columns":["placement_id","imps_kept","total_ad_responses","total_ad_requests","geo_country"],
        "report_type": "seller_fill_and_delivery_network"
    }
}

`POST` la solicitud al servicio de informes

POST la solicitud JSON para recuperar un identificador de informe.

$ curl -b cookies -c cookies -X post -d @seller_fill_and_delivery_network "https://api.appnexus.com/report"

{
   "response":{
      "status":"OK",
      "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
   }
}

`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 -c cookies 'https://api.appnexus.com/report?id=c445bca183a3d338dc1c5b85a3d484f5'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 22:33:31",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"placement_id\",\"imps_kept\",\"total_ad_responses\",\"total_ad_requests\",\"geo_country\"],\"report_type\":\"seller_fill_and_delivery_network\",\"filters\":[{\"seller_member_id\":\"958\"}]}}",
            "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
        },
        "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 reportID en el url campo de la respuesta a la llamada anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del archivo "format" que especificó en la 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 -c cookies 'https://api.appnexus.com/report-download?id=c445bca183a3d338dc1c5b85a3d484f5' > /tmp/seller_fill_and_delivery_network.csv

Nota:

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

Compartir a través de

API de plataforma digital: informe de red de entrega y relleno de vendedores

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe 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

API de plataforma digital: informe de red de entrega y relleno de vendedores

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe 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