Compartir a través de

Informe de vendedores de plataforma

  • Artículo

El Informe de vendedores de plataforma se puede usar para facturar a compradores o conciliar registros de transacciones internos. Con este informe, puede ver la información de transacción en el nivel de etiqueta.

Para obtener instrucciones sobre cómo recuperar este informe, consulte el ejemplo siguiente.

Período de tiempo

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

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

Dimensions

Column Tipo ¿Grupo? ¿Filtro? Descripción
bidder string No No Obsoleto.
bidder_id Entero Sí Sí Id. interno del licitador.
bidder_name string No No Nombre para mostrar del licitador.
buyer_member string No No Obsoleto.
buyer_member string No No Nombre para mostrar del miembro de compra seguido del identificador (formato Xandr).
buyer_member_id Entero Sí Sí Identificador interno del miembro de compra.
buyer_member_name string No No Nombre para mostrar del miembro que compra.
buyer_member_name string No No Nombre para mostrar del miembro comprador.
cleared_direct Entero No Sí Si se establece en 1, la impresión se sirvió correctamente en el inventario directo. Posibles valores:
- 0 = no inventario directo
- 1 = inventario directo
day date Sí Sí Día.
gender string No Sí El sexo del usuario.
geo_country string No Sí Nombre para mostrar del país seguido del identificador (formato Xandr).
geo_country_name string No No País.
hour date Sí 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.
imp_type string No Sí El tipo de impresión que se sirve. Posibles valores:
- 1 = en blanco
- 2 = PSA
- 3 = error predeterminado
- 4 = valor predeterminado
- 5 = mantenido
- 6 = reventa
- 7 = RTB
- 8 = PSA resultante de un error predeterminado
- 9 = impresión externa
- 10 = clic externo
is_delivered booleano No Sí Si es true, la impresión se sirvió correctamente.
is_dw booleano No Sí Si es true, la impresión fue atendida por Xandr.
month time Yes No Mes.
price_bucket_id Entero Yes No Identificador del cubo de precios. Para obtener más información sobre los cubos de precios, consulte la descripción del price_buckets campo en el Servicio para miembros.
publisher string No No Obsoleto.
publisher_code string No No Código personalizado para el publicador, escrito para corresponder al código del publicador dentro del sistema externo.
publisher_id Entero Sí Sí Identificador interno del publicador.
publisher_name string No No Nombre para mostrar del publicador.
seller_currency string No Sí Moneda seleccionada del miembro del vendedor. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
seller_member string No No Obsoleto.
seller_member_id Entero Sí Sí Identificador interno del miembro.
seller_member_name string No No Nombre para mostrar del miembro del vendedor.
site string No No Obsoleto.
site_code string No No Código personalizado para el sitio, escrito para corresponder al código de sitio dentro del sistema externo.
site_id Entero Sí Sí Identificador interno del sitio.
site_name string No No Nombre para mostrar del sitio.
size string No No Tamaño de la creatividad.
supply_type string No No Tipo de inventario. Posibles valores:
- "web"
- "mobile_web"
- "mobile_app"
tag string No No Obsoleto.
tag_id Entero Yes No Identificador de la etiqueta.
tag_name string No No Nombre para mostrar de la etiqueta.
year date Sí Sí Año.

Métricas

Column Tipo Fórmula Description
auction_service_deduction Dinero auction_service_deduction La deducción en las impresiones compradas por RTB especificadas en el contrato del miembro comprador. Por ejemplo, con una deducción del 10 %, si presupuestan $1000 para su campaña, tomaremos $100 de eso, dejando al comprador con $900 que se usa para comprar el inventario del vendedor.
auction_service_fees Dinero auction_service_fees La tarifa cobrada por las impresiones compradas por RTB especificadas en el contrato del miembro comprador. Por ejemplo, con una cuota del 10 %, si el comprador gasta $1000 en el inventario, le cobramos una cuota de $100.
buyer_spend Dinero buyer_spend Cantidad que el comprador paga por el costo de los medios.
clear_fees Dinero clear_fees La tarifa especificada en el contrato del miembro comprador cobrada por las impresiones compradas a un vendedor externo o asociado.
clicks Entero clicks Número total de clics.
creative_overage_fees Dinero creative_overage_fees Cargo por las creatividades hospedadas que superan el límite de tamaño creativo especificado en el contrato del miembro comprador.
imps Entero imps El número total de impresiones (servidas y revendidas).
imps_delivered Entero imps_delivered Número total de impresiones que se han servido correctamente.
imps_not_delivered Entero imps_not_delivered El número total de impresiones en las que alguien que no sea Xandr sirvió la impresión.
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.
seller_ecpm Dinero ( seller_revenue / imps_delivered ) * 1000 Ingresos del vendedor expresados en eCPM.
seller_ecpm_seller_curr Dinero (seller_revenue / imps_delivered) * 1000, expresado en la moneda del vendedor. Los ingresos del vendedor expresados en eCPM, en la moneda seleccionada por el vendedor. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
seller_revenue Dinero seller_revenue Ingresos por impresión del vendedor.
seller_revenue_seller_curr Dinero seller_revenue, expresado en la moneda del vendedor. Ingresos del vendedor por impresión en la moneda seleccionada. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
view_measurable_rate double view_measurable_rate Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver imps/imps medidos)
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)

Visible solo para los administradores

Column Tipo Fórmula Description
forex_allowance Dinero forex_allowance Una asignación de búfer de moneda extranjera.
discrepancy_allowance Dinero discrepancy_allowance La deducción por las impresiones vendidas de RTB especificadas en el contrato del miembro vendedor. Esto se determina en función de las discrepancias pasadas entre lo que Xandr y el asociado de suministro registraron como impresiones ganadas.

Ejemplo

Create la solicitud de informe con formato JSON

El archivo JSON debe incluir , report_type "platform_buyer"así como ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar 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.

$ cat report
{
    "report": {
        "report_type": "platform_seller",
        "timezone": "PST",
        "report_interval": "last_7_days",
        "name": "SSP Monthly Buyer Report",
        "columns": [
            "day",
            "seller_member",
            "publisher_id",
            "publisher_name",
            "publisher_code",
            "buyer_member_id",
            "buyer_member_name",
            "imps",
            "imps_delivered",
            "seller_revenue",
            "buyer_spend"
        ]
    }
}

Sugerencia

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",
  }
}

OBTENER el 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"
   }
}

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 campo "url" de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del "formato" 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 -c cookies 'https://api.adnxs.com/report?id=bfe2ba2ea54a51115db942d591a7b5d9' > report.csv

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. Consulte El servicio de informes guardados para obtener más información.