Análisis de editores de red

El informe de análisis del editor de red se puede usar para ver los datos de rendimiento de un editor específico de la red que sea más granular que los datos proporcionados en el informe de análisis de red. Este informe solo está disponible para los usuarios de red. Los usuarios de Publisher pueden usar el informe de Publisher Analytics .

Para obtener instrucciones de uso, consulte el ejemplo siguiente. Tenga en cuenta que este informe requiere que se especifique un identificador de editor como parte de la dirección URL, por ejemplo:

https://api.appnexus.com/report?publisher_id=PUBLISHER_ID

Período de tiempo

El report_interval campo se puede establecer de una de las siguientes formas:

• 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
• de duración

Período de retención de datos

El período de retención de datos del informe es de 428 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 Servicio de informes.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
hour	date	no	"2010-02-01 06:00:00"	La hora de la subasta. Nota: Para las impresiones de más de 100 días, se devolverá el día en lugar de la hora.
day	date	no	"2010-02-01"	El día de la subasta.
month	date	no	"2010-02"	El mes de la subasta.
buyer_member_id	Entero	sí	567	El identificador del miembro comprador.
buyer_member_name	string	no	"Network"	El nombre del miembro comprador. Nota: El nombre podría ser "Default" or "Default Error", lo que significa que la impresión no realizó ningún comprador y se publicó un creativo predeterminado.
buyer_member	string	no	"Network (567)"	En desuso.
seller_member_id	Entero	sí	67	El identificador del miembro vendedor.
advertiser_id	Entero	sí	728	El identificador del anunciante.
advertiser_name	string	no	"Test"	El nombre del anunciante.
advertiser	string	no	"Test (123)"	En desuso.
advertiser_code	string	no	"Code"	El código personalizado para el anunciante.
line_item_id	Entero	sí	554	El identificador del elemento de línea.
line_item_name	string	no	"Q1 Pepsi"	El nombre de la línea de pedido.
line_item	string	no	"Q1 Pepsi (554)"	En desuso.
line_item_code	string	no	"Q1 Pepsi Code"	El código personalizado de la línea de pedido.
campaign_id	Entero	sí	567	El identificador de la campaña.
campaign_name	string	no	"Photos 728x90"	El nombre de la campaña.
campaign	string	no	"Photos 728x90 (567)"	En desuso.
campaign_code	string	no	"Photos Code"	El código personalizado de la campaña.
campaign_priority	Entero	no	5	La prioridad de puja de una campaña destinada al inventario directo. Para obtener más información, consulte Prioridad de oferta en la documentación de la interfaz de usuario. Valores posibles: 1 - 10, donde 10 es la prioridad más alta.
split_id	Entero	Sí	342	El identificador de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_id (si se incluye) será null.
split_name	string	Sí	"Mobile Split A"	El nombre de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_name (si se incluye) será null.
creative_id	Entero	sí	554	El Id. del creativo. Nota: - Para las impresiones de más de 100 días, las creatividades se agregarán en una fila con 0 el creative_idformato . - Para los rastreadores de clics o impresiones externas, creative_id será "External Clicks" o "External Imps".
brand_id	Entero	sí	3	El identificador de la marca asociada a una creatividad. Para imp_type_id = 6, no hay información disponible en el brand_id campo para este informe. En su lugar, consulte el Informe de revisión de marca del vendedor .
brand_name	string	no	"Ace Hardware"	El nombre de la marca asociada a un creativo. Para imp_type_id = 6, no hay información disponible en el brand_name campo para este informe. En su lugar, consulte el Informe de revisión de marca del vendedor .
brand	string	no	"Ace Hardware (3)"	En desuso.
publisher_id	Entero	sí	6787	El número para identificar la editorial.
publisher_code	string	no	"Publisher Code"	El código personalizado para identificar el editor.
publisher_currency	string	sí	"USD"	La moneda del editor.
pub_rule_id	Entero	no	54	El número para identificar la regla de editor.
pub_rule_name	string	no	"50% Revshare"	El nombre de la regla del editor.
pub_rule	string	no	"50% Revshare (54)"	En desuso.
pub_rule_code	string	no	"50% Revshare Code"	El código personalizado de la regla del editor.
site_id	Entero	sí	194	El identificador del sitio. Nota: Para las impresiones de más de 100 días, la site_id será 0 .
site_name	string	no	"Site Name"	El nombre del sitio.
site	string	no	"Site Name (593)"	En desuso.
site_code	string	no	"Site Name Code"	El código personalizado del sitio.
deal_id	Entero	Sí	2345	El identificador de la oferta. Para obtener más información sobre los acuerdos negociados entre compradores y vendedores, consulte Servicio de ofertas y Servicio de acceso de compradores de ofertas.
deal_name	string	No	"Private deal for buyer 1085 with floor of $2.50"	El nombre del trato.
deal	string	No	"Private deal for buyer 1085 with floor of $2.50 (45)"	En desuso.
deal_code	string	No	"External seller deal code"	El código personalizado de la oferta.
geo_country	string	sí	"US"	El código geográfico de país o región.
geo_country_name	string	no	"Unites States"	Nombre del país/región.
size	string	no	"300x250"	El tamaño del creativo servido.
placement_id	Entero	sí	546	El id. de la ubicación. Nota: Para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con -1 el placement_idformato .
placement_name	string	no	"300x250 Business"	El nombre del emplazamiento. Nota: Para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con "All placement data older than 100 days" el placement_nameformato .
placement	string	sí	"300x250 Business (546)"	En desuso.
placement_code	string	no	"300x250 Business Code"	El código personalizado de la ubicación.
imp_type_id	Entero	sí	1	El identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): 1 ("Blank"): No se sirve ninguna creatividad. 2 ("PSA"): se publicó un anuncio de servicio público porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible. 3 ("Error predeterminado"): una creatividad predeterminada servida debido a un problema de tiempo de espera. 4 ("Predeterminado"): se publicó una creatividad predeterminada porque no había pujas válidas. 5 ("Conservado"): el recurso creativo de su anunciante se sirve en el sitio de su editor. 6 ("Revendida"): la impresión de su editor se vendió a un comprador externo. 7 ("RTB"): el recurso creativo del anunciante publicado 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 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í	"Kept"	El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id.
buyer_type	string	sí	"Reseller"	El tipo de comprador, establecido por Xandr.
supply_type	string	no	"web"	El tipo de inventario. Posibles valores: - "web" - "mobile_web" - "mobile_app"
payment_type	string	sí	"cpm", "revshare"	El tipo de pago a un agente.
revenue_type	string	sí	"CPA"	La base sobre la cual se le paga al miembro.
revenue_type_id	Entero	sí	4	El identificador del tipo de ingresos. Posibles valores: -1 = Sin pago 0 = CPM fijo 1 = Coste más CPM 2 = Coste más margen 3 = CPC 4 = CPA 5 = Revshare 6 = tarifa plana 7 = CPM variable 8 = CPM estimado
external_inv_id	Entero	Sí	4921	El identificador del código de inventario externo pasado en la llamada de anuncio y predefinido por el editor. Para obtener más información, consulte Servicio de códigos de inventario externo. Para las impresiones de más de 100 días, la external_inv_id será 0.
external_inv_name	string	No	"External Inv Name"	El nombre del código de inventario externo pasado en la llamada de anuncio y predefinido por el editor. Para obtener más información, consulte Servicio de códigos de inventario externo.
external_inv	string	No	"External Inv Name (4921)"	En desuso.
media_type	string	no	"Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin"	El estilo de visualización general de la creatividad. Puede usar el Servicio de tipos de medios para ver la lista completa de los tipos de medios.
mediatype_id	Entero	sí	2	Solo lectura. El identificador del tipo de medio al que pertenece el subtipo.
adjustment_id	Entero	sí	890	El identificador del ajuste que se usa para realizar cambios en el coste multimedia o las impresiones, los clics y las conversiones que se muestran en los informes de un editor.
venue	string	sí	"Venue Name"	El nombre del clúster de dominio, sitio, etiqueta y país o región del usuario que usa el sistema de optimización de Xandr para determinar las valoraciones de las ofertas. Una campaña no puede dirigirse explícitamente a un lugar.
predict_rev_type	Entero	sí	2	La fase de optimización de una campaña que se publicó en el inventario del editor. Posibles valores: -2 = sin fase de predicción -1 = fase de predicción base 0 = abandono de Learn 1 = Aprender 2 = Limitado 3 = optimizado 4 = sesgado 5 = Optimizado 1 8 = abandono optimizado 9 = puja base por debajo de abandono
is_takeover	booleano	Sí	"Yes"	Indica si una impresión fue Blanked o Defaulted porque al menos uno de los anuncios de la solicitud de varios anuncios era una toma de control. Devuelve true si la impresión forma parte de una solicitud de adquisición; de lo contrario, devuelve false.

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
imps_total	Entero	2340	Diablillos	El número total de impresiones (servidas y revendidas).
imps_sold	Entero	42500	imps_sold	El número de impresiones que has vendido a otros miembros.
imps_default	Entero	321	imps_default	El número de impresiones que se instalaron de forma predeterminada.
imps_blank	Entero	3	imps_blank	El número de impresiones servidas con un espacio en blanco.
imps_psa	Entero	5	imps_psa	El número de impresiones servidas con un anuncio de servicio público.
imps_psa_error	Entero	0	imps_psa_error	El número de impresiones servidas con un PSA debido a un error predeterminado.
imps_default_error	Entero	0	imps_default_error	El número de impresiones que se produjeron de forma predeterminada debido a un problema de tiempo de espera.
imps_default_bidder	Entero	0	imps_default_bidder	El número de impresiones que se produjeron de forma predeterminada porque no había pujas válidas.
imps_kept	Entero	0	imps_kept	El número de impresiones conservadas (directas).
imps_resold	Entero	0	imps_resold	El número de impresiones revendidas.
imps_rtb	Entero	2332	imps_rtb	El número de impresiones rtb.
external_impression	Entero	0	external_impression	El número de impresiones externas.
external_click	Entero	0	external_click	El número de clics externos.
clicks	Entero	545	clics	El número total de clics en todas las impresiones.
click_thru_pct	double	1.12359550561797	(clics / diablillos) * 100	La tasa de clics a impresiones como porcentaje.
total_convs	Entero	90	post_click_convs + post_view_convs	El número total de conversiones posteriores a la vista y a los clics.
post_view_convs_pixel	Entero	23		Conversiones de vista de publicación para el píxel. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), consulte Atribución de conversiones (Microsoft Monetize) o Atribución de conversiones (Microsoft Invest).
post_clicks_convs_pixel	Entero	15		Conversiones de clics posteriores para el píxel. Conversiones de vista de publicación para el píxel. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), consulte Atribución de conversiones (monetizar) o Atribución de conversiones (invertir).
ctr	double	0.2327836	Clics / Diablillos * 100	La tasa de clics a impresiones.
convs_rate	double	0.0384413	total_convs / diablillos * 100	La tasa de conversiones a impresiones.
convs_per_mm	double	221.877080097625	(total_convs / diablillos) x 1.000.000	El número de conversiones por millón de impresiones.
network_revenue	dinero	1201.13	network_revenue	Los ingresos de la red se reservan a través de anunciantes directos y se revenden a compradores en tiempo real.
total_network_rpm	dinero	2.60548314606741	(network_revenue / diablillos) x 1000	Los ingresos de red por cada 1000 impresiones.
publisher_revenue	dinero	400.05	publisher_revenue	Los ingresos pagados al editor (basados en revshare o cpm).
publisher_revenue_pub_curr	dinero	400.05	publisher_revenue	Los ingresos pagados a la editorial (basados en revshare o cpm), en la moneda de la editorial.
publisher_rpm_pub_curr	dinero	1.71	(publisher_revenue / diablillos) x 1000	Los ingresos del editor por cada 1000 impresiones, en la moneda del editor.
network_profit	dinero	801.08	(ingresos reservados + ingresos del revendedor): total_cost	La suma de los ingresos reservados y los ingresos del revendedor menos el costo total.
network_roi	dinero			En desuso. El retorno de la inversión para la red.
network_roi_net_commissions	double			En desuso.
network_rpm	dinero	3.42	(network_revenue / diablillos) x 1000	Los ingresos de red por cada 1000 impresiones.
sold_network_rpm	double
publisher_rpm	dinero	1.71	(publisher_revenue / diablillos) x 1000	Los ingresos del editor por cada 1000 impresiones.
total_publisher_rpm	dinero
sold_publisher_rpm	double
network_ppm	dinero	9.23	(ganancias / imps) x 1000	En desuso. El beneficio por cada 1000 impresiones.
network_revenue_net_commissions	dinero			En desuso.
network_profit_net_commissions	dinero			En desuso.
network_rpm_net_commissions	dinero			En desuso.
network_ppm_net_commissions	dinero			En desuso.
media_cost_pub_curr	dinero	16.833378	media_cost_pub_curr	El costo total del inventario comprado, en la moneda del editor.
commissions	dinero	0	Comisiones para líneas estándar, 0 $ para ALI.	Tarifas que salen de los ingresos registrados. Comisiones para líneas estándar, 0 $ para ALI.
serving_fees	dinero	0.025143	Tarifas de servicio para artículos de línea estándar, $0 para ALI.	Tarifas que se agregan al costo de los medios. Tarifas de servicio para artículos de línea estándar, $0 para ALI.
imps_viewed	Entero	30,450	imps_viewed	El número de impresiones medidas que fueron visibles según la definición de visibilidad de IAB.
view_measured_imps	Entero	10,120	view_measured_imps	El número total de impresiones que se midieron para la visibilidad.
view_rate	double	58%	view_rate	El porcentaje de impresiones visibles del total de impresiones medidas para la visibilidad. (Diablillos vistos / Ver diablillos medidos)
view_measurement_rate	double	45%	view_measurement_rate	El porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver Imps / Imps medidos)
partner_fees	dinero	123.45		El importe total de los costes de terceros, presupuestados mediante el Servicio de honorarios de partners, que se han acumulado en una línea de pedido aumentada durante el período de tiempo informado.
total_cost	dinero	123.45	total_cost = media_cost + data_costs + partner_fees + comisiones + serving_fees + publisher_revenue	La cantidad total de costos acumulados durante el período de tiempo informado. Esto generalmente incluye dos tipos de costos, costos presupuestados (costo de medios, costo de datos, tarifas de socios, tarifas de servicio, comisiones) e ingresos del editor si realiza un seguimiento de los pagos del editor en la plataforma. Nota: Hemos agregado lógica para evitar la doble contabilización de las tarifas de terceros durante el período de cambio de ruptura.
total_cost_ecpm	dinero	123.45	(total_cost/imps) * 1,000	El costo total por cada 1,000 diablillos.
total_cost_ecpc	dinero	123.45	total_cost/clics	El coste total por clic.
total_cost_ecpa	dinero	123.45	total_cost/conversiones	El coste total por conversión.
network_profit_ecpm	dinero	123.45	((booked_revenue + reseller_revenue - costo total) / diablillos) * 1,000	Beneficio de la red por cada 1.000 diablillos.
network_profit_ecpc	dinero	123.45	(booked_revenue + reseller_revenue - coste total)/clics	Beneficio por clic de red.
network_profit_ecpa	dinero	123.45	(booked_revenue + reseller_revenue - coste total)/conversiones	Beneficio de red por conversión.
network_profit_margin	dinero	123.45	(booked_revenue + reseller_revenue - coste total)/(booked_revenue + reseller_revenue)	Margen de beneficio de la red.
buying_currency_total_segment_data_costs	dinero	123.45	total_segment_data_costs * advertiser_exchange_rate	Todos los costos relacionados con el uso de segmentos en el mercado de datos. Es aplicable cuando se aplican segmentos específicos en las partidas y los precios asociados se muestran en la plataforma. Está en la moneda que usó el comprador para comprar el inventario.
selling_currency_total_segment_data_costs	dinero	123.45	total_segment_data_costs * publisher_exchange_rate	Todos los costos relacionados con el uso de segmentos en el mercado de datos. Es aplicable cuando se aplican segmentos específicos en las partidas y los precios asociados se muestran en la plataforma. Está en la moneda que utilizó el vendedor para vender el inventario.

