Leer en inglés

Compartir a través de


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 como creative_id y un genérico creative_name.
  • Las ubicaciones se agregan en una fila con -1 como placement_id y un genérico placement_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.

Período de tiempo

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

Período de retención de datos

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.

Dimensions

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 "Real Time", "Direct" Tipo de comprador
buyer_currency string "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 "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 "Blank" Tipo de impresión. Para obtener los valores posibles, vea imp_type_id.
revenue_type string "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 pago
0 = CPM plano
1 = Costo más CPM
2 = Costo más margen
3 = CPC
4 = CPA
5 = Revshare
6 = Tarifa plana
7 = Variable CPM
8 = CPM estimado
payment_type string "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 0es , Xandr recopila el costo de los medios del comprador y paga al vendedor. Si 1es , 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 "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 Yes Moneda del publicador.
salesperson_for_advertiser string "Ray Parcino" Vendedor del anunciante. Consulta el "labels" campo en el Servicio de anunciantes para obtener más información.
salesperson_for_publisher string "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 "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 "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 "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 "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.

Métricas

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.

Ejemplo

Create una solicitud de informe con formato JSON

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

POST la solicitud al servicio de informes

$ 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
    }
}

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

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 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.