Informe del comprador de la plataforma de licitadores

Artículo
05/18/2024

El informe de compradores de la plataforma de licitadores proporciona información de transacción pormenorizada a los compradores (hasta el nivel de etiqueta). Para obtener instrucciones sobre cómo recuperar este informe, consulte los ejemplos siguientes.

Sugerencia

¿Necesita más de 90 días de datos?

Los bidder_platform_buyer tipos y platform_seller se extraen de tablas que almacenan los últimos datos de 90 días. Para los datos más allá de los últimos 90 días, use los buyer_platform_billing tipos de informe y seller_platform_billing .

Período de tiempo

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

current_hour
last_hour
last_48_hours
today
yesterday
last_7_days
month_to_date
quarter_to_date
last_month
lifetime
mtd
month_to_yesterday

Dimensions

Column	Tipo	¿Filtro?	Descripción
`month`	time	Yes	El mes del año en el que se contó el evento.
`day`	date	Yes	Día del año en el que se contó el evento.
`hour`	date	Yes	Hora en la que se ha producido el evento que se está contando.
`year`	date	Yes	Año en el que se contó el evento.
`buyer_member_id`	Entero	Yes	Identificador interno del miembro comprador.
`seller_member_id`	Entero	Yes	Identificador interno del miembro del vendedor.
`seller_member_name`	string	Sí	Nombre para mostrar del miembro del vendedor.
`seller_member`	string	Sí	En desuso.
`tag_id`	Entero	Yes	Identificador de la etiqueta.
`publisher_id`	Entero	Yes	Identificador interno del publicador.
`publisher_name`	string	Sí	Nombre para mostrar del publicador.
`publisher`	string	Sí	En desuso.
`size`	string	Sí	Tamaño de la creatividad.
`geo_country`	string	Sí	Nombre para mostrar del país seguido del identificador (formato Xandr).
`geo_country_name`	string	Sí	País en el que se contó el evento (por ejemplo, haga clic).
`content_category_id`	Entero	Yes	Identificador de la categoría de contenido con la que se asoció el inventario donde se produjo la impresión. Para obtener más información sobre las categorías de contenido, consulte el Servicio de categorías de contenido.
`content_category_name`	string	Sí	Nombre de la categoría de contenido a la que se asoció el inventario con el que se produjo la impresión. Para obtener más información sobre las categorías de contenido, consulte el Servicio de categorías de contenido.
`content_category`	string	Sí	En desuso.
`imp_type`	string	Sí	El tipo de impresión que se sirve. Posibles valores: - 1 = en blanco - 2 = PSA - 3 = error predeterminado - 4 = valor predeterminado - 5 = guardado - 6 = revender - 7 = RTB - 8 = PSA resultante de un error predeterminado - 9 = impresión externa - 10 = clic externo
`creative_id`	Entero	Yes	Identificador de la creatividad que sirvió en la impresión en la que se produjo el "evento" que está contando. Para obtener más información sobre las creatividades, consulte Creative Service.
`creative_name`	string	Sí	Nombre de la creatividad que sirvió en la impresión en la que se produjo el "evento" que está contando. Para obtener más información sobre las creatividades, consulte Creative Service.
`creative`	string	Sí	En desuso.
`bidder_id`	Entero	Yes	El identificador del pujador que compró la impresión en la que se produjo el "evento" en el que se informa. Para obtener más información sobre los licitadores, consulte el Servicio del Licitador.
`bidder_name`	string	Sí	Nombre del pujador que compró la impresión en la que se produjo el "evento" en el que se informa. Para obtener más información sobre los licitadores, consulte el Servicio del Licitador.
`bidder`	string	Sí	En desuso.
`site_id`	Entero	Yes	Identificador interno del sitio.
`site_name`	string	Sí	Nombre para mostrar del sitio.
`site`	string	Sí	En desuso.
`tag_name`	string	Sí	Nombre para mostrar de la etiqueta.
`tag`	string	Sí	En desuso.
`buyer_currency`	string	Sí	Moneda seleccionada del miembro comprador. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`supply_type`	string	No	Tipo de inventario. Posibles valores: - `"web"` - `"mobile_web"` - `"mobile_app"`
`publisher_code`	string	Sí	Código personalizado para el publicador, escrito para corresponder al código del publicador dentro del sistema externo.
`site_code`	string	Sí	Código personalizado para el sitio, escrito para corresponder al código de sitio dentro del sistema externo.
`buyer_member_name`	string	Sí	Nombre para mostrar del miembro comprador.
`buyer_member`	string	Sí	En desuso.
`buyer_seat_code`	string	Sí	El id. de asiento del comprador personalizado (enviado por DSP) que se usó para pujar por la impresión.
`buyer_seat_name`	string	Sí	Nombre para mostrar del código de asiento del comprador.

