Facturación de red

Artículo
05/18/2024

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

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.

Compartir a través de

Facturación de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una 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

Recursos adicionales

Compartir a través de

Facturación de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una 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

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