API de plataforma digital: servicio de informes
El servicio de informes se usa para proporcionar acceso a muchos tipos diferentes de informes. También garantiza que cada tipo de usuario solo puede acceder a los informes adecuados para ese tipo. Por ejemplo, los usuarios de red tienen acceso a todos los tipos de informe, mientras que los usuarios anunciantes y editores solo tienen acceso a algunos.
Las métricas disponibles varían en función del tipo de informe, pero pueden incluir cuánto dinero se gastó en el inventario, el número de impresiones vistas o vendidas, los ingresos obtenidos, etc. En este documento se describe cómo solicitar y descargar datos del servicio de informes. También se describe cómo obtener más información sobre cada uno de los tipos de informe admitidos, así como cómo proporcionar vínculos a documentación adicional sobre cada tipo de informe.
Nota:
- Para obtener más información sobre cómo sincronizar datos Xandr con la base de datos de informes, vea Fuentes de informes masivas.
- Se trata de un servicio de solo lectura; recibirá
POSTuna solicitud de informe con formato JSON, pero esto no modificará ninguno de los datos almacenados en nuestros servidores.
Tipos de informe
| Tipo de informe | Tipo de usuario | Descripción | Retención de datos |
|---|---|---|---|
Análisis de rednetwork_analytics |
Red | Introducción general a lo que está sucediendo. Lo que sirve, lo que está funcionando bien, tanto en el lado de la compra como de la venta. | Duración: algunos datos con granularidad reducida después de 100 días. |
Facturación de rednetwork_billing |
Red | Lo que podría necesitar para facturar a los anunciantes, lo que podrían facturar los editores o Xandr. | Duración: algunos datos con granularidad reducida después de 100 días. |
Informe de facturación de comprabuyer_invoice_report |
Red | Informes para la conciliación financiera con cargos relacionados con la compra. | 1095 días |
Informe de facturación de ventasseller_invoice_report |
Red | Informes para la conciliación financiera con cargos relacionados con la venta. | 1095 días |
Análisis de anunciantes de rednetwork_advertiser_analytics |
Red | Informes de red sobre anunciantes. | Duración: algunos datos con granularidad reducida después de 100 días. |
Network Publisher Analyticsnetwork_publisher_analytics |
Red | Informes de red en publicadores. | Duración: algunos datos con granularidad reducida después de 100 días. |
Análisis de publicadorpublisher_analytics |
Red, publicador | Informes de lo que debería ver un publicador. | Duración: algunos datos con granularidad reducida después de 100 días. |
Análisis de anunciantesadvertiser_analytics |
Red, anunciante | Informar de lo que debería ver un anunciante. | Duración: algunos datos con granularidad reducida después de 100 días. |
Análisis de vídeo de redvideo_analytics_network |
Red | Informes de eventos de vídeo entre anunciantes y publicadores. | 420 días |
Network Advertiser Video Analyticsvideo_analytics_network_advertiser |
Red | Informes de eventos de vídeo para un solo anunciante. | 420 días |
Network Publisher Video Analyticsvideo_analytics_network_publisher |
Red | Informes de eventos de vídeo para un único publicador. | 420 días |
Informe de rendimiento del segmento de compradorbuyer_segment_performance |
Red | Informes sobre el rendimiento de los segmentos entre campañas y varios anunciantes. | 45 días |
Informe de revisión de marca del vendedorseller_brand_review |
Red | Informes sobre el rendimiento de la marca en todo el inventario de la red. | 428 días |
Informe de revisión de marca del publicadorpublisher_brand_review |
Publisher | Informes sobre el rendimiento de la marca en todo el inventario del publicador. | 428 días |
Frecuencia creativa de red & censuranetwork_advertiser_frequency_recency |
Red | Informes de red sobre la frecuencia creativa y la recencia de un solo anunciante. | 120 días |
Frecuencia creativa del anunciante & recenciaadvertiser_frequency_recency |
Red, anunciante | Informar de lo que un anunciante debería ver sobre su frecuencia creativa y su recencia. | 120 días |
Rendimiento del dominio del sitio de rednetwork_site_domain_performance |
Red | Informes de red sobre el rendimiento del dominio entre anunciantes. | 45 días |
Informe de rendimiento de dominio de sitiosite_domain_performance |
Red, anunciante | Informes sobre el rendimiento del dominio para un solo anunciante. | 45 días |
Dominio del sitio de vendedoresseller_site_domain |
Red | Generación de informes sobre el inventario que se envía a través de un publicador. | 60 días |
Informe de cargas de segmentossegment_load |
Red | Informes de red en segmentos. | 30 días |
Conversiones con atributos de anuncianteattributed_conversions |
Red | Informes de red sobre las conversiones atribudas de los anunciantes. | 90 días |
Informe de análisis geográficogeo_analytics |
Red | Desglosar la entrega y el rendimiento de la campaña por área geográfica. | 45 días |
Análisis de operadores de rednetwork_carrier_analytics |
Red | Informe sobre los datos de rendimiento de compra y venta basados en operadores de dispositivos móviles. | 46 días |
Análisis de dispositivos de rednetwork_device_analytics |
Red | Informe sobre los datos de rendimiento de compra y venta en función de los dispositivos en los que se han servido las impresiones. | 428 días |
Último disparo del píxel de conversiónpixel_fired |
Red | Informes de red sobre la fecha y hora del último incendio de los píxeles de conversión de anunciantes. | Vida |
Informe de auditorías creativas completadocompleted_creative_audits |
Red | Informe de red diseñado para proporcionar información sobre cómo se mueven las creatividades a través del proceso de auditoría | 365 días |
Fuentes de informes masivasnetwork_analytics_feedclicktrackers |
Red | La capacidad de sincronizar los informes agregados con la base de datos de informes. | 30 días |
Informe de uso de datosbuyer_data_usage_analytics |
Red | Informe de red que proporciona detalles sobre el uso de los datos proporcionados por terceros (por ejemplo, proveedores de segmentos de usuarios), los costos de ese uso de datos y los elementos de línea o campañas en los que esos datos se usaron para dirigirse a los usuarios. | 60 días |
Informe de uso del proveedorbuyer_vendor_usage_analytics |
Red | Informe de red que proporciona los detalles sobre el uso de datos o plataforma con tecnología de proveedores externos (por ejemplo, proveedores de segmentos de usuario), los costos de esos datos o uso de características y los artículos de línea o campañas en los que se aplicaban los costos del proveedor. | 60 días |
Informe de interacción del comprador buyer_engagement_report |
Anunciante | Proporciona información sobre la duración visible de las creatividades de pantalla y vídeo. | Últimas cinco semanas |
Métricas de la oferta del compradorbuyer_deal_metrics |
Anunciante, red | Información clave sobre las métricas de las ofertas, el rendimiento y los motivos de rechazo que son relevantes para los compradores. | 30 días |
Métricas de la oferta de vendedoresseller_deal_metrics |
Publicador, Red | Información clave sobre las métricas de las ofertas, el rendimiento y los motivos de rechazo que son relevantes para los vendedores. | 30 días |
Métricas de la oferta de vendedores multi-compradormulti_buyer_seller_deal_metrics |
Publicador, Red | Información clave sobre las métricas de la oferta, el rendimiento y los motivos de rechazo que son relevantes para el vendedor. | 30 días |
Análisis de valor clavekey_value_analytics |
Red | Informes de red sobre la información asociada a los valores y claves de destino definidos de la red. Las impresiones con destino clave-valor servirán y se notificarán solo para aquellas impresiones que se registraron mediante una etiqueta de selección de ubicación que contiene el prefijo kw_ en el nombre de la clave. | 428 días |
Informe de análisis del conservadorcurator_analytics |
Curador | Proporciona a los conservadores información sobre cómo fluye el dinero de la demanda a la oferta dentro de su marketplace mantenido. | 14 meses |
Informe de rendimiento de segmentos del conservadorcurator_segment_performance |
Curador | Proporciona a los conservadores información sobre cómo sus segmentos de destino contribuyen al rendimiento general de sus ofertas seleccionadas. | 14 meses |
Informe de alcance y frecuencia del compradorbuyer_approximate_unique_users_hourly |
Red | Proporciona la información asociada con "reach", que es el número de dispositivos únicos o personas expuestas a anuncios y "frecuencia", que es el número promedio de veces que cada dispositivo o persona único fue expuesto a anuncios. | 90 días |
Informe de atribución sin conexiónoffline_attribution |
Anunciante | Proporciona información sobre el rendimiento del artículo de línea al influir en las compras en la tienda entre el público objetivo. El informe de atribución sin conexión solo es accesible para los clientes que tienen habilitada la atribución de ventas sin conexión para sus elementos de línea. | 120 días |
Informe de análisis de CMP de vendedorescmp_analytics |
Red | Proporciona información sobre el número, la validez y el contenido de las cadenas de IAB Transparency & Consent Framework (IAB TCF) en las solicitudes de anuncios del vendedor a nuestros puntos de conexión. | 30 días |
Informe de análisis de vendedores prémium del servidor anteriorprebid_server_analytics |
Red | El informe de Prebid Server Premium Seller Analytics contiene información de rendimiento sobre los asociados de demanda Prebid Server Premium (PSP) configurados. Use para la entrega final y el rendimiento. | 30 días |
Informe de Análisis de estado premium del servidor de prebidpsp_health_analytics |
Red | Datos relacionados con las solicitudes y transacciones de pujas De Prebid Server Premium . Útil para la solución de problemas y la optimización. El informe se basa en datos de ejemplo multiplicados para calcular el volumen completo de la actividad de PSP. Use Prebid Server Premium Analytics Report y otros informes monetizar de Microsoft para esos fines. | 99 días |
Informe de disponibilidad de inventarioplatform_inventory_availability |
Anunciante, publicador | Los informes de disponibilidad de inventario ofrecen información sobre los tipos de inventario disponibles en la plataforma. | 30 días |
API REST para ver metadatos
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/report?meta | Devuelve metadatos para todos los informes. |
GET |
https://api.appnexus.com/report?meta=REPORT_TYPE | Devuelve metadatos para un tipo de informe determinado. |
Campos JSON para ver metadatos
La meta matriz incluye los siguientes campos:
| Campo | Descripción |
|---|---|
time_granularity |
Granularidad de tiempo para la que el informe puede proporcionar datos. Posibles valores: - "hourly" - "daily" - "monthly" - "yearly" - "lifetime"Si "hourly" o "lifetime", los datos están disponibles para el año, el mes, el día y la hora. Si "daily", "monthly"o "yearly", los datos solo están disponibles para el año, el mes y el día. |
columns |
Columnas que se pueden solicitar. Para cada columna, el nombre y el tipo aparecen en la respuesta JSON. |
filters |
Columnas que se pueden usar como filtros. Para cada columna, el nombre y el tipo aparecen en la respuesta JSON. |
time_intervals |
Intervalos de tiempo para los que se puede ejecutar el informe. |
Nota:
Algunos tipos de informe le permitirán ejecutar un informe para un período de tiempo personalizado. Para ello, establezca los campos y end_date en la start_date solicitud de informe.
Ejemplo de respuesta de metadatos (mediante el network_analytics informe)
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?meta=network_analytics'
{
"response": {
"status": "OK",
"meta": {
"time_granularity": "hourly",
"columns": [
{
"column": "month",
"type": "date"
},
{
"column": "day",
"type": "date"
},
{
"column": "hour",
"type": "date"
},
{
"column": "buyer_member_id",
"type": "int"
},
{
"column": "seller_member_id",
"type": "int"
},
{
"column": "seller_member_name",
"type": "string"
},
{
"column": "seller_member",
"type": "string"
},
{
"column": "advertiser_id",
"type": "int"
},
...
],
"filters": [
{
"column": "hour",
"type": "date"
},
{
"column": "day",
"type": "date"
},
{
"column": "month",
"type": "date"
},
{
"column": "buyer_member_id",
"type": "int"
},
{
"column": "seller_member_id",
"type": "int"
},
...
],
"havings": [
{
"column": "imps"
},
{
"column": "clicks"
},
{
"column": "cost"
},
{
"column": "revenue"
},
{
"column": "booked_revenue"
},
{
"column": "reseller_revenue"
},
{
"column": "profit"
},
...
],
"time_intervals": [
"current_hour",
"last_hour",
"last_48_hours",
"today",
"yesterday",
"last_7_days",
"month_to_date",
"quarter_to_date",
"last_month",
"lifetime",
"mtd"
]
}
}
}
API REST para la recuperación de datos
| Http (método) | Endpoint | Description |
|---|---|---|
POST |
https://api.appnexus.com/report (JSON de informe) |
Solicitar un informe. |
GET |
https://api.appnexus.com/report?id=REPORT_ID | Solicitar el estado de un informe. |
GET |
https://api.appnexus.com/report-download?id=REPORT_ID | Recuperar datos de informe. |
Nota:
Los usuarios de red pueden ejecutar informes de nivel de anunciante y publicador anexando advertiser_id=ADVERTISER_ID o publisher_id=PUBLISHER_ID a la cadena de consulta.
Campos JSON para la recuperación de datos
| Campo | Obligatorio en POST |
Tipo | Descripción |
|---|---|---|---|
report_type |
sí | enumeración | Esto determina qué información se devolverá. Posibles valores: - "network_analytics"- "network_billing"- "buyer_invoice_report"- "seller_invoice_report"- "network_advertiser_analytics"- "network_publisher_analytics"- "network_site_domain_performance"- "advertiser_analytics"- "video_analytics_network"- "video_analytics_network_advertiser"- "video_analytics_network_publisher"- "buyer_segment_performance"- "seller_brand_review"- "publisher_brand_review"- "publisher_analytics"- "network_creative_search"- "publisher_creative_search"- "network_advertiser_frequency_recency"- "advertiser_frequency_recency"- "site_domain_performance"- "seller_site_domain"- "inventory_domain_analytics"- "inventory_source_analytics"- "inventory_daily_uniques"- "segment_load"- "attributed_conversions"- "pixel_fired"- "network_analytics_feed"- "clicktrackers"- "key_value_analytics"- "prebid_server_analytics"- "psp_health_analytics" |
timezone |
No | string (50) | Esto determina en qué zona horaria se notificarán los datos. Para obtener una lista de los posibles valores de zona horaria, consulte Zonas horarias de API. Nota: Para los network_billingtipos de informe , network_analyticsnetwork_advertiser_analytics, , network_publisher_analytics, advertiser_analyticsy publisher_analytics , los datos anteriores a 100 días se notificarán en UTC. Además, los tipos de informe que no ofrecen datos por hora, como network_site_domain_performance, site_domain_performancey seller_site_domain se notificarán en UTC. |
filters |
No | matriz | Lista de objetos de filtro que se van a aplicar al informe. Consulte el paso 1 de la sección Cómo ejecutar un informe a continuación. |
group_filters |
No | matriz de objetos | Permite especificar una operación que se va a realizar en uno o varios filtros. Por ejemplo, si selecciona el total de impresiones agrupadas por campaña, puede usar este campo para filtrar las campañas que no tengan al menos 10 000 impresiones. |
columns |
sí | matriz de cadenas | Lista de columnas que se van a incluir en el informe. Consulte Creación de una solicitud de informe con formato JSON a continuación. Se debe especificar al menos una columna. |
row_per O groups |
No | matriz |
Nota:En desuso. De forma predeterminada, los resultados de los informes se agrupan automáticamente por las dimensiones de columns. Pasar estos campos no tiene ningún efecto.Para la mayoría de los informes, las dimensiones seleccionadas se agrupan automáticamente. Por ejemplo, si incluye las columnas "advertiser_id", , "campaign_id""creative_id"y "imps", cada fila de datos de informe mostraría las impresiones por anunciante, campaña y combinación creativa. |
start_date |
No | string | Fecha de inicio del informe. - Para los tipos de informe que ofrecen datos por hora, debe tener el formato "YYYY-MM-DD HH:MM:SS".Nota: MM:SS debe ser 00:00, ya que los datos no están disponibles durante minutos y segundos.- Para los tipos de informe que no ofrecen datos por hora, debe tener el formato "YYYY-MM-DD". |
end_date |
No | string | Fecha de finalización del informe. Nota: end_date no es inclusivo. Por ejemplo, si inicia un informe en "2017-07-01 00:00:00" y finaliza el informe en "2017-07-01 23:00:00", el informe no incluirá datos de la última hora del día. La manera correcta de recuperar estos datos sería finalizar el informe en "2017-07-02 00:00:00".- Para los tipos de informe que ofrecen datos por hora, debe tener el formato "YYYY-MM-DD HH:MM:SS". Sin embargo, MM:SS debe ser 00:00, ya que los datos no están disponibles durante minutos y segundos. Por ejemplo, "2017-07-01 00:00:00" para "2017-07-02 00:00:00" recuperar los datos de un día completo.- Para los informes agregados a intervalos más largos que por hora (por ejemplo, diarios, semanales, etc.), el formato debe ser "YYYY-MM-DD". Por ejemplo, "2017-07-01" para "2017-07-02" recuperar los datos de un día completo. |
report_interval |
No | enumeración | Intervalo de tiempo para el informe. No todos los informes aceptan todos los intervalos. Consulte la documentación y los metadatos de cada informe para obtener más información. Posibles valores: - current_hour- last_hour- today- yesterday- last_48_hours- last_2_days- last_7_days- last_14_days- month_to_yesterday- month_to_date- quarter_to_date- last_month- lifetime- 30_days |
orders |
No | matriz de objetos | Lista de columnas por las que se va a ordenar. Consulte Cómo ejecutar un informe a continuación. |
format |
No | enumeración | Formato en el que se devolverán los datos del informe. Si no se especifica este campo, tendrá como valor predeterminado "csv".Posibles valores: - "csv": valores separados por comas- "excel": valores separados por tabulaciones- "html" |
reporting_decimal_type |
No | enumeración | Marca decimal usada en el informe. Posibles valores: - "comma"- "decimal" (punto)Si se pasa este campo, invalida las preferencias decimales de informes establecidas en los niveles de usuario y miembro. |
emails |
No | matriz | Lista de direcciones de correo electrónico a las que se enviarán los datos de informes. Los datos de informes se envían como datos adjuntos y el cuerpo del correo electrónico contiene la información siguiente. - Tipo de informe - Nombre e identificador de miembro, anunciante o publicador - Fecha de ejecución -Fecha de inicio -Fecha final - Zona horaria - Usuario que generó el informe. Nota: Los resultados del informe de más de 15 MB no se enviarán por correo electrónico. Para ver formas de evitar que los resultados sean demasiado grandes, consulte Procedimientos recomendados de informes. |
escape_fields |
no | booleano | Cuando truees , agrega comillas alrededor de cada campo de la salida del informe para permitir una importación más segura en Excel. Esto solo se aplica a los informes delimitados por tabulaciones y CSV. |
group_filters ejemplo
{
"group_filters": [
{
"imps": {
"value": 10000,
"operator": ">="
}
}
]
}
¿Cómo ejecutar un informe?
- Paso 1. Creación de una solicitud de informe con formato JSON
- Paso 2.
POSTla solicitud al servicio de informes - Paso 3.
GETestado del informe del servicio de informes - Paso 4.
GETlos datos del informe del servicio de descarga de informes
Paso 1: Creación de una solicitud de informe con formato JSON
El archivo JSON debe incluir el específico report_type que desea ejecutar, así como las columns (dimensiones y métricas) y report_interval ("today", "yesterday", "month_to_date", etc.) que desea recuperar. También puede incluir filters para las dimensiones, definir la granularidad (year, month, day) y especificar el elemento en el format que se deben devolver los datos. Las format opciones son:
-
"csv"- Archivo separado por comas -
"excel"- Archivo separado por tabulaciones -
"xlsx"- Formato de Excel compatible con XML moderno (comprimido)
Nota:
Para filtrar una dimensión por más de un valor, use una matriz. Por ejemplo:
Correcto:
"filters": [{"bid_type": ["learn","optimized"]},
{"geo_country":"US"}]
Incorrecto:
"filters": [{"bid_type":"learn"},
{"bid_type":"optimized"},`` {"geo_country":"US"}]
Para obtener más información sobre los campos que se pueden incluir en la solicitud, consulte los campos JSON anteriores. Para obtener una lista completa de las dimensiones y métricas disponibles, consulte la documentación del tipo de informe específico que desea ejecutar o extraiga los metadatos del informe, como se describe en API REST para ver metadatos.
$ cat report_request
{
"report": {
"report_type": "network_analytics",
"report_interval": "last_48_hours",
"columns": ["day","imps","clicks"],
"filters": [{"geo_country":"US"}],
"orders": [{"order_by":"day", "direction":"ASC"},{"order_by":"imps", "direction":"DESC"}],
"format": "csv"
}
}
Paso 2: POST la solicitud al servicio de informes
La POST solicitud JSON y obtener un identificador de informe.
$ curl -b cookies -c cookies -X POST -d @report_request 'https://api.appnexus.com/report'
{
"response": {
"status": "OK",
"report_id": "ca9955709eade9a0e89f5cda5345c12r"
}
}
Como alternativa, puede obtener un identificador de informe a través de una POST solicitud mediante un identificador de informe guardado. Para obtener más información, vea El servicio de informes guardados:
curl -c cookies -b cookies -X POST 'https://api.appnexus.com/report?saved_report_id=30'
Paso 3: 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 llamada hasta que execution_status sea "ready". A continuación, use el report-download servicio para guardar los datos de informes en un archivo. (Esto se describe en el paso siguiente).
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=ca9955709eade9a0e89f5cda5345c12r'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2017-03-13 18:15:48",
"cache_hit": false,
"fact_cache_hit": false,
"json_request": "{\"report\":{\"report_type\":\"network_analytics\",\"report_interval\":
\"last_48_hours\",\"columns\":[\"day\",\"imps\",\"clicks\"],\"filters\":[{\"geo_country\":
\"US\"},{\"entity_member_id\":\"514\"},{\"entity_member_id\":null}],\"orders\":
[{\"order_by\":\"day\",\"direction\":\"ASC\"},{\"order_by\":\"imps\",\"direction\":
\"DESC\"}]}}",
"header_info": "Report type:,network_analytics\r\n,\r\nRun at:,2017-03-13 18:15:48\r\nStart date:,
\r\nEnd date:,\r\nTimezone:,\r\nUser:,John Smith (9385)\r\n",
"report_size": "10",
"row_count": "35",
"url": "report-download?id=ca9955709eade9a0e89f5cda5345c12r"
},
"execution_status": "ready"
}
}
Paso 4: 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 report-download servicio. Puede encontrar el servicio y el identificador de informe en el campo url 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 solicitud para exponer el encabezado de respuesta.
curl -i -b cookies -c cookies 'https://api.appnexus.com/report-download?id=ca9955709eade9a0e89f5cda5345c12r' > /tmp/network_analytics.csv
A continuación, puede abrir el archivo csv con Microsoft Excel o un software similar.
Limitaciones del tamaño de los datos de informe
Los resultados del informe de más de 15 MB no se enviarán por correo electrónico a los destinatarios especificados en la solicitud JSON.
Los informes que tardan más de 15 minutos en procesarse agotarán el tiempo de espera y devolverán con un estado de error. Esta cantidad de tiempo de procesamiento corresponde aproximadamente a filas de datos de 1MM. Si los informes agotan el tiempo de espera de forma rutinaria, considere una de las siguientes opciones:
- Compruebe que realmente necesita todos esos datos. Si no lo hace, actualice las solicitudes de informe con un intervalo de tiempo más corto o menos dimensiones. Para obtener sugerencias sobre cómo evitar que los informes sean innecesariamente grandes o tarden demasiado tiempo en procesarse, consulte Procedimientos recomendados para informes a continuación.
- Si realmente necesita todos esos datos, siga las instrucciones de Paginación de informes.
Limitación de informes
Con el fin de garantizar que nuestros sistemas funcionen de la forma más fluida posible para todos los usuarios, el servicio de informes limita las solicitudes de informe tanto en el nivel de miembro como en el nivel de usuario. En esta página se describe cómo se determinan los límites y cómo se controlan las solicitudes que superan los límites definidos para cada miembro y cada usuario.
Límites de usuario
Cuando el usuario A envía un informe, se realiza una comprobación para ver si el usuario A ha enviado 5 solicitudes de informe en los últimos 15 minutos que están en estado pendiente o que se están procesando actualmente. Si es así, se indica un error.
Límites de miembros
Un miembro determinado se limita a n solicitudes de informe que se procesan al mismo tiempo, donde n viene determinada por el contrato del miembro (esto se especifica internamente por el max_concurrent_reports_processing campo de la tabla api.member). Las solicitudes de informe enviadas una vez alcanzado el límite se colocan en una cola. No se proporcionan advertencias ni alertas.
Ejemplo
La limitación de nivel de usuario y miembro interactúan entre sí, como se muestra en el ejemplo siguiente. Supongamos que el usuario A y el usuario B están asociados al mismo miembro; este miembro tiene un límite de 5 solicitudes de informe simultáneas. En este ejemplo se supone que las siguientes solicitudes de informe se envían en un intervalo de tiempo de 15 minutos:
| Solicitud de informe | Usuario | Resultado |
|---|---|---|
| 1 | Usuario A | Procesamiento |
| 2 | Usuario A | Procesamiento |
| 3 | Usuario B | Procesamiento |
| 4 | Usuario B | Procesamiento |
| 5 | Usuario B | Procesamiento |
| 6 | Usuario A | Puesta en cola |
| 7 | Usuario A | Puesta en cola |
| 8 | Usuario A | Puesta en cola |
| 9 | Usuario A | Error |
La solicitud de informe n.º 6 se coloca en la cola, ya que ya hay 5 solicitudes de informe que se están procesando para este miembro. Por el mismo motivo, las solicitudes 6-8 también se colocan en la cola. Por último, podemos ver que la solicitud n.º 9 hace que se señale un error, ya que el usuario A ha enviado su 6ª solicitud de informe en un intervalo de tiempo de 15 minutos.
Datos de conversión
Las conversiones (y los datos relacionados) de los informes se procesan de forma asincrónica. Como resultado, los informes están disponibles más rápidamente, mientras que algunos datos relacionados con la conversión se siguen procesando en segundo plano. Para obtener más información, vea "Atribución de conversión asincrónica" en la página Disponibilidad de datos de informes .
Procedimientos recomendados de informes
Estas son algunas sugerencias para evitar que los informes sean innecesariamente grandes o que tardan mucho tiempo en procesarse:
- Acorte (
report_intervalpor ejemplo, de"lifetime"a"last_48_hours"). - Agregue más filtros de nivel superior (por ejemplo, para un publicador, anunciante, campaña, etc.).
- Evite combinar dimensiones granulares de compra y de venta (por ejemplo, creativas y de ubicación), ya que esto aumenta exponencialmente el número de filas. Si necesita informar sobre estas combinaciones, considere la posibilidad de usar fuentes de informes masivas o las fuentes de datos de nivel de registro (LLD).
Si debe extraer informes grandes que tardan mucho tiempo en procesarse, siga las instrucciones de Paginación de informes.
Para determinar cuándo se actualizó por última vez un informe, use el servicio de estado de informe.