Service de modèle de groupe d’utilisateurs

Le service de modèle de groupe d’utilisateurs vous permet de diviser une audience hypothétique en cinq compartiments discrets maximum, chaque compartiment défini pour couvrir un pourcentage du nombre total d’utilisateurs. Le cas d’usage le plus courant consiste à définir des groupes d’utilisateurs pour les tests A/B des stratégies de ciblage de campagne. Pour plus d’informations, consultez Ciblage de test et de contrôle dans la documentation.

Remarque

Il est important de noter qu’un modèle n’effectue aucun ciblage réel ; il vous aide simplement à calculer les valeurs de ciblage de groupe d’utilisateurs que vous pouvez appliquer manuellement à vos profils de campagne.

Voici le processus général :

Vous créez un fichier JSON qui définit votre modèle.
Vous effectuez la POST demande indiquée ci-dessous.
La réponse inclut des usergroup_target valeurs pour votre modèle. Vous mettez à jour les profils appropriés avec ces valeurs. Pour plus d’informations, consultez user_group_targets service de profil.

API REST

HTTP, méthode	Endpoint	Description
`GET`	https://api.appnexus.com/usergroup-pattern?id=USER_GROUP_PATTERN_ID	Afficher un modèle de groupe d’utilisateurs spécifique.
`GET`	https://api.appnexus.com/usergroup-pattern	Affichez tous vos modèles de groupe d’utilisateurs.
`POST`	https://api.appnexus.com/usergroup-pattern	Ajoutez un nouveau modèle de groupe d’utilisateurs.

Champs JSON

Champ	Type (Longueur)	Description
`cookieless`	valeur booléenne	Si `true`la valeur est , le premier groupe d’utilisateurs du `groups` tableau est défini pour inclure les utilisateurs sans cookie. Par défaut, cette valeur est définie sur `false` , car vous ne pouvez pas suivre les clics ou les conversions pour les utilisateurs sans cookie et, par conséquent, vous ne pouvez pas tester les performances sur ces derniers. Obligatoire sur :`POST` Par défaut:`false`
`groups`	tableau d’objets	Groupes d’utilisateurs dans le modèle. Il n’est pas possible d’inclure plus de cinq groupes. Pour plus d’informations, consultez Groupes ci-dessous. Obligatoire sur :`POST`
`id`	int	ID du modèle de groupe d’utilisateurs.
`last_modified`	Timestamp	Date à laquelle le modèle de groupe d’utilisateurs a été modifié pour la dernière fois.
`member_id`	dans	Membre auquel appartient le modèle de groupe d’utilisateurs. Obligatoire sur :`POST`
`name`	string (255)	Nom du modèle de groupe d’utilisateurs. Obligatoire sur :`POST`

Groupes

Champ	Type (Longueur)	Description
`id`	int	ID du groupe d’utilisateurs.
`name`	string	Nom du groupe d’utilisateurs. Obligatoire sur :`POST`
`percent`	int	Pourcentage d’utilisateurs ciblés par ce groupe. Le total de tous les groupes d’utilisateurs doit atteindre 100 %. Obligatoire sur :`POST`
`usergroup_target`	objet	Cet objet est retourné sur `POST` et `GET` et spécifie les informations que vous utiliseriez dans le `user_group_targets` tableau d’un profil. Pour la mise en forme, consultez l’exemple ci-dessous.

Exemples

Ajouter un nouveau modèle de groupe d’utilisateurs

$ 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"
        }
    }
}

Afficher le modèle de groupe d’utilisateurs 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"
        }
    }
}

Last updated on 2025-04-01

Partager via