Soumissionnaires - Service de limite d’objets

Xandr limite le nombre de créations non expiré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 et le nombre de cibles qui peuvent être utilisées dans un seul profil. 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. Un élément créatif expire lorsqu’il n’a pas été ni servi ni modifié au cours des 14 derniers jours (le 15e jour, il est mis à jour comme expiré).

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.adnxs.com/object-limit	Affichez vos limites et votre utilisation actuelle pour tous les types d’objets.
`GET`	https://api.adnxs.com/object-limit?object_type=OBJECT_TYPE	Affichez votre limite et votre utilisation actuelle pour un type d’objet spécifique. Pointe: Les types d’objets suivants sont disponibles : `creative`, `profile`et `domain_list`.

Champs JSON

Champ	Type	Description
`count_active`	int	Nombre actuel d’objets actifs. Pour les créatifs, ce nombre n’inclut pas les créations expirées.
`count_inactive`	int	Nombre actuel d’objets inactifs, sans compter les objets supprimés. Pour les créatifs, ce nombre n’inclut pas les créations expirées.
`count_total`	int	Nombre total actuel d’objets actifs et inactifs. Pour les créatifs, ce nombre n’inclut pas les créations expirées.
`limit`	int	Nombre maximal d’objets autorisés par le soumissionnaire. 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"` et `"domain_list"` . 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 plus d’informations, consultez « Limites de mappage » ci-dessous.
`object_type`	enum	Type d’objet. Valeurs possibles : `"creative"`, `"profile"`ou `"domain_list"`. Note: Pour `"profile"` et `"domain_list"`, les `limit`champs , `count_active`, `count_inactive`et `count_total` affichent la valeur `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" et "domain_list" . Il répertorie les limites des objets au sein de chaque profil et liste de domaines.

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ée.
`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 Xandr 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_group_targets`	int	Nombre maximal de groupes de segments que vous pouvez cibler dans un seul profil.
`segment_targets`	int	Nombre maximal 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.

Exemples

Afficher vos limites et votre utilisation actuelle pour tous les types d’objets

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "profile",
                "limit": null,
                "mapping_limits": {
                    "inventory_source_targets": 500,
                    "content_category_targets": 300,
                    "platform_content_category_targets": 300,
                    "postal_code_targets": 4000,
                    "segment_targets": 400,
                    "publisher_targets": 300,
                    "site_targets": 100,
                    "placement_targets": 250,
                    "segment_group_targets": 400
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "domain_list",
                "limit": null,
                "mapping_limits": {
                    "domains": 30000
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
        ...
        }
    }
}

Afficher vos limites et votre utilisation actuelle pour les créatifs

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit?object_type=creative'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
            ...
        }
    }
}

FAQ

Pour obtenir la liste des questions fréquemment posées sur les limites d’objets, consultez Limites des objets - FAQ.

Suppression d’objets

Lorsque vous approchez de votre limite pour les listes de domaines ou la cible de profil, vous devez supprimer les objets inactifs, inutilisés ou inutiles.

Pour supprimer des domaines d’une liste de domaines, vous effectuez un PUT appel au service de liste de domaines, en mettant à jour le domains tableau.
Pour plus d’informations sur la suppression d’une cible d’un profil, consultez Profils de soumissionnaire améliorés.

Lorsque vous approchez de votre limite pour les 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.

Remarque

La suppression des éléments créatifs expirés n’aura pas d’impact sur votre nombre de créations.

Pour supprimer un élément créatif, vous effectuez un DELETE appel au service créatif.

Last updated on 2025-10-21

Partager via