Análisis del publicador de red

El informe de Network Publisher Analytics se puede usar para ver los datos de rendimiento de un publicador específico dentro de la red que es más granular que los datos proporcionados en el informe de Network Analytics. Este informe solo está disponible para los usuarios de red. Los usuarios del publicador 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 publicador 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 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 el 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 Report Service.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
hour	date	no	"2010-02-01 06:00:00"	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.
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	Identificador del miembro de compra.
buyer_member_name	string	no	"Network"	Nombre del miembro que compra. Nota: El nombre podría ser "Default" o "Default Error", lo que significa que no había ningún comprador para la impresión y se sirvió una creatividad predeterminada.
buyer_member	string	no	"Network (567)"	En desuso.
seller_member_id	Entero	sí	67	Identificador del miembro vendedor.
advertiser_id	Entero	sí	728	El identificador del anunciante.
advertiser_name	string	no	"Test"	Nombre del anunciante.
advertiser	string	no	"Test (123)"	En desuso.
advertiser_code	string	no	"Code"	Código personalizado para el anunciante.
line_item_id	Entero	sí	554	Identificador del elemento de línea.
line_item_name	string	no	"Q1 Pepsi"	Nombre del elemento de línea.
line_item	string	no	"Q1 Pepsi (554)"	En desuso.
line_item_code	string	no	"Q1 Pepsi Code"	Código personalizado para el elemento de línea.
campaign_id	Entero	sí	567	Identificador de la campaña.
campaign_name	string	no	"Photos 728x90"	Nombre de la campaña.
campaign	string	no	"Photos 728x90 (567)"	En desuso.
campaign_code	string	no	"Photos Code"	Código personalizado para la campaña.
campaign_priority	Entero	no	5	Prioridad de puja de una campaña destinada al inventario directo. Para obtener más información, consulte Prioridad de las pujas en la documentación de la interfaz de usuario. Valores posibles: 1 - 10, donde 10 es la prioridad más alta.
split_id	Entero	Yes	342	Identificador de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. Para cualquier informe que contenga campañas, ( split_id si se incluye) será null.
split_name	string	Sí	"Mobile Split A"	Nombre de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. Para cualquier informe que contenga campañas, ( split_name si se incluye) será null.
creative_id	Entero	sí	554	Identificador de la creatividad. Nota: - Para las impresiones anteriores a 100 días, las creatividades se agregarán en una fila con 0 como .creative_id - Para seguimientos de clics o impresiones externos, creative_id será "External Clicks" o "External Imps".
brand_id	Entero	sí	3	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. Consulte el Informe de revisión de marca del vendedor en su lugar.
brand_name	string	no	"Ace Hardware"	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. Consulte el Informe de revisión de marca del vendedor en su lugar.
brand	string	no	"Ace Hardware (3)"	En desuso.
publisher_id	Entero	sí	6787	Número para identificar el publicador.
publisher_code	string	no	"Publisher Code"	Código personalizado para identificar al publicador.
publisher_currency	string	sí	"USD"	Moneda del publicador.
pub_rule_id	Entero	no	54	Número para identificar la regla del publicador.
pub_rule_name	string	no	"50% Revshare"	Nombre de la regla del publicador.
pub_rule	string	no	"50% Revshare (54)"	En desuso.
pub_rule_code	string	no	"50% Revshare Code"	Código personalizado para la regla del publicador.
site_id	Entero	sí	194	Identificador del sitio. Nota: Para las impresiones anteriores a 100 días, site_id será 0 .
site_name	string	no	"Site Name"	Nombre del sitio.
site	string	no	"Site Name (593)"	En desuso.
site_code	string	no	"Site Name Code"	Código personalizado para el sitio.
deal_id	Entero	Yes	2345	El identificador de la transacción. Para obtener más información sobre las ofertas negociadas entre compradores y vendedores, consulte Servicio de oferta y Servicio de acceso de compradores de ofertas.
deal_name	string	No	"Private deal for buyer 1085 with floor of $2.50"	Nombre de la oferta.
deal	string	No	"Private deal for buyer 1085 with floor of $2.50 (45)"	En desuso.
deal_code	string	No	"External seller deal code"	Código personalizado para la oferta.
geo_country	string	sí	"US"	El código de país o región geográfico.
geo_country_name	string	no	"Unites States"	Nombre del país/región.
size	string	no	"300x250"	El tamaño de la creatividad servida.
placement_id	Entero	sí	546	Identificador de la ubicación. Nota: En el caso de las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con -1 como placement_id.
placement_name	string	no	"300x250 Business"	Nombre de la ubicación. Nota: En el caso de las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con "All placement data older than 100 days" como placement_name.
placement	string	sí	"300x250 Business (546)"	En desuso.
placement_code	string	no	"300x250 Business Code"	Código personalizado para la ubicación.
imp_type_id	Entero	sí	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í	"Kept"	Tipo de impresión. Para obtener los valores posibles, vea imp_type_id.
buyer_type	string	sí	"Reseller"	Tipo de comprador, establecido por Xandr.
supply_type	string	no	"web"	Tipo de inventario. Posibles valores: - "web" - "mobile_web" - "mobile_app"
payment_type	string	sí	"cpm", "revshare"	Tipo de pago a un agente.
revenue_type	string	sí	"CPA"	La base en la que se paga al miembro.
revenue_type_id	Entero	sí	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
external_inv_id	Entero	Yes	4921	Identificador del código de inventario externo pasado en la llamada al anuncio y predefinido por el publicador. Para obtener más información, consulte Servicio de código de inventario externo. Para las impresiones anteriores a 100 días, external_inv_id será 0.
external_inv_name	string	No	"External Inv Name"	Nombre del código de inventario externo pasado en la llamada de anuncio y predefinido por el publicador. Para obtener más información, consulte Servicio de código 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 tipos de medios.
mediatype_id	Entero	sí	2	Solo lectura. Identificador del tipo de medio al que pertenece el subtipo.
adjustment_id	Entero	sí	890	Identificador del ajuste usado para realizar cambios en el costo multimedia o las impresiones, clics y conversiones que se ven en los informes de un publicador.
venue	string	sí	"Venue Name"	Nombre del clúster de dominio, sitio, etiqueta y país o región del usuario que el sistema de optimización de Xandr usa para determinar las valoraciones de las pujas. Una campaña no puede dirigirse explícitamente a un lugar.
predict_rev_type	Entero	sí	2	Fase de optimización de una campaña que sirvió en el inventario del publicador. Posibles valores: -2 = Ninguna fase de predicción -1 = Fase de predicción base 0 = Entrega de información 1 = Learn 2 = Limitado 3 = Optimizado 4 = Sesgado 5 = Optimizado 1 8 = Entrega optimizada 9 = Oferta base por debajo de la oferta

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
imps_total	Entero	2340	Duendes	El número total de impresiones (servidas y revendidas).
imps_sold	Entero	42500	imps_sold	Número de impresiones que ha vendido a otros miembros.
imps_default	Entero	321	imps_default	Número de impresiones predeterminadas.
imps_blank	Entero	3	imps_blank	Número de impresiones que se sirven con un espacio en blanco.
imps_psa	Entero	5	imps_psa	El número de impresiones que se sirven con una PSA.
imps_psa_error	Entero	0	imps_psa_error	Número de impresiones que se atienden con una PSA debido a un error predeterminado.
imps_default_error	Entero	0	imps_default_error	Número de impresiones predeterminadas debido a un problema de tiempo de espera.
imps_default_bidder	Entero	0	imps_default_bidder	Número de impresiones predeterminadas porque no había pujas válidas.
imps_kept	Entero	0	imps_kept	Número de impresiones guardadas (directas).
imps_resold	Entero	0	imps_resold	Número de impresiones revendidas.
imps_rtb	Entero	2332	imps_rtb	Número de impresiones rtb.
external_impression	Entero	0	external_impression	Número de impresiones externas.
external_click	Entero	0	external_click	Número de clics externos.
clicks	Entero	545	Clics	Número total de clics en todas las impresiones.
click_thru_pct	double	1.12359550561797	(clics/imps) * 100	Tasa de clics en impresiones como porcentaje.
total_convs	Entero	90	post_click_convs + post_view_convs	Número total de conversiones posteriores y posteriores al clic.
post_view_convs_pixel	Entero	23		Conversiones posteriores a la vista para el píxel. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), vea Atribución de conversión (Microsoft Monetize) o Atribución de conversión (Microsoft Invest).
post_clicks_convs_pixel	Entero	15		Conversiones de clic posteriores para el píxel. Conversiones posteriores a la vista para el píxel. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), vea Conversion Attribution (Monetize) o Conversion Attribution (Invest).
ctr	double	0.2327836	clics/ imps * 100	Tasa de clics en impresiones.
convs_rate	double	0.0384413	total_convs /imps * 100	Tasa de conversiones a impresiones.
convs_per_mm	double	221.877080097625	(total_convs/imps) x 1000 000	Número de conversiones por millón de 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.
total_network_rpm	dinero	2.60548314606741	(network_revenue/imps) x 1000	Ingresos de red por cada 1000 impresiones.
publisher_revenue	dinero	400.05	publisher_revenue	Los ingresos pagados al editor (en función de revshare o cpm).
publisher_revenue_pub_curr	dinero	400.05	publisher_revenue	Los ingresos pagados al editor (en función de revshare o cpm) en la moneda del publicador.
publisher_rpm_pub_curr	dinero	1.71	(publisher_revenue/imps) x 1000	Los ingresos del publicador por 1000 impresiones, en la moneda del publicador.
network_profit	dinero	801.08	(ingresos reservados + ingresos de 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/imps) x 1000	Ingresos de red por cada 1000 impresiones.
sold_network_rpm	double
publisher_rpm	dinero	1.71	(publisher_revenue/imps) x 1000	Ingresos del publicador por cada 1000 impresiones.
total_publisher_rpm	dinero
sold_publisher_rpm	double
network_ppm	dinero	9.23	(beneficio /imps) x 1000	En desuso. El beneficio por 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 publicador.
commissions	dinero	0	Comisiones para artículos de línea estándar, 0 USD para LASI.	Tarifas que provienen de los ingresos reservados. Comisiones para artículos de línea estándar, 0 USD para LASI.
serving_fees	dinero	0.025143	Tarifas de servicio para artículos de línea estándar, $0 para ALIs.	Tarifas que se agregan al costo de los medios. Tarifas de servicio para artículos de línea estándar, $0 para ALIs.
imps_viewed	Entero	30,450	imps_viewed	Número de impresiones medidas que se pueden ver según la definición de visualización de IAB.
view_measured_imps	Entero	10,120	view_measured_imps	Número total de impresiones que se midieron para la visibilidad.
view_rate	double	58%	view_rate	Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. (Imps/View Measured Imps)
view_measurement_rate	double	45%	view_measurement_rate	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 costos de terceros, presupuestados mediante el Servicio de tarifas de asociados, que se han acumulado en un artículo de línea aumentada durante el período de tiempo notificado.
total_cost	dinero	123.45	total_cost = media_cost + data_costs + partner_fees + comisiones + serving_fees + publisher_revenue	Importe total de los costos acumulados durante el período de tiempo notificado. Por lo general, esto incluye dos tipos de costos, costos presupuestados (costo de medios, costo de datos, cuotas de asociados, cuotas de servicio, comisiones) e ingresos del publicador si realiza un seguimiento de los pagos del publicador en la plataforma. Nota: Hemos agregado lógica para evitar el recuento doble de cuotas de terceros durante el período de cambio importante.
total_cost_ecpm	dinero	123.45	(total_cost/imps) * 1000	Costo total por 1000 imps.
total_cost_ecpc	dinero	123.45	total_cost/clics	Costo total por clic.
total_cost_ecpa	dinero	123.45	total_cost/conversiones	Costo total por conversión.
network_profit_ecpm	dinero	123.45	((booked_revenue + reseller_revenue - costo total)/imps) * 1000	Beneficio de red por 1000 imps.
network_profit_ecpc	dinero	123.45	(booked_revenue + reseller_revenue - costo total)/clics	Beneficio de red por clic.
network_profit_ecpa	dinero	123.45	(booked_revenue + reseller_revenue - costo total)/conversiones	Beneficio de red por conversión.
network_profit_margin	dinero	123.45	(booked_revenue + reseller_revenue - costo total)/(booked_revenue + reseller_revenue)	Margen de beneficio de 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 marketplace de datos. Es aplicable cuando se aplican segmentos específicos en artículos de línea y los precios asociados se muestran en la plataforma. Está en la moneda que el comprador usó 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 marketplace de datos. Es aplicable cuando se aplican segmentos específicos en artículos de línea y los precios asociados se muestran en la plataforma. Está en la moneda que el vendedor usó para vender el inventario.

Ejemplo

Creación de una 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 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 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 identificador de informe, pero esta vez al servicio de descarga de informes . 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.

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.