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.
Xandr limite le nombre d’éléments de ligne, de campagnes, de créations, d’éditeurs, de sites, de placements, de packages, d’affaires, de réseaux médiés et d’offres médiatées que vous pouvez avoir sur la plateforme. En outre, Xandr limite le nombre de domaines pouvant être utilisés dans une liste de domaines unique, le nombre de cibles qui peuvent être utilisées dans un seul profil et le nombre de catégories de contenu qui peuvent être affectées à un seul placement. Pour tous les types d’objets à l’exception des objets créatifs, les objets actifs et inactifs sont comptabilisés par rapport à la limite. Pour les créations, seuls les objets non expirés sont comptabilisés par rapport à la limite.
Le service de limite d’objets vous permet d’afficher ces limites et de surveiller de manière proactive votre utilisation actuelle.
API REST
| HTTP, méthode | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/object-limit |
Affichez vos limites et votre utilisation actuelle pour tous les types d’objets. |
GET |
https://api.appnexus.com/object-limit?object_type=OBJECT_TYPE |
Affichez votre limite et votre utilisation actuelle pour un type d’objet spécifique. Remarque : Les types d’objets suivants sont disponibles : - campaign - profile - domain_list - creative - publisher - site - placement - package - deal - mediated_network - mediated_bid. Notez que pour récupérer votre limite d’éléments de ligne, vous devez utiliser campaign_group. |
Champs JSON
| Champ | Type | Description |
|---|---|---|
count_active |
int | Nombre actuel d’objets actifs. Pour les créations, ce nombre n’inclut pas les objets expirés. |
count_inactive |
int | Nombre actuel d’objets inactifs, sans compter les objets supprimés. Pour les créations, ce nombre n’inclut pas les objets expirés. |
count_total |
int | Nombre total actuel d’objets actifs et inactifs. Pour les créations, ce nombre n’inclut pas les objets expirés. |
limit |
int | Nombre maximal d’objets autorisés par le membre. Pour tous les types d’objets à l’exception "creative"de , les objets actifs et inactifs sont comptabilisés de nouveau la limite. Pour les créations, seuls les objets non expirés sont comptabilisés par rapport à la limite. |
mapping_limits |
objet | Ce champ est rempli uniquement pour les types d’objets "profile", "domain_list"et "placement" . Il répertorie les limites des objets au sein de chaque profil et liste de domaines, par exemple le nombre maximal de cibles de segment que vous pouvez utiliser dans un seul profil ou le nombre maximal de domaines que vous pouvez utiliser dans une seule liste de domaines. Pour les placements, il répertorie le nombre maximal de catégories de contenu qui peuvent être appliquées à un placement Voir Limites de mappage ci-dessous pour plus d’informations. |
object_type |
enum | Type d’objet. Valeurs possibles : - "line_item" - "campaign" - "profile" - "domain_list" - "creative" - "publisher" - "site" - "placement" - "package" - "deal" - "mediated_network" - "mediated bid".Remarque : Pour "profile" et "domain_list", les limitchamps , count_active, count_inactive, count_total affichent une valeur de null, car Xandr ne limite pas le nombre de profils et de listes de domaines que vous pouvez avoir. Toutefois, Xandr limite le nombre d’objets au sein de chaque profil ou liste de domaines. Ces limites sont affichées dans le mapping_limits champ . |
Limites de mappage
Cette partie de la réponse JSON est remplie uniquement pour les types d’objets "profile", "domain_list"et "placement" .
Pour les profils
| Champ | Type | Description |
|---|---|---|
content_category_targets |
int | Nombre maximal de catégories de contenu personnalisées que vous pouvez cibler dans un seul profil. |
inventory_source_targets |
int | Déconseillé. |
placement_targets |
int | Nombre maximal de placements que vous pouvez cibler dans un seul profil. |
platform_content_category_targets |
int | Nombre maximal de catégories de contenu définies par la plateforme que vous pouvez cibler dans un seul profil. |
postal_code_targets |
int | Nombre maximal de codes postaux que vous pouvez cibler dans un seul profil. |
publisher_targets |
int | Nombre maximal d’éditeurs que vous pouvez cibler dans un seul profil. |
segment_targets |
int | Nombre maximal de segments que vous pouvez cibler dans un seul profil. |
segment_group_targets |
int | Nombre maximal de groupes de segments que vous pouvez cibler dans un seul profil. |
site_targets |
int | Nombre maximal de sites que vous pouvez cibler dans un seul profil. |
Pour les listes de domaines
| Champ | Type | Description |
|---|---|---|
domains |
int | Nombre maximal de domaines que vous pouvez inclure ou exclure dans une seule liste de domaines. |
Pour les placements
| Champ | Type | Description |
|---|---|---|
content_categories |
int | Nombre maximal de catégories de contenu que vous pouvez appliquer à un seul placement. |
Exemples
Afficher vos limites et votre utilisation actuelle pour tous les types d’objets
$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit'
{
"response": {
"status": "OK",
"count": 21,
"start_element": 0,
"num_elements": 100,
"object-limits": [
{
"object_type": "site",
"limit": 10000,
"mappings": [
],
"count_active": 8,
"count_inactive": 0,
"count_total": 8
},
{
"object_type": "publisher",
"limit": 3000,
"mappings": [
],
"count_active": 8,
"count_inactive": 0,
"count_total": 8
},
{
"object_type": "profile",
"limit": null,
"mappings": {
"site_targets": 100,
"publisher_targets": 300,
"inventory_source_targets": 500,
"content_category_targets": 300,
"placement_targets": 250,
"segment_targets": 400
},
"count_active": null,
"count_inactive": null,
"count_total": null
},
{
"object_type": "placement",
"limit": 20000,
"mappings": [
],
"count_active": 21,
"count_inactive": 0,
"count_total": 21
},
{
"object_type": "line_item",
"limit": 3000,
"mappings": [
],
"count_active": 4,
"count_inactive": 1,
"count_total": 5
},
{
"object_type": "domain_list",
"limit": null,
"mappings": {
"domain": 30000
},
"count_active": null,
"count_inactive": null,
"count_total": null
},
{
"object_type": "creative",
"limit": 10000,
"mappings": [
],
"count_active": 32,
"count_inactive": 0,
"count_total": 32
},
{
"object_type": "campaign",
"limit": 10000,
"mappings": [
],
"count_active": 6,
"count_inactive": 6,
"count_total": 12
}
]
}
}
Afficher vos limites et votre utilisation actuelle pour les créatifs
$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit?object_type=creative'
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"object-limits": [
{
"object_type": "creative",
"limit": 10000,
"mappings": [
],
"count_active": 32,
"count_inactive": 0,
"count_total": 32
}
]
}
}
Limites par défaut
Pour obtenir la liste des limites d’objets par défaut et les questions fréquemment posées, consultez Contraintes d’utilisation des API.
Suppression d’objets
Lorsque vous approchez ou atteignez votre limite pour les éléments de ligne, les campagnes, les éditeurs, les sites ou les placements, vous pouvez utiliser des rapports tels que Network Advertiser Analytics et Network Publisher Analytics pour identifier les objets qui, par exemple, n’ont pas été modifiés ou utilisés au cours des 30 derniers jours, puis supprimer ces objets manuellement. Pour les éléments de ligne et les campagnes, vous pouvez également utiliser un filtre de chaîne de requête pour rechercher des objets en fonction du moment où ils ont eu des impressions pour la première ou la dernière fois. Pour plus d’informations, consultez Service d’élément de ligne et Service de campagne .
Lorsque vous approchez ou atteignez votre limite de créations, vous devez supprimer les créations non expirées. Les éléments créatifs non expirés ont le is_expired champ défini sur false. Notez que la suppression des créations expirées n’aura pas d’impact sur votre nombre de créations.