Partager via

Service de valeur de ciblage

Le service targeting-value fonctionne conjointement avec le service targeting-key pour vous permettre de créer vos propres combinaisons clé/valeur à utiliser dans le ciblage sur des éléments de ligne, des campagnes, etc. Pour plus d’informations, consultez Ciblage de valeur de clé personnalisée .

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID Afficher toutes les valeurs de ciblage d’une clé spécifique.
GET https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID&id=TARGETING_VALUE_ID Afficher une valeur de ciblage spécifique.
POST https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID Ajoutez une nouvelle valeur de ciblage.
POST https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID Ajoutez plusieurs nouvelles valeurs de ciblage.
PUT https://api.appnexus.com/targeting-value?id=TARGETING_VALUE_ID Modifier une valeur de ciblage.
DELETE https://api.appnexus.com/targeting-value?id=TARGETING_VALUE_ID Supprimer une valeur de ciblage.

Champs JSON

Champ Type Description
created_on date En lecture seule. Date et heure de création de la valeur de ciblage.
id int ID de la valeur de ciblage.

Obligatoire sur : PUT et DELETE
Valeur par défaut : nombre généré automatiquement.
label string Étiquette pour la valeur, utilisée à des fins de création de rapports. Cette valeur n’est pas obligatoire, mais si vous fournissez une valeur, elle doit être unique dans une clé. Les étiquettes peuvent comporter un maximum de 190 caractères.
last_modified date En lecture seule. Date et heure de la dernière modification de la valeur de ciblage.
name string Nom de la valeur de ciblage. Ce nom doit être unique au sein d’une clé de ciblage donnée.
targeting_key_id int ID de la clé de ciblage associée. La clé de ciblage doit exister avant qu’une valeur puisse être créée. Consultez Ciblage du service de clé.

Obligatoire sur : POST et GET

Exigences en matière de valeur

Exigences en matière de valeur Détails
- Vous pouvez avoir jusqu’à 100 000 valeurs par clé.

Remarque :
La limite maximale du nombre de valeurs à inclure dans une charge utile est de 100.

- Vous pouvez avoir jusqu’à 2 500 000 valeurs actives au total à la fois.		 - Les noms de valeurs ne respectent pas la casse.
- La longueur maximale du nom de la valeur est de 100 caractères.
- Les noms de valeurs peuvent contenir des espaces blancs, de sorte qu’ils peuvent être plusieurs mots.
- Les noms de valeurs ne peuvent contenir aucun des caractères spéciaux suivants :
- " (guillemets doubles)
- ' (apostrophe)
- = (signe égal)
- ! (point d’exclamation)
- + (signe plus)
- # (hashtag)
- * (astérisque)
- ~ (tilde)
- ; (point-virgule)
- ^ (caret)
- () (parenthèses)
- <> (crochets)
- [] (crochets)
- , (virgule)
- & (esperluette)
- @ (at)
- : (deux-points)
- ? (point d’interrogation)
- % (pourcentage)
- / (barre oblique)

Exemples

Afficher toutes les valeurs de ciblage d’une clé donnée

$ curl -b cookies 'https://api.appnexus.com/targeting-values?targeting_key_id=12'
 
"targeting-values": [
    {
        "id": 1,
        "targeting_key_id": 12,
        "name": "value1",
        "label": null,
        "created_on": "2016-08-26 08:52:43",
        "last_modified": "2016-08-26 08:52:43"
    },
    {
        "id": 4,
        "targeting_key_id": 12,
        "name": "value2",
        "label": null,
        "created_on": "2016-08-26 09:24:33",
        "last_modified": "2016-08-26 09:24:33"
    }
],...

Afficher une valeur de ciblage spécifique

$ curl -b cookies 'https://api.appnexus.com/targeting-value?id=4'
  
"targeting-value": {
    "id": 4,
    "targeting_key_id": 12,
    "name": "value2",
    "label": null,
    "created_on": "2016-08-26 09:24:33",
    "last_modified": "2016-08-26 09:24:33"
},

Ajouter une valeur de ciblage (chaîne)

$ cat create_targeting_value.json
 
{
    "targeting-value": {
        "name": "value1"
    }
}
  
$ curl -b cookies -X POST -d @create_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'

Ajouter plusieurs valeurs de ciblage (chaîne)

$ cat create_multi_targeting_value.json
 
{
    "targeting-values": [
        {
            "name": "value1"
        },
        {
            "name": "value2"
        }
    ]
}
  
$ curl -b cookies -X POST -d @create_multi_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'

Ajouter une valeur de ciblage (numérique)

Le name champ nécessite une valeur de chaîne (entre guillemets). Toutefois, si la clé a été définie avec un type numérique, cette chaîne doit contenir des caractères numériques.

$ cat create_targeting_value.json
 
{
    "targeting-value": {
        "name": "22"
    }
}
  
$ curl -b cookies -X POST -d @create_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'

Modifier une valeur de ciblage

$ cat update_targeting_value.json
 
{
"targeting-value":
    {
        "name": "newvalue2"
         
    }
}
  
$ curl -b cookies -X PUT -d @update_targeting_value.json 'https://api.appnexus.com/targeting-value?id=4'

Trier par nom de valeur

Vous pouvez trier vos résultats par id, name, labelcreated_on, ou last_modified. Vous pouvez trier par ordre croissant (asc) ou décroissant (desc).

$ curl -b cookies 'https://api.appnexus.com/targeting-value?targeting_key_id=4&sort=name.asc'
  
"targeting-values": [
    {
        "id": 10,
        "targeting_key_id": 12,
        "name": "a test value",
        "label": null,
        "created_on": "2016-08-26 08:52:43",
        "last_modified": "2016-08-26 08:52:43"
    },
    {
        "id": 7,
        "targeting_key_id": 12,
        "name": "test value",
        "label": null,
        "created_on": "2016-08-26 09:24:33",
        "last_modified": "2016-08-26 09:24:33"
    }
],...

Supprimer une valeur de ciblage

$ curl -b cookies -X DELETE 'https://api.appnexus.com/targeting-value?id=4'
  • Last updated on