Ejemplo

Crear solicitud de informe con formato JSON

{code}$ cat network_publisher_analytics
{
    "report":
    {
        "report_type":"network_publisher_analytics",
        "columns":[
            "hour",
            "buyer_member_id",
            "inventory_source",
            "gender",
            "imps_total",
            "imps_sold",
            "imps_default",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "row_per":[
            "hour",
            "buyer_member_id",
            "inventory_source_id",
            "gender"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}
{code}

POST la solicitud al servicio de informes

{code}$ curl -b cookies -c cookies -X post -d @network_publisher_analytics "https://api.appnexus.com/report?publisher_id=4642"
{
   "response":{
      "status":"OK",
      "report_id":"f4ebb93755dd01dde4fc157f86198ea9"
   }
}
{code}

GET el estado del informe desde el servicio de informes

Realice una GET llamada con el ID de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que se execution_status ."ready" Después, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.

{code}$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=f4ebb93755dd01dde4fc157f86198ea9"
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:37:31",
         "json_request":"{\"report\":{\"report_type\":\"network_publisher_analytics\",\"columns\":[\"hour\",\"buyer_member_id\",\"inventory_source\",
            \"gender\",\"imps_total\",\"imps_sold\",\"imps_default\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"buyer_member_id\",\"inventory_source_id\",\"gender\"],\"report_interval\":\"last_48_hours\",
            \"filters\":[{\"publisher_id\":\"4642\"}]}}",
         "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}
{code}

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 ID del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo que especificó en POSTel "format" archivo .

Nota:

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.

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_publisher_analytics.csv
{code}

Nota:

Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.