Frecuencia y recencia creativas de red

Artículo
05/18/2024

El informe frecuencia creativa de red & recency se puede usar para ver los datos creativos de un anunciante específico en función de la frecuencia y la recenencia de las vistas del usuario. Este informe es más granular que el informe frecuencia creativa y recencia del anunciante y solo está disponible para los usuarios de red.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente. Este informe requiere especificar el identificador de anunciante como parte de la dirección URL, por ejemplo:

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

Período de tiempo

El report_interval campo se puede establecer en uno de los siguientes:

last_hour
hoy
yesterday
last_48_hours
last_2_days
last_7_days
last_14_days
month_to_date
last_30_days
last_month
last_100_days
Personalizado

Período de retención de datos

El período de retención de datos para este informe es de 120 días (sin datos antes del 26 de febrero de 2017).

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`	time	no	`"2010-02-01 06:00:00"`	La hora de la subasta.
`day`	time	no	`"2010-02-01"`	El día de la subasta.
`month`	time	no	`"2010-02"`	El mes de la subasta.
`creative_id`	Entero	sí	`554`	Identificador de la creatividad. Nota: Para los rastreadores de clics o impresiones externos, `creative_id` será `"External Clicks"` o `"External Imps"`.
`creative_name`	string	no	`"Q1 2010 728x90"`	Nombre de la creatividad. Nota: 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.
	string	sí	`"15-30 minutes"`	Cubo de la fecha en que se mostró la creatividad. Consulte Cubos de recencia creativa a continuación para ver los valores posibles.
`creative_recency_bucket_id`	string	no	`"4"`	Identificador del cubo de recencia creativa. Consulte Cubos de recencia creativa a continuación para ver los valores posibles.
`creative_frequency_bucket`	string	sí	`"11-20"`	Cubo de la frecuencia con la que se mostró la creatividad. Consulte Cubos de frecuencia creativa a continuación para ver los valores posibles.
`creative_frequency_bucket_id`	string	no	`"3"`	Identificador del cubo de frecuencia creativa. Consulte Cubos de frecuencia creativa a continuación para ver los valores posibles.
`buyer_member_id`	Entero	sí	`123`	Identificador del miembro de compra. Si no se compró la impresión, este campo muestra uno de los valores siguientes: `229` = PSA `0` = En blanco `319` = Valor predeterminado
`advertiser_id`	Entero	sí	`789`	El identificador del anunciante. Si el valor es `0`, la impresión la compró un comprador externo o se mostró o `PSAdefault` .
`advertiser_name`	string	no	`"Verizon Wireless"`	Nombre del anunciante.
`advertiser`	string	no	`"Verizon Wireless (789)"`	En desuso.
`advertiser_code`	string	no	`"Verizon Wireless Code"`	Código personalizado para el anunciante.
`insertion_order_id`	Entero	sí	`321`	Identificador del orden de inserción.
`insertion_order_name`	string	no	`"Insertion Order"`	Nombre del orden de inserción.
`insertion_order`	string	no	`"Insertion Order (321)`"	En desuso.
`insertion_order_code`	string	no	`"Insertion Order Code"`	Código personalizado para el orden de inserción.
`line_item_id`	Entero	sí	`111`	Identificador del elemento de línea.
`line_item_name`	string	no	`"Default Line Item"`	Nombre del elemento de línea.
`line_item`	string	no	`"Default Line Item (111)"`	En desuso.
`line_item_code`	string	no	`"Default Line Item Code"`	Código personalizado para el elemento de línea.
`campaign_id`	Entero	sí	`222`	Identificador de la campaña.
`campaign_name`	string	no	`"Default Campaign"`	Nombre de la campaña.
`campaign`	string	no	`"Default Campaign (222)"`	En desuso.
`campaign_code`	string	no	`"Default Campaign 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	sí	`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`.
`size`	string	sí	`"728x90"`	Tamaño de la colocación/creatividad servida.
`is_remarketing`	Entero	sí	`0`, `1`	Si `1`es , la campaña es de remarketing. Si `0`es , la campaña no es de remarketing.
`bid_type`	string	Sí	`"Manual"`	La fase de optimización en la que se encontraba el nodo al pujar por esta impresión. Tenga en cuenta que el término "renunciar" se anexa a los tipos de oferta siguientes si la valoración de esa impresión está por debajo del "precio de renuncia" del lugar. Para obtener más información, consulte ¿Qué es un lugar? y Precio de entrega en la documentación de la interfaz de usuario. Valores permitidos: - `"Manual"`: se aplica cuando se puja por un objetivo de CPM, ya sea Base, EAP o ECP. - `"Learn"`: se aplica cuando se puja con optimización (CPA, CPC o margen) y todavía no tenemos suficientes datos para optimizar la puja. - `"Optimized"`: se aplica cuando se puja con optimización (CPA, CPC o margen) y tenemos suficientes datos para optimizar la puja. - `"Unknown"`: el nodo estaba en una fase de optimización desconocida. - `"Optimized give up"` - `"Learn give up"` - `"Manual give up"`
`media_type`	string	no	`"Banner"`, `"Pop"`, `"Interstitial"`, `"Video"`, `"Text"`, `"Expandable"`, `"Skin"`	El estilo de visualización general de un creativo. Puede usar el servicio de tipos de medios para ver la lista completa de tipos de medios.
`mediatype_id`	Entero	Yes	`1`	Identificador del estilo de presentación general de un creativo.
`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.
`user_group_for_campaign`	string	sí	`"Test"`	Grupo de usuarios de prueba o control de la campaña. Consulta el `"labels"` campo en el Servicio de campaña para obtener más detalles.

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
`imps`	Entero	`2340`	Duendes	El número total de impresiones (servidas y revendidas).
`clicks`	Entero	`1`	Clics	Número total de clics en todas las impresiones.
`total_convs`	Entero	`9`	post_click_convs + post_view_convs	Número total de conversiones posteriores y posteriores al clic.
`convs_rate`	double	`0.000221877080097626`	total_convs/imps	Tasa de conversiones a impresiones.
`click_convs_rate`	double	`0.1651376`	total_convs/clics	Tasa de conversiones a clics.
`click_conv_rate`	double	`0.000064`	total_convs/clics	Tasa de conversiones a clics. Nota: Este campo es idéntico a `click_convs_rate`.
`ctr`	double	`0.000221877080097626`	clics o imps	Tasa de clics en impresiones.
`click_thru_pct`	double	`1.12359550561797%`	(clics/imps) * 100	Tasa de clics en impresiones como porcentaje.
`post_click_convs`	Entero	`4`	post_click_convs	Número total de conversiones registradas después de hacer clic.
`post_click_convs_rate`	double	`0.0002`	post_click_convs/imps	Tasa de conversión posterior al clic en impresiones.
`post_click_revenue`	Dinero	`150.00`	post_click_revenue	Cantidad total de ingresos de conversión después del clic registrados.
`post_view_convs`	Entero	`5`	post_view_convs	Número total de conversiones posteriores a la vista registradas.
`post_view_convs_rate`	double	`0.00013`	post_view_convs/imps	Tasa de conversiones posteriores a la vista en impresiones.
`post_view_revenue`	Dinero	`300.00`	post_view_revenue	Cantidad total de ingresos de conversión posteriores a la vista registrados.
`media_cost`	Dinero	`100`	media_cost	Cantidad total gastada.
`cost_ecpm`	Dinero	`0.4271259`	(media_cost/imps) * 1000	El costo por cada 1000 impresiones.
`cost_ecpc`	Dinero	`0.1834`	media_cost/clics	Costo por clic.
`cost_ecpa`	Dinero	`0.1834`	media_cost/total_convs	Costo por atribución o conversión.
`booked_revenue`	Dinero	`25.767257`	booked_revenue	Los ingresos totales reservados a través de anunciantes directos (artículo de línea).
`profit_ecpm`	Dinero	`0.7778`	beneficio/imps * 1000	Beneficio (definido como ingresos reservados menos costo total) por 1000 imps.
`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.
`profit`	Dinero	`123.45`	booked_revenue: total_cost	Ingresos reservados menos costo total.
`profit_ecpc`	Dinero	`123.45`	(booked_revenue - total_cost)/clicks	Beneficio por clic.
`profit_ecpa`	Dinero	`123.45`	(booked_revenue - total_cost)/conversiones	Beneficio por conversión.
`profit_margin`	Dinero	`123.45`	(booked_revenue - total_cost)/booked_revenue	Margen de ganancia del comprador.
`video_skips`	Entero	`10`		Número total de veces que un usuario omitió el vídeo. Use esta métrica para informar al comprar inventario omitible.
`video_starts`	Entero	`11`		El número total de veces que se descargó e inició el primer segmento de la creatividad de vídeo.
`video_25_pcts`	Entero	`10`		El número total de veces que las creatividades de vídeo completaron el 25 % de toda la duración.
`video_50_pcts`	Entero	`10`		El número total de veces que las creatividades de vídeo completaron el 50 % de toda la duración.
`video_75_pcts`	Entero	`10`		El número total de veces que las creatividades de vídeo completaron el 75 % de toda la duración.
`video_completions`	Entero	`12`		El número total de veces que las creatividades de vídeo se reproducen durante todo el tiempo.
`video_served`	Entero	`10`		El número total de respuestas de vídeo que se han servido al reproductor. Una respuesta de anuncio se produce cuando se proporciona el documento VAST (XML) en respuesta a una solicitud. Una respuesta de anuncio no indica necesariamente una impresión correcta. Para una impresión, el primer fotograma del vídeo debe ser servido.
`video_errors`	Entero	`2`		Número total de veces que se produjo un error de vídeo.
`revenue_per_video_complete`	Dinero	`25.76`		Ingresos por finalización de vídeo.
`cost_per_video_complete`	Dinero	`22.76`		Costo por finalización de vídeo.
`video_completion_rate`	double	`1.12359550561797%`	(finalizaciones de vídeo/total de impresiones) x 100	Relación entre las finalizaciones de vídeo y las impresiones, expresada como un porcentaje.
`video_start_rate`	double	`1.12359550561797%`		Porcentaje de veces que se descargó e inició el primer segmento de la creatividad de vídeo.
`video_skip_rate`	double	`1.12359550561797%`		Porcentaje de veces que el usuario optó por omitir el vídeo.

Cubos de frecuencia creativa

Id. de bucket	Nombre del cubo
`-2`	`"no-cookie-date"`
`-1`	`"no-cookie"`
`0`	`"0"`
`1`	`"1"`
`2`	`"2-5"`
`3`	`"6-10"`
`4`	`"11-20"`
`5`	`"21-40"`
`6`	`"41-60`
`7`	`"61-100"`
`8`	`"101-150"`
`9`	`"151-250"`
`10`	`"251-500"`
`11`	`"500+"`

