Informe de rendimiento del dominio de sitio

Artículo
05/17/2024

El informe rendimiento del dominio del sitio se puede usar para ver los datos de rendimiento y optimización por dominio para un anunciante específico.

Sugerencia

Para ver los datos de rendimiento y optimización por dominio para varios anunciantes, use el informe Rendimiento del dominio del sitio 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

Período de tiempo

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

yesterday
last_7_days
month_to_date
month_to_yesterday

Si usa los start_date campos y end_date para definir el intervalo de tiempo, no start_date debe ser superior a 45 días en el pasado. Dado que los datos por hora no están disponibles para este informe, start_date no end_date pueden ser idénticos y deben tener el formato en "YYYY-MM-DD" lugar de "YYYY-MM-DD HH:MM:SS". Los datos del informe solo se pueden devolver para la zona horaria UTC.

Período de retención de datos

El período de retención de datos para este informe es de 45 días.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
`month`	date	sí	`11/1/11`	El mes y el año (con el primer día del mes).
`day`	date	sí	`11/16/11`	Día, mes y año.
`site_domain`	string	no	`bestsiteever.com - or - itunes.apple.com/app/app-name/id1234567`	Dominio donde se produjo la impresión. En el caso de las aplicaciones móviles, puede ser la dirección URL de la ubicación de la aplicación en la tienda de aplicaciones. Hay dos valores adicionales que pueden aparecer en lugar de un dominio, específicamente: `"deals.unknown"` o `"managed.unknown"`. Esto significa que no recibimos un dominio válido como referencia. Por ejemplo, el dominio puede estar en blanco o de otro modo malformado.
`campaign`	string	no	`ExampleCampaign (123456)`	Nombre de la campaña seguido del identificador (formato Xandr).
`campaign_id`	Entero	sí	`123456`	Identificador de la campaña.
`campaign_code`	string	no	`CampaignCode`	Código personalizado para la campaña.
`campaign_name`	string	no	`ExampleCampaign`	Nombre de 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.
`line_item`	string	no	`ExampleLineItem (323)`	Nombre del elemento de línea seguido del identificador (formato Xandr).
`line_item_id`	Entero	sí	`323`	Identificador del elemento de línea.
`line_item_name`	string	no	`ExampleLineItem`	Nombre del elemento de línea.
`campaign_group`	string	no	`ExampleCampaign(123)`	Nombre del grupo de campaña seguido del identificador (formato Xandr). Nota: `campaign_group` es sinónimo `line_item`de .
`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`.
`top_level_category_id`	Entero	sí	`19821`	Identificador de la categoría de contenido superior asignada al dominio. Este campo puede ser `0` si el dominio no `second_level_category` tiene ninguna categoría primaria.
`top_level_category_name`	string	sí	`"Shopping"`	Nombre de la categoría de contenido superior asignada al dominio. Este campo puede estar en blanco si el dominio no `second_level_category` tiene ninguna categoría primaria.
`top_level_category`	string	sí	`"Shopping (19821)"`	Nombre e identificador de la categoría de contenido superior asignada al dominio. Este campo puede estar en blanco si el dominio no `second_level_category` tiene ninguna categoría primaria.
`second_level_category_id`	Entero	sí	`20129`	Identificador de la categoría de contenido de segundo nivel asignada al dominio. Nota: Si el dominio es una categoría de nivel superior, no debe solicitar esta dimensión.
`second_level_category_name`	string	sí	`"Shoes"`	Nombre de la categoría de contenido de segundo nivel asignada al dominio. Nota: Si el dominio es una categoría de nivel superior, no debe solicitar esta dimensión.
`second_level_category`	string	sí	`"Shoes (20129)"`	Identificador y nombre de la categoría de contenido de segundo nivel asignada al dominio. Nota: Si el dominio es una categoría de nivel superior, no debe solicitar esta dimensión.
`deal_id`	Entero	Yes	`2345`	El identificador de la transacción. Para obtener más información sobre las ofertas que ha negociado con los vendedores, consulte Deal Buyer Access Service.
`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)"`	Nombre de la oferta seguido del identificador (formato Xandr).
`deal_code`	string	No	`"External seller deal code"`	Código personalizado para la oferta. En el caso de las ofertas con asociados de suministro externos, esta suele ser la cadena que se usa para identificar la oferta.
`advertiser`	string	no	`ExampleAdvertiser (123)`	Nombre del anunciante seguido del identificador (formato Xandr).
`campaign_group_name`	string	no	`ExampleGroupName`	Nombre del grupo de campañas
`advertiser_id`	Entero	sí	`123`	El identificador del anunciante.
`campaign_group_id`	Entero	no	`123`	Número de identificación único del grupo de campañas
`advertiser_code`	string	no	`AdvertiserCode`	Código personalizado para el anunciante.
`advertiser_name`	string	no	`ExampleAdvertiser`	Nombre del anunciante.
`buyer_member`	string	no	`MyNetwork (4567)`	Nombre del miembro de compra seguido del identificador (formato Xandr).
`buyer_member_id`	Entero	sí	`4567`	Identificador del miembro de compra.
`buyer_member_name`	string	no	`MyNetwork`	Nombre del miembro que compra.
`supply_type`	string	Sí	`mobile_web`	El canal clasificado por el vendedor para denominar el suministro en términos de web, web optimizado para dispositivos móviles e impresiones de aplicaciones móviles. Los valores posibles son: - `'web'` - `'mobile_app'` - `'mobile_web'`
`mobile_application_id`	string	Sí	`‘343200656’ (iOS) or ‘com.rovio.angrybirds’ (Android)`	Un identificador de apple App Store de destino, un nombre de paquete de Google Play o un identificador de aplicación de Windows.
`mobile_application_name`	string	Sí	`Angry Birds`	Nombre de la aplicación móvil tal como aparece en Apple App y Google Play Stores.
`mobile_application`	string	No	`Angry Birds (com.rovio.angrybirds)`	Nombre de la aplicación móvil seguido del identificador (formato Xandr).
`fold_position_id`	Entero	Yes	`0`	Identificador de la posición del pliegue, es decir, dónde se encuentra la ubicación en la página. Valores posibles para las impresiones: `0` = "unknown" `1` = "arriba" `2` = "abajo"
`fold_position`	string	Sí	`"Unknown"`	La posición del plegado, es decir, donde se encuentra la ubicación en la página. Para ver los valores permitidos, vea `fold_position_id`.
`age_bucket`	string	Sí	`"25-34"`	Cubo para la antigüedad del usuario. Consulte Age Buckets (Depósitos de edad) a continuación para ver los valores posibles. Nota: Para las impresiones anteriores a 100 días, `age_bucket` será `"unknown"`.
`age_bucket_id`	string	No	`"3"`	Identificador del cubo de edad. Consulte Age Buckets (Depósitos de edad) a continuación para ver los valores posibles. Nota: Para las impresiones anteriores a 100 días, `age_bucket_id` será `0`.
`gender`	string	Sí	`"m"`, `"f"`, `"u"`	El sexo del usuario. Nota: Para las impresiones anteriores a 100 días, `gender` será `"u"`.
`is_remarketing`	Entero	Yes	`0`, `1`	Si `1`es , la campaña es de remarketing. Si `0`es , la campaña no es de remarketing. Nota: Para las impresiones anteriores a 100 días, `is_remarketing` será `-1`.
`pixel_id`	Entero	sí	`1942`	Número de identificación único del píxel de conversión. Nota: Esta dimensión devolverá un máximo de 10 píxeles de conversión. Además, puede filtrar por no más de 10 píxeles de conversión. Aunque `pixel_id` es agrupable, no se recomienda agrupar por esta dimensión, ya que si lo hace, los eventos de conversión se mostrarán en filas independientes de los eventos de impresión y clic. Por lo general, se supone que desea ver todos estos eventos en una sola fila para poder recuperar valores precisos y agregados para los cálculos de tasa de conversión y costo por conversión. Como resultado, se recomienda filtrar por `pixel_id` para poder recuperar recuentos de conversiones y métricas relacionadas para los identificadores de píxeles más relevantes.
`operating_system_id`	Entero	Yes	`24`	Identificador del sistema operativo del dispositivo. - Use el servicio de familia del sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
`operating_system_name`	string	Sí	`"Android 2.3.5 Gingerbread"`	Identificador del sistema operativo del dispositivo. - Use el servicio de familia del sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
`operating_system_family_id`	Entero	Yes	`2`	Identificador del sistema operativo del dispositivo. - Use el servicio de familia del sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
`operating_system_family_name`	string	Sí	`"Android"`	Identificador del sistema operativo del dispositivo. - Use el servicio de familia del sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
`seller_member_id`	Entero	Yes	`12345`	Identificador del miembro del vendedor asociado al dominio del sitio.
`seller_member_name`	string	No	`"BestSellerEver"`	Nombre del miembro del vendedor asociado al dominio del sitio.

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
`booked_revenue`	Dinero	`450.00`	booked_revenue	Los ingresos recibidos del anunciante. Para obtener más información, consulte Ingresos de red y facturación de los clientes en la documentación de la interfaz de usuario.
`clicks`	Entero	`2067`	Clics	Número total de clics.
`click_thru_pct`	double	`2.756%`	(clics/imps) * 100	Tasa de clics en impresiones como porcentaje.
`convs_per_mm`	double	`384.4`	(post_click_convs + post_view_convs /imps) * 1000 000	Número de conversiones por millón de impresiones.
`convs_rate`	double	`0.0003844`	(post_click_convs + post_view_convs) / imps	Tasa de conversiones a impresiones.
`cost_ecpa`	Dinero	`1.1111`	media_cost/(post_click_convs + post_view_convs)	Costo por adquisición o conversión.
`cost_ecpc`	Dinero	`0.1834`	media_cost/clics	Costo por clic.
`cpm`	Dinero	`5.00`	media_cost /imps * 1000	El costo por cada mil impresiones.
`ctr`	double	`0.22756`	clics o imps	Tasa de clics en impresiones.
`imps`	Entero	`75000`	Duendes	Número total de impresiones servidas.
`media_cost`	Dinero	`100.00`	media_cost	El gasto del miembro que compra. Para obtener más información, consulte Ingresos de red y facturación de los clientes en la documentación de la interfaz de usuario.
`post_click_convs`	Entero	`15`	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 conversiones posteriores al clic en impresiones.
`post_view_convs`	Entero	`10`	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.
`profit`	Dinero	`0.084102`	booked_revenue: total_cost	Ingresos reservados menos costo total.
`profit_ecpm`	Dinero	`0.7778`	((booked_revenue - media_cost) / imps) * 1000	Beneficio (definido como ingresos reservados menos costo total) por cada 1000 impresiones.
`imps_viewed`	Entero	`30,450`	imps_viewed	El número de impresiones medidas que se pueden ver según la definición de visualización de IAB, que indica que una impresión es visible si el 50 % de los píxeles se ven durante 1 segundo consecutivo.
`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)
`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_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.

