Frecuencia creativa y recencia del anunciante

Artículo
05/18/2024

El informe frecuencia creativa del anunciante & censura se puede usar para ver los datos creativos de un anunciante específico en función de la frecuencia y la recencia de las vistas del usuario. Este informe está disponible para anunciantes y usuarios de red.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes o vea el ejemplo siguiente. Para un usuario anunciante, el identificador de anunciante se detecta en función de la autenticación del usuario. Sin embargo, para un usuario de red, 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

Nota:

Ventana de reversión

Los datos de frecuencia y recencia están disponibles durante 120 días (sin datos antes del 26 de febrero de 2017).

Período de tiempo

El report_interval campo de la solicitud JSON 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.

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 (a partir del 17 de octubre de 2016).
`creative_recency_bucket`	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	Yes	`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`, un comprador externo compró la impresión o se mostró un valor predeterminado o PSA.
Un`dvertiser_name`	string	No	`"Verizon Wireless"`	Nombre del anunciante.
`advertiser`	string	No	`"Verizon Wireless (789)"`	En desuso (a partir del 17 de octubre de 2016).
`advertiser_code`	string	No	`"Virizon Wireless Code"`	Código personalizado para el anunciante.
`insertion_order_id`	Entero	Yes	`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 (a partir del 17 de octubre de 2016).
`insertion_order_code`	string	No	`"Insertion Order Code"`	Código personalizado para el orden de inserción.
`line_item_id`	Entero	Yes	`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 (a partir del 17 de octubre de 2016).
`line_item_code`	string	No	`"Default Line Item Code"`	Código personalizado para el elemento de línea.
`campaign_id`	Entero	Yes	`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 (a partir del 17 de octubre de 2016).
`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. 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`.
`size`	string	Sí	`"728x90"`	Tamaño de la colocación/creatividad servida.
`is_remarketing`	Entero	sí	`0`, `1`	Si la campaña está o no en el remarketing
`bid_type`	string	Sí	`"Manual"`	La fase de optimización en la que se encontraba el nodo al pujar por esta impresión. Nota: 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. Los valores permitidos son: - `"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.
`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) x 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

Cubos de frecuencia creativa

Id. de bucket	Nombre del cubo
`-2`	`"no-cookie-data"` (error en la búsqueda de cookies)
`-1`	`"no-cookie"` (el usuario no tiene cookies habilitadas)
`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-data"` (error en la búsqueda de cookies)
`-1`	`"no-cookie"` (el usuario no tiene cookies habilitadas)
`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"
        ],
        "report_interval": "last_7_days",
        "emails": ["js@email.com"],
        "format": "csv"
    }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -c cookies -X POST -d @network_advertiser_frequency_recency "https://api.appnexus.com/report?advertiser_id=384"

{
    "response": {
        "status": "OK",
        "report_id": "c458f71c084a2a3b51dcd749132bcf87",
        "dbg_info": {
            ...
        }
    }
}

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 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=c458f71c084a2a3b51dcd749132bcf87"

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2012-02-03 21:43:27",
            "cache_hit": true,
            "fact_cache_hit": false,
            "fact_cache_error": null,
            "json_request": "{\"report\":{\"report_type\":\"network_advertiser_frequency_recency\",
             \"columns\":[\"creative_recency_bucket\",\"creative_frequency_bucket\",\"creative_id\",
             \"imps\",\"clicks\",\"total_convs\"],\"report_interval\":\"last_7_days\",\"emails\":
             [\"js@email.com\"],\"filters\":[{\"buyer_member_id\":\"541\"},{\"advertiser_id\":
             \"3610\"}]}}",
            "header_info": null,
            "data": "creative_recency_bucket,creative_frequency_bucket,creative_id,imps,clicks,
             total_convs\r\nno-cookie,no-cookie,700454,47,0,0\r\n2-7 days,2-5,773422,31,0,
             0\r\n5-15 minutes,6-10,1298720,1,0,0\r\n14-30 days,151-250,700464,8,0,0\r\n7-14 days,
             21-40,711929,5,0,0\r\n1-4 hours,6-10,1317518,826,2,0\r\n1-4 hours,1,1317473,996,14,
             0\r\n12-24 hours,11-20,1317436,139,0,0\r\n15-30 minutes,6-10,773408,12,0,0\r\nno-cookie,
             no-cookie,1318994,3,0,0\r\n1-5 minutes,101-150,711932,898,0,0\r\n2-7 days,2-5,773408,45,
             0,0\r\n1-5 minutes,2-5,610381,7990,23,0\r\n12-24 hours,1,1316895,4790,30,0\r\n1-4 hours,
             ...
             "url": "report-download?id=c447d71c084a2a3b51dcd749132bcf87"
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

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=c447d71c084a2a3b51dcd749132bcf87' > /tmp/network_advertiser_frequency_recency.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 creativa y recencia del anunciante

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 creativa y recencia del anunciante

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