Cubos de recencia creativa

Id. de bucket	Nombre del cubo
`-2`	`"no-cookie-date"`
`-1`	`"no-cookie"`
`0`	`"< 1 minute"`
`1`	`"1-5 minutes"`
`2`	`"5-15 minutes"`
`3`	`"15-30 minutes"`
`4`	`"30-60 minutes"`
`5`	`"1-4 hours"`
`6`	`"4-12 hours"`
`7`	`"12-24 hours"`
`8`	`"1-2 days"`
`9`	`"2-7 days"`
`10`	`"8-14 days"`
`11`	`"14-30 days"`

Ejemplo

Create una solicitud de informe con formato JSON

$ cat network_advertiser_frequency_recency

{
    "report":
    {
        "report_type": "network_advertiser_frequency_recency",
        "columns": [
            "creative_recency_bucket",
            "creative_frequency_bucket",
            "creative_id",
            "imps",
            "clicks",
            "total_convs",
            "booked_revenue",
            "media_cost",
            "profit_ecpm"
        ],
        "report_interval": "last_7_days",
        "emails": ["jsmith@xandr.com"],
        "format": "csv"
    }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -c cookies -X post -d @network_frequency_recency 'https://api.appnexus.com/report?advertiser_id=384'

{
    "response": {
        "status": "OK",
        "report_id": "0f148df60ff2760d57014f607f46fce4"
    }
}

Uso del identificador de informe para recuperar los datos del informe

La respuesta estándar incluye los datos del informe y una dirección URL de descarga que puede usar para guardar los datos en un archivo. Si desea obtener solo la dirección URL de descarga sin los datos del informe, pase "without_data" la cadena de consulta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=0f148df60ff2760d57014f607f46fce4'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2012-02-03 22:00:33",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 2,4,44,30,31,66,32,34,9,17,16,36",
            "json_request": "{\"report\":{\"report_type\":\"network_advertiser_frequency_recency\",
             \"columns\":[\"creative_recency_bucket\",\"creative_frequency_bucket\",\"creative_id\",
             \"imps\",\"clicks\",\"total_convs\",\"booked_revenue\",\"media_cost\",\"profit_ecpm\"],
             \"report_interval\":\"last_7_days\",\"emails\":[\"js@email.com\"],\"filters\":
             [{\"buyer_member_id\":\"541\"},{\"advertiser_id\":\"3610\"}]}}",
            "header_info": "Report type:,network_advertiser_frequency_recency\r\n,\r\nRun at:,
             2012-02-03 22:00:33\r\nStart date:,2012-01-27 00:00:00\r\nEnd date:,2012-02-03 00:00:00
             \r\nTimezone:,\r\nUser:,John Smith (9685)\r\n",
            "data": "creative_recency_bucket,creative_frequency_bucket,creative_id,imps,clicks,
             total_convs,booked_revenue,media_cost,profit_ecpm\r\n7-14 days,6-10,753570,1,0,0,.000000,
             .000000,.000000000000000000000000\r\n15-30 minutes,151-250,753571,3,0,0,.000000,.000000,
             .000000000000000000000000\r\n1-2 days,11-20,1316901,12,0,0,.000000,.004200,-.350000000000
             000000000000\r\n1-2 days,11-20,1316886,6,0,0,.000000,.001900,-.316666666666666666667000\r
             \n7-14 days,21-40,773408,3,0,0,.000000,.000160,-.053333333333333333333000\r\n30-60 minutes,
             500+,700464,35,0,0,.000000,.000000,.000000000000000000000000\r\n30-60 minutes,2-5,1317391,
             ...
            "url": "report-download?id=0f1374f60ff2760d57014f607f46fce4"
        },
        "execution_status": "ready"
    }
}

Use la dirección URL de descarga para guardar los datos del informe en un archivo.

Use el "url" campo en la respuesta para guardar los datos del informe en un archivo. Simplemente realice otra GET llamada e identifique la ubicación y el archivo en los que desea guardar. Asegúrese de usar el archivo de la extensión de "format" que especificó en la solicitud inicial POST .

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=0f1374f60ff2760d57014f607f46fce4' > /tmp/network_frequency.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

Frecuencia y recencia creativas de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Cubos de frecuencia creativa

Cubos de recencia creativa

Ejemplo

Create una solicitud de informe con formato JSON

`POST` la solicitud al servicio de informes

Uso del identificador de informe para recuperar los datos del informe

Use la dirección URL de descarga para guardar los datos del informe en un archivo.

Recursos adicionales

Compartir a través de

Frecuencia y recencia creativas de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Cubos de frecuencia creativa

Cubos de recencia creativa

Ejemplo

Create una solicitud de informe con formato JSON

POST la solicitud al servicio de informes

Uso del identificador de informe para recuperar los datos del informe

Use la dirección URL de descarga para guardar los datos del informe en un archivo.

Recursos adicionales

`POST` la solicitud al servicio de informes