Informe de facturación de la plataforma de vendedores

Artículo
05/18/2024

Obtenga información sobre el informe de facturación de la plataforma de vendedores en esta página. Los proveedores recopilan información de transacciones mediante el Informe de facturación de la plataforma de vendedores para facturar a los compradores o conciliar sus registros de transacciones internos.

Para obtener instrucciones sobre cómo recuperar un 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	En desuso.
`bidder_id`	Entero	Sí	Sí	Id. interno del licitador.
`bidder_name`	string	No	No	Nombre para mostrar del licitador.
`buyer_currency`	string	No	Sí	Moneda seleccionada del miembro comprador. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`buyer_member`	string	No	No	En desuso.
`buyer_member_id`	Entero	Sí	Sí	Identificador interno del miembro comprador.
`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 = inventario no directo - 1 = inventario directo
`day`	date	Sí	Sí	Día.
`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 = guardado - 6 = revender - 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.
`publisher`	string	No	No	En desuso.
`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	En desuso.
`seller_member_id`	Entero	Sí	Sí	Identificador interno del miembro del vendedor.
`seller_member_name`	string	No	No	Nombre para mostrar del miembro del vendedor.
`site`	string	No	No	En desuso.
`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.
`year`	date	Sí	Sí	Año.

Métricas

Column	Tipo	Fórmula	Descripción
`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_appnexus_cleared`	Entero	`imps_appnexus_cleared`	El número total de impresiones en las que Xandr recopila el costo de los medios y paga el pago del vendedor por las transacciones entre este par comprador-vendedor.
`imps_direct_cleared`	Entero	`imps_direct_cleared`	El número total de impresiones en las que Xandr NO recopila el costo de los medios ni paga el pago del vendedor por las transacciones entre este par comprador-vendedor.
`seller_revenue`	dinero	`seller_revenue`	Ingresos por impresión del vendedor.
`seller_revenue_appnexus_cleared`	dinero	`seller_revenue for imps_appnexus_cleared`	Ingresos del vendedor por impresiones en las que Xandr paga el pago del vendedor.
`seller_revenue_direct_cleared`	dinero	`seller_revenue for imps_direct_cleared`	Los ingresos del vendedor por las impresiones en las que el pago del vendedor se realiza directamente entre este par comprador-vendedor, no a través de AppNexus.
`seller_ecpm`	dinero	`seller_revenue x 1000 / imps_delivered`	Ingresos del vendedor expresados en eCPM.
`seller_revenue_seller_curr`	dinero	`seller_revenue, expressed in the seller's currency`.	Ingresos del vendedor por impresión en la moneda seleccionada. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`seller_revenue_appnexus_cleared_seller_curr`	dinero	`seller_revenue for imps_appnexus_cleared, expressed in the seller's currency`.	Los ingresos del vendedor por las impresiones en las que Xandr paga el pago del vendedor, por impresión, en su moneda seleccionada. Para obtener una lista de las monedas admitidas, monedas admitidas.
`seller_revenue_direct_cleared_seller_curr`	dinero	`seller_revenue for imps_direct_cleared, expressed in the seller's currency`.	Los ingresos del vendedor por las impresiones en las que el pago del vendedor se realiza directamente entre este par comprador-vendedor y no a través de Xandr, por impresión, en su moneda seleccionada. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`seller_revenue_direct_cleared_buyer_curr`	dinero	`seller_revenue for imps_direct_cleared, expressed in the buyer's currency`.	Los ingresos del vendedor por las impresiones en las que el pago del vendedor se realiza directamente entre este par comprador-vendedor y no a través de Xandr, por impresión, en la moneda seleccionada del comprador. Para obtener una lista de las monedas admitidas, consulte Monedas admitidas.
`seller_ecpm_seller_curr`	dinero	`(seller_revenue / imps_delivered) * 1000, expressed in the seller's currency`	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.

Ejemplo

Creación de la solicitud de informe con formato JSON

El archivo JSON debe incluir , report_type"seller_invoice_report"así como ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar las dimensiones específicas, definir la granularidad (año, mes, día) y especificar el elemento en el format 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": "seller_invoice_report", "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" ] }
            }

Nota:

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

`POST` la solicitud a Reporting Service

$ curl -b cookies -c cookies
            -X POST -d @report 'https://api.appnexus.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 *report-download* 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=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 *report-download*. 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 del "formato" que especificó en su inicial POST.

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.
Use el identificador proporcionado en la respuesta desde el momento en que publicó inicialmente el informe.

$ curl -b cookies -c cookies
                  'https://api.appnexus.com/report-download?id=bfe2ba2ea54a51115db942d591a7b5d9' >
               report.csv

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.

Compartir a través de

Informe de facturación de la plataforma de vendedores

Período de tiempo

Dimensions

Métricas

Ejemplo

Creación de la solicitud de informe con formato JSON

`POST` la solicitud a Reporting Service

`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 de facturación de la plataforma de vendedores

Período de tiempo

Dimensions

Métricas

Ejemplo

Creación de la solicitud de informe con formato JSON

POST la solicitud a Reporting Service

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 a Reporting Service

`GET` estado del informe del servicio de informes

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