Servicio de patrón de grupo de usuarios
El servicio de patrón de grupo de usuarios permite dividir una audiencia hipotética en hasta cinco cubos discretos, cada uno definido para cubrir un porcentaje del total de usuarios. El caso de uso más común para hacerlo es definir grupos de usuarios para las pruebas A/B de estrategias de segmentación de campañas. Para obtener más información, consulte Test and Control Targeting en la documentación.
Nota:
Es importante tener en cuenta que un patrón no realiza ningún destino real; simplemente le ayuda a calcular los valores de destino de grupos de usuarios que puede aplicar manualmente a los perfiles de campaña.
Este es el proceso general:
- Cree un archivo JSON que defina el patrón.
- Realice la
POSTsolicitud que se muestra a continuación. - La respuesta incluye
usergroup_targetvalores para el patrón. Los perfiles pertinentes se actualizan con estos valores. Para obtener más información, consulteuser_group_targetsen el Servicio de perfiles.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/usergroup-pattern?id=USER_GROUP_PATTERN_ID | Ver un patrón de grupo de usuarios específico. |
GET |
https://api.appnexus.com/usergroup-pattern | Vea todos los patrones de grupo de usuarios. |
POST |
https://api.appnexus.com/usergroup-pattern | Agregue un nuevo patrón de grupo de usuarios. |
Campos JSON
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
cookieless |
booleano | Si truees , el primer grupo de usuarios de la groups matriz se establecerá para incluir usuarios sin cookies. De forma predeterminada, se establece false en porque no se puede realizar un seguimiento de los clics o conversiones de los usuarios sin cookies y, por lo tanto, no se puede probar el rendimiento en ellos.Obligatorio activado: POST Predeterminado: false |
groups |
matriz de objetos | Los grupos de usuarios del patrón. No se pueden incluir más de cinco grupos. Para obtener más información, vea Grupos a continuación. Obligatorio activado: POST |
id |
Entero | Identificador del patrón de grupo de usuarios. |
last_modified |
Timestamp | Fecha en la que se modificó por última vez el patrón de grupo de usuarios. |
member_id |
en | Miembro al que pertenece el patrón de grupo de usuarios. Obligatorio activado: POST |
name |
string (255) | Nombre del patrón de grupo de usuarios. Obligatorio activado: POST |
Grupos
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
id |
Entero | Identificador del grupo de usuarios. |
name |
string | Nombre del grupo de usuarios. Obligatorio activado: POST |
percent |
Entero | Porcentaje de usuarios a los que se dirigirá este grupo. El total de todos los grupos de usuarios debe sumar hasta el 100 %. Obligatorio activado: POST |
usergroup_target |
objeto | Este objeto se devuelve en POST y GET especifica la información que usaría en la user_group_targets matriz de un perfil. Para obtener formato, consulte el ejemplo siguiente. |
Ejemplos
Adición de un nuevo patrón de grupo de usuarios
$ cat pattern
{
"usergroup-pattern": {
"name": "Test pattern",
"member_id": 1066,
"cookieless": false,
"groups": [
{
"name": "Group 1",
"percent": 25
},
{
"name": "Group 2",
"percent": 25
},
{
"name": "Group 3",
"percent": 25
},
{
"name": "Group 4",
"percent": 25
}
]
}
}
$ curl -b cookies -c cookies -X POST -d @pattern 'https://api.appnexus.com/usergroup-pattern'
{
"response": {
"status": "OK",
"count": 1,
"id": 43,
"start_element": 0,
"num_elements": 100,
"usergroup-pattern": {
"id": 43,
"member_id": 1066,
"name": "Test pattern",
"cookieless": false,
"groups": [
{
"id": 1,
"name": "Group 1",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 0,
"high": 24
}
]
}
},
{
"id": 2,
"name": "Group 2",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 25,
"high": 49
}
]
}
},
{
"id": 3,
"name": "Group 3",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 50,
"high": 74
}
]
}
},
{
"id": 4,
"name": "Group 4",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 75,
"high": 99
}
]
}
}
],
"last_modified": "2011-12-13 20:18:02"
}
}
}
Ver el patrón de grupo de usuarios 43
$ curl -b cookies -c cookies 'https://api.appnexus.com/usergroup-pattern?id=40'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"usergroup-pattern": {
"id": 43,
"member_id": 1066,
"name": "Test pattern",
"cookieless": false,
"groups": [
{
"id": 1,
"name": "Group 1",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 0,
"high": 24
}
]
}
},
{
"id": 2,
"name": "Group 2",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 25,
"high": 49
}
]
}
},
{
"id": 3,
"name": "Group 3",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 50,
"high": 74
}
]
}
},
{
"id": 4,
"name": "Group 4",
"percent": 25,
"usergroup_target": {
"include_cookieless_users": false,
"groups": [
{
"low": 75,
"high": 99
}
]
}
}
],
"last_modified": "2011-12-13 20:18:02"
}
}
}