Facturación de red
Advertencia
Este informe ha quedado en desuso. Como resultado, solo debe usarse para la actividad de facturación antes del 1 de octubre de 2015. Para obtener informes después del 1 de octubre de 2015, consulte el Informe de facturación de compra y el Informe de facturación de venta.
El informe Análisis de facturación de red se puede usar para ver los datos de facturación en:
- Impresiones directas de anunciantes (compradas entre publicadores directos e inventario en tiempo real)
- Publicadores directos (vendidos entre anunciantes directos y otros compradores de plataformas)
Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes.
Nota
En el caso de las impresiones anteriores a 100 días, el informe de facturación de red ahora devuelve valores predeterminados en algunas columnas:
- Las creatividades se agregan en una fila con
0
comocreative_id
y un genéricocreative_name
. - Las ubicaciones se agregan en una fila con
-1
comoplacement_id
y un genéricoplacement_name
. hour
- Los datos por hora se agregan en una fila con "AAAA-MM-DD 00:00:00" como la hora ("AAAA-MM-DD" es el día UTC en el que se produjo la actividad). Esto hará que parezca que toda la actividad ocurrió a medianoche. Todos los datos diarios anteriores a 100 días se devolverán en la zona horaria UTC.
El report_interval
campo se puede establecer en uno de los siguientes:
- current_hour
- last_hour
- hoy
- yesterday
- last_48_hours
- last_2_days
- last_7_days
- last_30_days
- month_to_date
- month_to_yesterday
- quarter_to_date
- last_month
- Vida
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.
Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
---|---|---|---|---|
entity_member_id |
Entero | Yes | 123 |
-- |
buyer_member_id |
Entero | Yes | 123 |
Identificador interno del miembro comprador |
buyer_member_name |
string | No | "My Network" |
Nombre para mostrar del miembro comprador |
buyer_member |
string | No | "My Network (123)" |
En desuso (a partir del 17 de octubre de 2016). |
buyer_type |
string | Sí | "Real Time" , "Direct" |
Tipo de comprador |
buyer_currency |
string | Sí | "USD" |
Moneda del comprador. |
seller_member_id |
Entero | Yes | 456 |
Identificador interno del miembro del vendedor |
seller_member_name |
string | No | "That Seller" |
Nombre para mostrar del miembro del vendedor |
seller_member |
string | No | "That Seller (456)" |
En desuso (a partir del 17 de octubre de 2016). |
seller_type |
string | Sí | "Real Time" , "Direct" |
El tipo de vendedor |
insertion_order_id |
Entero | Yes | 451 |
Identificador interno del orden de inserción |
insertion_order_name |
string | No | "Q1-2014" |
Nombre para mostrar del orden de inserción |
campaign_id |
Entero | Yes | 728 |
Identificador interno de la campaña |
campaign_name |
string | No | "Test" |
Nombre para mostrar de la campaña |
campaign |
string | No | "Test (728)" |
En desuso (a partir del 17 de octubre de 2016). |
creative_id |
Entero | Yes | 554 |
Identificador interno de la creatividad. Nota: En el caso de las impresiones anteriores a 100 días, las creatividades se agregan en una fila con 0 como creative_id . Para los rastreadores de clics o impresiones externos, creative_id será "External Clicks" o "External Imps" . |
creative_name |
string | No | "Q1 2010 - 728x90" |
Nombre para mostrar de la creatividad. Nota: En el caso de las impresiones anteriores a 100 días, las creatividades se agregan en una fila con un genérico creative_name . Para los rastreadores de clics o impresiones externos, creative_name será "External Clicks" o "External Imps" . |
creative |
string | No | "Q1 2010 - 728x90 (554)" |
En desuso (a partir del 17 de octubre de 2016). |
placement_id |
Entero | Yes | 567 |
Identificador interno de la ubicación. Nota: Para las impresiones anteriores a 100 días, las ubicaciones se agregan en una fila con -1 como placement_id . |
placement_name |
string | No | "Photos 728x90" |
Nombre para mostrar de la ubicación. Nota: Para las impresiones anteriores a 100 días, las ubicaciones se agregan en una fila con un genérico placement_name . |
placement |
string | No | "Photos 728x90 (567)" |
En desuso (a partir del 17 de octubre de 2016). |
imp_type_id |
Entero | Yes | 1 |
Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): - 1 ("En blanco"): sin creatividad.- 2 ("PSA"): un anuncio de servicio público se sirvió porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.- 3 ("Error predeterminado"): una creatividad predeterminada que se sirve debido a un problema de tiempo de espera.- 4 ("Valor predeterminado"): una creatividad predeterminada que se sirve porque no había pujas válidas.- 5 ("Guardado"): la creatividad de su anunciante se ha servido en el sitio del editor.- 6 ("Reventa"): la impresión del editor se vendió a un comprador de terceros.- 7 ("RTB"): la creatividad de su anunciante se ha servido en el inventario de terceros.- 8 ("Error de PSA"): un anuncio de servicio público servido debido a un problema de tiempo de espera o a la falta de una creatividad predeterminada.- 9 ("Impresión externa"): una impresión de un rastreador de impresiones.- 10 ("Clic externo"): un clic de un rastreador de clics. |
imp_type |
string | Sí | "Blank" |
Tipo de impresión. Para obtener los valores posibles, vea imp_type_id . |
revenue_type |
string | Sí | "CPA" |
La base en la que se paga al miembro. |
revenue_type_id |
Entero | Yes | 4 |
Identificador del tipo de ingresos. Posibles valores:-1 = Sin pago0 = CPM plano1 = Costo más CPM2 = Costo más margen3 = CPC4 = CPA5 = Revshare6 = Tarifa plana7 = Variable CPM8 = CPM estimado |
payment_type |
string | Sí | "com" , "revshare" |
Tipo de pago a un agente. |
cleared_direct |
Entero | Yes | 0 , 1 |
Si el comprador paga directamente al vendedor por el costo de los medios. Si 0 es , Xandr recopila el costo de los medios del comprador y paga al vendedor. Si 1 es , el comprador paga directamente al vendedor el costo de los medios. Sugerencia: Los compradores pueden coincidir con el costo de los medios en su factura filtrando las transacciones "directas borradas". |
hour |
time | No | "2010-02-01 06:00:00" |
La hora de la impresión. Nota: En el caso de las impresiones anteriores a 100 días, los datos por hora se agregan en una fila con "AAAA-MM-DD 00:00:00" como la hora ('AAAA-MM-DD' es el día UTC en el que se produjo la actividad). Esto hará que parezca que toda la actividad ocurrió a medianoche. Todos los datos diarios anteriores a 100 días se devuelven en la zona horaria UTC. |
day |
time | No | "2010-02-01 " |
El día de la impresión. |
month |
time | No | "2010-02" |
El mes de la impresión. |
advertiser_id |
Entero | Yes | 789 |
Id. interno del anunciante |
advertiser_name |
string | No | "Verizon" |
Nombre para mostrar del anunciante |
advertiser |
string | No | "Verizon (789)" |
En desuso (a partir del 17 de octubre de 2016). |
advertiser_currency |
string | Sí | "USD" |
Moneda del anunciante. |
line_item_id |
Entero | Yes | 932 |
Identificador interno del elemento de línea |
line_item_name |
string | No | "$3 CPM Verizon Remarketing" |
Nombre para mostrar del elemento de línea |
line_item |
string | No | "$3 CPM Verizon Remarketing (932)" |
En desuso (a partir del 17 de octubre de 2016). |
publisher_id |
Entero | Yes | 123 |
Identificador interno del publicador |
publisher_name |
string | No | "Microsoft" |
Nombre para mostrar del publicador |
publisher |
string | No | "Microsoft (123)" |
En desuso (a partir del 17 de octubre de 2016). |
publisher_currency |
string | Sí | Yes |
Moneda del publicador. |
salesperson_for_advertiser |
string | Sí | "Ray Parcino" |
Vendedor del anunciante. Consulta el "labels" campo en el Servicio de anunciantes para obtener más información. |
salesperson_for_publisher |
string | Sí | "Brian Young" |
Vendedor del publicador. Para obtener más información, consulte el "labels" campo en el Servicio de publicador . |
account_manager_for_advertiser |
string | Sí | "Rachel Dina" |
El administrador de cuentas del anunciante. Consulta el "labels" campo en el Servicio de anunciantes para obtener más información. |
account_manager_for_publisher |
string | Sí | "Ami Fisher" |
Administrador de cuentas del publicador. Para obtener más información, consulte el "labels" campo en el Servicio de publicador . |
trafficker_for_line_item |
string | Sí | "Maurice Truman" |
El tratante del elemento de línea. Consulte el "labels" campo en el servicio de elementos de línea para obtener más detalles. |
salesrep_for_line_item |
string | Sí | "Beverly Heller" |
El representante de ventas del elemento de línea. Consulte el "labels" campo en el servicio de elementos de línea para obtener más detalles. |
Column | Tipo | Ejemplo | Fórmula | Description |
---|---|---|---|---|
imps |
Entero | 234123 |
Duendes | Número total de impresiones |
clicks |
Entero | 545 |
Clics | Número total de clics en todas las impresiones |
convs |
Entero | 205 |
total_convs | Número total de conversiones en todas las impresiones |
media_cost |
Dinero | 304.36 |
media_cost | Costo total del inventario comprado. |
media_cost_pub_curr |
Dinero | 201.34 |
media_cost_pub_curr | El costo total del inventario comprado, en la moneda del publicador. |
media_cost_adv_curr |
Dinero | 201.34 |
media_cost_adv_curr | El costo total del inventario comprado, en la moneda del anunciante. Nota: Si no está realizando un seguimiento de los ingresos a través de Xandr, será 0 . |
net_media_cost |
Dinero | 211.23 |
media_cost: auction_service_deduction | El costo total del inventario comprado, menos las deducciones de cargos del servicio de subasta del comprador. |
net_media_cost_adv_curr |
Dinero | 211.23 |
media_cost_adv_curr: auction_service_deduction_adv_curr | El costo total del inventario comprado, menos las deducciones de cargos del servicio de subasta del comprador, en la moneda del anunciante. Nota: Si no está realizando un seguimiento de los ingresos a través de Xandr, será 0 . |
ecpm |
Dinero | 1.30 |
(gasto /imps) x 1000 | Cantidad de dinero invertido por 1000 impresiones. |
ecpm_pub_curr |
Dinero | 1.30 |
(gasto /imps) x 1000 | Cantidad de dinero invertido por 1000 impresiones, en la moneda del editor. |
ctr |
double | 0.002327 |
clics o imps | Tasa de clics en impresiones |
convs_rate |
double | 0.000856 |
total_convs/imps | Tasa de conversiones a impresiones |
network_revenue |
Dinero | 1201.13 |
network_revenue | Ingresos de red reservados a través de anunciantes directos y revendidos a compradores en tiempo real |
booked_revenue |
Dinero | 1201.13 |
booked_revenue | Ingresos de red reservados a través de anunciantes directos. |
booked_revenue_adv_curr |
Dinero | 970.24 |
booked_revenue_adv_curr | Ingresos de red reservados a través de anunciantes directos, en la moneda del anunciante. |
network_profit |
Dinero | 801.08 |
network_revenue: media_cost | Beneficio de red reservado a través de anunciantes directos y revendida a compradores en tiempo real. |
network_rpm |
Dinero | 5.13 |
(network_revenue/imps) x 1000 | Ingresos de red por Mille (1000 imps) |
network_ppm |
Dinero | 3.42 |
(network_profit/imps) x 1000 | Beneficio de red por Mille (1000 imps) |
network_roi |
double | 2.94 |
(network_revenue/media_cost) - 1 | Retorno de la red de la inversión. Se devuelve como un porcentaje, por ejemplo, 0,94 = 94 % |
advertiser_revenue |
Dinero | advertiser_revenue | Los ingresos registrados para el anunciante. | |
advertiser_profit |
Dinero | advertiser_revenue: media_cost | Ganancias del anunciante | |
advertiser_rpm |
Dinero | (advertiser_revenue/imps) x 1000 | Ingresos del anunciante por Mille (1000 imps) | |
advertiser_ppm |
Dinero | (advertiser_profit/imps) x 1000 | Ganancia del anunciante por Mille (1000 imps) | |
advertiser_roi |
Dinero | (advertiser_revenue/media_cost) x 1000 | Rentabilidad de la inversión por parte del anunciante | |
spend |
Dinero | 304.36 |
media_cost | |
creative_overage_fees |
Dinero | creative_overage_fees | Tarifas totales que se cobran por las creatividades hospedadas que superan el límite de tamaño creativo. | |
creative_overage_fees_adv_curr |
Dinero | creative_overage_fees_adv_curr | Tasas totales que se cobran por las creatividades hospedadas que superan el límite de tamaño creativo, en la moneda del anunciante. Nota: Si no está realizando un seguimiento de los ingresos a través de Xandr, será 0 . |
|
auction_service_fees |
Dinero | auction_service_fees | Cargos totales cobrados por impresiones compradas a terceros. Estas tarifas se cobran además del costo de medios del comprador. Para obtener más información, vea Buyer Auction Service Charge Mechanics en la documentación monetizar. | |
auction_service_fees_adv_curr |
Dinero | auction_service_fees_adv_curr | Tasas totales cobradas por impresiones compradas a terceros, en la moneda del anunciante. Estas tarifas se cobran además del costo de medios del comprador. Para obtener más información, vea Buyer Auction Service Charge Mechanics en la documentación monetizar. Nota: Si no está realizando un seguimiento de los ingresos a través de Xandr, será 0 . |
|
auction_service_deduction |
Dinero | auction_service_deduction | Las deducciones totales cobradas por impresiones compradas a terceros. Estas deducciones se incluyen en el costo multimedia del comprador y se deducen al calcular el pago del vendedor. | |
auction_service_deduction_adv_curr |
Dinero | auction_service_deduction_adv_curr | Las deducciones totales cobradas por impresiones compradas a terceros, en la moneda del anunciante. Estas deducciones se incluyen en el costo multimedia del comprador y se deducen al calcular el pago del vendedor. Nota: Si no está realizando un seguimiento de los ingresos a través de Xandr, será 0 . |
|
reseller_revenue |
Dinero | 304.23 |
reseller_revenue | Los ingresos generados a través de ventas a compradores externos (RTB). |
reseller_revenue_pub_curr |
Dinero | 304.23 |
reseller_revenue_pub_curr | Los ingresos generados a través de ventas a compradores externos (RTB), en la moneda del publicador. |
El archivo JSON debe incluir el report_type "network_analytics"
, 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
, excel
o html
). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.
$ cat network-billing-request.json
{
"report": {
"format": "csv",
"report_interval": "last_48_hours",
"columns": [
"seller_member_id",
"buyer_member_id",
"imps",
"clicks",
"convs_rate"
],
"report_type": "network_billing"
}
}
$ curl -b cookies -c cookies -X POST -d @network-billing-request.json 'https://api.appnexus.com/report'
{
"response": {
"status": "OK",
"report_id": "a2add615a52f0ca4ed13f64ce9d94a5c",
"existing": false
}
}
Realice una GET
llamada con el identificador de informe para recuperar el estado del informe. Continúe realizando esta llamada hasta que execution_status
sea "ready"
. A continuación, use el servicio de descarga de informes para guardar los datos de informes en un archivo (descrito en el paso siguiente).
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
"response": {
"status": "OK",
"report": {
"name": "",
"created_on": "2014-04-07 15:51:19",
"json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"last_48_hours\",\"columns\":[\"seller_member_id\",\"buyer_member_id\",\"imps\",\"clicks\",\"convs_rate\"],\"report_type\":\"network_billing\",\"filters\":[{\"entity_member_id\":\"1309\"}]}}",
"url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=a2add615a52f0ca4ed13f64ce9d94a5c"
},
"execution_status": "ready"
}
}
Para descargar los datos del informe en un archivo, realice otra GET
llamada con el identificador de informe, pero esta vez al report-download
servicio. 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
.
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=a2add615a52f0ca4ed13f64ce9d94a5c > /tmp/network-billing-report.csv
Nota
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.