Métricas

Column	Tipo	Fórmula	Descripción
`imps_bought`	Entero	`imps_bought`	Número total de impresiones compradas correctamente.
`buyer_spend`	dinero	`buyer_spend`	Cantidad que el comprador paga por el costo de los medios.
`clicks`	Entero	`clicks`	Número total de clics. Nota: Los clics no se registran para asociados de demanda externos.
`click_rate_sold`	double	(`clicks` / `imps_bought`)	La "tasa de clics" o CTR. Nota: Los clics no se registran para asociados de demanda externos.
`buyer_ecpm`	dinero	( `buyer_spend` / `imps_bought` ) * 1000	El costo del comprador por impresión expresado en eCPM.
`buyer_spend_buyer_curr`	dinero	`buyer_spend`, expresado en la moneda del comprador.	El gasto total del comprador en su moneda seleccionada. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`buyer_ecpm_buyer_curr`	dinero	`buyer_ecpm`, expresado en la moneda del comprador.	El costo del comprador por impresión en la moneda seleccionada. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`imps_viewed`	Entero	`imps_viewed`	El número de impresiones medidas que se pueden ver según la definición de visualización de IAB, que indica que una impresión es visible si el 50 % de los píxeles se ven durante 1 segundo consecutivo.
`view_measured_imps`	Entero	`view_measured_imps`	Número total de impresiones que se midieron para la visibilidad.
`view_rate`	double	`view_rate`	Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. (Imps/View Measured Imps)
`view_measurable_rate`	double	`view_measurable_rate`	Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver imps/imps medidos)

Ejemplos

Creación de la solicitud de informe con formato JSON

El archivo JSON debe incluir , report_typebidder_platform_buyerasí como ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar 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 report
{
    "report": {
        "report_type": "bidder_platform_buyer",
        "timezone": "PST",
        "report_interval": "last_7_days",
        "name": "Example Buyer Report",
        "columns": [
            "day",
            "publisher_id",
            "publisher_name",
            "publisher_code",
            "buyer_member_id",
            "buyer_member_name",
            "buyer_ecpm",
            "buyer_spend"
        ]
    }
}

Nota:

Para ordenar por día, inserte este objeto en el archivo JSON después de la matriz "columns":

"orders": ["day"]

`POST` la solicitud al servicio de informes

$ curl -b cookies -c cookies -X POST -d @report 'https://api.adnxs.com/report'
{
  "response": {
    "status": "OK",
    "report_id": "bfe2ba2ea54a51115db942d591a7b5d9",
  }
}

`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.adnxs.com/report?id=bfe2ba2ea54a51115db942d591a7b5d9'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "url": "report-download?id=bfe2ba2ea54a51115db942d591a7b5d9"
      },
      "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 -c cookies 'https://api.adnxs.com/report-download?id=bfe2ba2ea54a51115db942d591a7b5d9' > report.csv

Nota:

Use el identificador proporcionado en la respuesta desde el momento en que publicó inicialmente el informe.

Programar un informe de ejecución frecuente

Puede programar informes que le gustaría extraer periódicamente. Para obtener más información, vea El servicio de informes guardados.

Compartir a través de

Informe del comprador de la plataforma de licitadores

Período de tiempo

Dimensions

Métricas

Ejemplos

Creación de la 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

Programar un informe de ejecución frecuente

Recursos adicionales

Compartir a través de

Informe del comprador de la plataforma de licitadores

Período de tiempo

Dimensions

Métricas

Ejemplos

Creación de la 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

Programar un informe de ejecución frecuente

Temas relacionados

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