API de plataforma digital: comprobación de estadísticas de uso
Advertencia
Aviso alfa-beta
Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
Llamada a la API REST
Al realizar una llamada a la API para recuperar estadísticas, se pueden establecer los siguientes campos en la cadena de consulta:
agg
se puede omitir para obtener un informe por hora o detallado.agg=true
se puede usar para obtener un informe agregado.start
date debe establecerse en el formato siguiente:2015-11-01+01:00:00
.end
date debe establecerse en el formato siguiente:2015-12-01+01:00:00
.
curl -H "Authorization: hbapi:123456:9876abcd54321:nym2"-XGET"https://streaming-data.appnexus.com/rt-segment-processed?member_id=100&start=2014-05-22+00:00:00&end=2014-05-22+01:00:00"
Las estadísticas se desduplican por solicitud realizada al servicio. Por ejemplo, si el mismo usuario se agrega al mismo segmento en tres solicitudes diferentes, num_valid_adds
y num_valid_users
mostraría "3"
. Cuando se usa agg=true
, habrá una entrada en la propiedad de informe de la respuesta. Será una agregación de todas las estadísticas de uso del intervalo de fechas especificado. error_log_lines
y segment_log_lines
estarán vacíos, y la hora procesada será para la última hora del intervalo de fechas especificado. Sin embargo, si no se especifica ningún intervalo de fechas, el informe mostrará los datos de las últimas dos semanas.
Ejemplo: Informe de uso agregado
{
"response": {
"report": {
"error_log_lines": null,
"match_rate": 87.7,
"member_id": 123,
"num_inactive_segments": 0,
"num_invalid_segments": 0,
"num_invalid_users": 25,
"num_other_errors": 0,
"num_unauth_segments": 0,
"num_valid_adds": 181,
"num_valid_removes": 2,
"num_valid_users": 179,
"processed_hour": "2015-11-08 01:00:00",
"segment_log_lines": null
},
"status": "OK"
}
}
Ejemplo: Informe por hora
{
"response": {
"report": [
{
"error_log_lines": "",
"match_rate": 100.0,
"member_id": 123,
"num_inactive_segments": 0,
"num_invalid_segments": 0,
"num_invalid_users": 0,
"num_other_errors": 0,
"num_unauth_segments": 0,
"num_valid_adds": 2,
"num_valid_removes": 0,
"num_valid_users": 1,
"processed_hour": "2015-11-03 18:00:00",
"segment_log_lines": "Valid users: 1580557697843484206
Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123)
Valid additions (user id, segment id, expiration): (1580557697843484206, 3737552, 1440), (1580557697843484206, 3737547, 1440)"
},
{
"error_log_lines": "Inactive users: 15805576978434842
Inactive segments (id, code, segment owner member id): (321456, 'segment_312456', 123)
Invalid segments (id, code, segment owner member id): (0, 'segment_654321', 123)
Unauthorized segments (id, code, segment owner member id): (0, 'segment_123456', 123)",
"match_rate": 50.0,
"member_id": 123,
"num_inactive_segments": 1,
"num_invalid_segments": 1,
"num_invalid_users": 1,
"num_other_errors": 0,
"num_unauth_segments": 1,
"num_valid_adds": 0,
"num_valid_removes": 2,
"num_valid_users": 1,
"processed_hour": "2015-11-03 19:00:00",
"segment_log_lines": "Valid users: 1580557697843484206
Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123)
Valid removals (user id, segment id, expiration): (1580557697843484206, 3737552, -1), (1580557697843484206, 3737547, -1)"
}
]
}
}
JSON del objeto de informe para objetos de la matriz de informes
Nombre del campo | Description | Valor de ejemplo |
---|---|---|
processed_hour |
Hora durante la que pasaron las cargas. | "2014-05-22 00:00:00" |
match_rate |
Porcentaje de usuarios válidos cargados (num_valid_users/(num_valid_users+num_invalid_users)). | 75.00 |
num_valid_users |
Número total de usuarios válidos que se transmitieron a través del servicio. No es el número de usuarios únicos de la hora. | 124578 |
num_valid_adds |
Número total de asociaciones que se agregaron (es decir, pares de segmentos de usuario, expiración !=-1). | 98765432 |
num_valid_removes |
Número total de asociaciones que se quitaron (es decir, pares de segmentos de usuario con expiración = -1). | 98765432 |
num_invalid_users |
Número total de usuarios que estaban en solicitudes, pero que no existen en la plataforma de Xandr. | 4000 |
num_unauth_segments |
Número total de asociaciones que no pudieron acceder a segmentos no autorizados. | 500 |
num_inactive_segments |
Número total de asociaciones que no pudieron acceder a los segmentos inactivos. | 200 |
num_invalid_segments |
Número total de asociaciones que no pudieron obtener acceso a segmentos no válidos. | 3 |
num_other_errors |
Número total de llamadas con errores por otros motivos. | 0 |
error_log_lines |
Un ejemplo de línea de actualización 200 de los errores que impedían que las asociaciones de usuarios y segmentos se realizara correctamente. | "Inactive users: 15805576978434842 Inactive segments (id, code, segment owner member id): (321456, 'segment_312456', 123) Invalid segments (id, code, segment owner member id): (0, 'segment_654321', 123) Unauthorized segments (id, code, segment owner member id): (0, 'segment_123456', 123)" |
segment_log_lines |
Una muestra de línea de actualización de 200 de los segmentos y el número de asociaciones válidas para cada una. | "Valid users: 1580557697843484206 Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123) Valid additions (user id, segment id, expiration): (1580557697843484206, 3737552, 1440), (1580557697843484206, 3737547, 1440) Valid removals (user id, segment id, expiration): (1580557697843484206, 3737552, -1), (1580557697843484206, 3737547, -1)" |