Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce service en lecture seule vous permet d’afficher les étiquettes qui peuvent être appliquées à vos annonceurs, ordres d’insertion, éléments de ligne, campagnes et éditeurs. Il vous permet également d’afficher les étiquettes qui ont déjà été appliquées.
Un exemple d’étiquette d’annonceur est "Salesperson". Vous pouvez utiliser cette étiquette pour spécifier le nom du vendeur responsable de chacun de vos annonceurs. Vous pouvez ensuite exécuter le rapport Analyse réseau filtré par "salesperson_for_advertiser" pour vous concentrer sur les annonceurs dont un vendeur particulier est responsable, ou regroupés par "salesperson_for_advertiser" pour classer les performances de vos vendeurs.
Les rapports suivants prennent actuellement en charge les étiquettes : Network Analytics, Network Advertiser Analytics et Advertiser Analytics. Pour obtenir la liste complète des colonnes de rapport associées aux étiquettes, voir "report_field" ci-dessous.
API REST
| HTTP, méthode | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/label | Afficher toutes les étiquettes disponibles. |
GET |
https://api.appnexus.com/label?id=LABEL_ID | Afficher une étiquette spécifique. |
GET |
https://api.appnexus.com/label?show_values=true&object_type=OBJECT_TYPE | Affichez les étiquettes appliquées à un type d’objet spécifique. Remarque : Les types d’objets suivants sont disponibles : advertiser, publisher, line_item, campaignet insertion_order. |
Champs JSON
| Champ | Type | Description |
|---|---|---|
id |
int | ID de l’étiquette. Valeurs possibles : 1, 2, 3, 4, 5, 7, 812119, . 161415 |
is_user_associated |
valeur booléenne | Ce champ est spécifique à. Si truela valeur est , l’étiquette est associée à une personne (par exemple "Salesperson" , ou "Account Manager") et autorise la saisie semi-automatique de la valeur d’étiquette par le prénom, le nom d’un utilisateur. |
is_reporting_enabled |
valeur booléenne | Si truela valeur est , l’étiquette peut être utilisée dans la création de rapports. |
last_modified |
Timestamp | Date et heure de la dernière modification de l’étiquette. |
member_id |
int | Étant donné que toutes les étiquettes sont actuellement disponibles pour tous les membres, ce champ sera NULLtoujours . À l’avenir, il peut être possible pour un membre de créer des étiquettes uniques, auquel cas ce champ renvoie l’ID du membre propriétaire. |
name |
string | Nom de l’étiquette. Valeurs possibles : "Salesperson", "Account Manager", "Trafficker", "Sales Rep""Test/Control", "Campaign Type", ou "Advertiser Type". Pour id/object_type/nameles mappages, consultez le premier exemple ci-dessous. |
object_type |
enum | Type d’objet auquel l’étiquette peut être appliquée. Valeurs possibles : "advertiser", "insertion_order", "line_item", "campaign"ou "publisher". Pour id/object_type/nameles mappages, consultez le premier exemple ci-dessous. |
report_field |
string | Colonne de rapport avec laquelle vous pouvez créer un rapport sur l’étiquette. Colonnes de rapport possibles (avec les rapports correspondants) : - salesperson_for_advertiser (Analyse réseau)- salesperson_for_publisher (Analyse réseau)- account_manager_for_advertiser (Analyse réseau)- account_manager_for_publisher (Analyse réseau)- trafficker_for_line_item (Analyse réseau, Analyse des annonceurs réseau)- salesrep_for_line_item (Analyse réseau, Analyse des annonceurs réseau)- user_group_for_campaign (Analyse réseau, Analyse des annonceurs réseau, Analyse des annonceurs)- advertiser_type (Analyse réseau, Analyse des annonceurs réseau)- line_item_type (Analyse réseau, Analyse des annonceurs réseau)- insertion_order_type (Analyse réseau, Analyse des annonceurs réseau) |
values |
tableau d’objets | Ce champ est retourné lors de l’utilisation de la requête GEThttps://api.appnexus.com/label?show_values=true& object_type=OBJECT_TYPE. Pour plus d’informations, consultez Valeurs et le deuxième exemple ci-dessous. |
Values
| Champ | Type | Description |
|---|---|---|
object_id |
int | ID de l’objet auquel l’étiquette est appliquée. Par exemple, si object_type est "advertiser", object_id est le ID de l’annonceur. |
value |
string | Valeur affectée à l’étiquette. Par exemple, pour l’étiquette de l’éditeur "Salesperson" , il s’agit d’un nom tel que "Michael Sellers". |
Exemples
Afficher toutes les étiquettes disponibles
$ curl -b cookies -c cookies 'https://api.appnexus.com/label'
{
"response": {
"status": "OK",
"labels": [
{
"id": 1,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "salesperson_for_advertiser",
"last_modified": "2010-09-14 22:12:38"
},
{
"id": 2,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "publisher",
"report_field": "salesperson_for_publisher",
"last_modified": "2010-09-14 22:12:43"
},
{
"id": 3,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "account_manager_for_advertiser",
"last_modified": "2010-09-14 22:12:47"
},
{
"id": 4,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "publisher",
"report_field": "account_manager_for_publisher",
"last_modified": "2010-09-14 22:12:51"
},
{
"id": 5,
"name": "Region",
"member_id": null,
"is_user_associated": false,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "region_for_advertiser",
"last_modified": "2011-01-21 19:39:37"
},
{
"id": 7,
"name": "Trafficker",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "line_item",
"report_field": "trafficker_for_line_item",
"last_modified": "2011-05-31 16:11:21"
},
{
"id": 8,
"name": "Sales Rep",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "line_item",
"report_field": "salesrep_for_line_item",
"last_modified": "2011-05-31 16:11:29"
},
{
"id": 9,
"name": "Test/Control",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "campaign",
"report_field": "user_group_for_campaign",
"last_modified": "2011-12-06 18:07:44"
},
...
],
"count": 10,
"start_element": 0,
"num_elements": 100
}
}
Afficher les étiquettes appliquées à vos annonceurs
$ curl -b cookies -c cookies 'https://api.appnexus.com/label?show_values=true&object_type=advertiser'
{
"response": {
"status": "OK",
"labels": [
{
"id": 1,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "salesperson_for_advertiser",
"values": [
{
"object_id": "7669",
"value": "Phillip Turner"
},
{
"object_id": "7670",
"value": "Ami Kraft"
},
{
"object_id": "7713",
"value": "Michelle Jacobs"
},
{
"object_id": "7719",
"value": "Michelle Jacobs"
},
{
"object_id": "7759",
"value": "Phillip Turner"
},
{
"object_id": "7760",
"value": "Phillip Turner"
},
{
"object_id": "7761",
"value": "Ami Kraft"
}
],
"last_modified": "2011-12-18 20:13:32"
},
{
"id": 3,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "account_manager_for_advertiser",
"values": [
{
"object_id": "7669",
"value": "Tina Rivera"
},
{
"object_id": "7670",
"value": "Richard Seiken"
},
{
"object_id": "7713",
"value": "Richard Seiken"
},
{
"object_id": "7719",
"value": "Norman Fischer"
},
{
"object_id": "7759",
"value": "Norman Fischer"
},
{
"object_id": "7760",
"value": "Tina Revera"
},
{
"object_id": "7761",
"value": "Norman Fisher"
}
],
"last_modified": "2010-09-28 20:13:32"
}
],
"count": 2,
"start_element": null,
"num_elements": null
}
}