Depósitos de edad

Id. de bucket	Nombre del cubo
`0`	`"unknown"`
`1`	`"13-17"8`
`2`	`"18-24"`
`3`	`"25-34"`
`4`	`"35-44"`
`5`	`"45-54"`
`6`	`"55-64"`
`7`	`"65+"`

Ejemplo

Create una solicitud de informe con formato JSON

$ cat domain_performance

{
    "report":
    {
        "report_type": "site_domain_performance",
        "columns": [
            "day",
            "campaign",
            "booked_revenue",
            "imps",
            "clicks",
            "click_thru_pct",
            "site_domain"
        ]
        "report_interval": "last_7_days",
        "emails": ["js@mynetwork.com"],
        "format": "csv"
    }
}

`POST` la solicitud al servicio de informes

En este ejemplo, solicitamos la ejecución del informe para el anunciante 660.

$ curl -b cookies -c cookies -X POST -d @domain_performance 'https://api.appnexus.com/report?advertiser_id=660'

{
    "response":{
        "status":"OK",
        "report_id":"07af1282c9485adcef49c95fa5d7496b"
    }
}

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=07af1282c9485adcef49c95fa5d7496b'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2011-11-16 23:51:14",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "fact-cache is off for report site_domain_performance",
            "json_request": "{\"report\":{\"report_type\":\"site_domain_performance\",\"columns\":[\"day\",\"campaign",
             "booked_revenue\",\"imps\",\"clicks\",\"click_thru_pct\",\"site_domain\"],\"report_interval\":\"last_7_days\",
             \"emails\":[\"js@mynetwork.com\"],\"filters\":[{\"buyer_member_id\":\"329\"},{\"advertiser_id\":\"660\"}]}}",
            "header_info": "Report type:,site_domain_performance\u000d\u000a,\u000d\u000aRun at:,2011-11-16 23:51:14\u000d\
             u000aStart date:,2011-11-09 00:00:00\u000d\u000aEnd date:,2011-11-16 00:00:00\u000d\u000aTimezone:,\u000d\
             u000aUser:,John Smith (9685)\u000d\u000a",
            "data": "day,campaign,booked_revenue,imps,clicks,click_thru_pct,site_domain\u000d\u000a2011-11-12,ExampleCampaign - 1
             (123456),.000000,24,0,.000000000000000000%,aaaa.com\u000d\u000a2011-11-13,ExampleCampaign - 2 (789012),.000000,9,0,
             .000000000000000000%,bbbb.net\u000d\u000a2011-11-12,ExampleCampaign - 3 (345678),.000000,2,0,.000000000000000000%,
             ccc.com\u000d\u000a2011-11-13,ExampleCampaign - 3 (345678),.000000,2,0,.000000000000000000%,cccc.de\u000du000a
             2011-11-14,ExampleCampaign - 3 (345678),.000000,10,0,.000000000000000000%,dddd.com\u000d\u000a2011-11-13,
             ExampleCampaign - 4 (901234), 2.574900,22,3,13.636363636363636364%,aaaa.com\u000d\u000a2011-11-15,ExampleCampaign - 3
             (345678),8.583000,2431,10,.411353352529823118%,abab.com\
             ...
            "url": "report-download?id=495d03a7667bac467bb488043ae336e9"
        },
        "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=495d03a7667bac467bb488043ae336e9' > /tmp/site_domain.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

Informe de rendimiento del dominio de sitio

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Depósitos de edad

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

Informe de rendimiento del dominio de sitio

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Depósitos de edad

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