Limites de taux

L’Ads API est soumise à des limites de taux similaires à celles de la REST API v1.1, comme décrit ici : REST API Rate Limiting in v1.1. Contrairement à la REST API v1.1, il n’existe pas d’index programmatique des limites par endpoint. Les limites de taux par endpoint et les fenêtres de réinitialisation sont communiquées via les en-têtes de réponse HTTP. Toutes les limites de taux de la X Ads API utilisent OAuth 1.0a.

​

Limites au niveau de l’utilisateur et au niveau du compte publicitaire

Il existe deux types de limites de taux : au niveau du jeton utilisateur et au niveau du compte publicitaire. Un sous-ensemble d’endpoints est configuré pour appliquer la limitation de taux au niveau du compte publicitaire. Un jeton utilisateur est l’OAuth access token que vous utilisez pour vous authentifier et appeler la X Ads API. Chaque jeton utilisateur peut avoir accès à un ou plusieurs comptes publicitaires.

Les développeurs doivent utiliser la limite de taux au niveau du compte publicitaire lorsqu’elle est renvoyée dans les en-têtes de réponse et n’utiliser la limite au niveau de l’utilisateur que lorsque la limite du compte publicitaire n’est pas disponible.

Les limites de taux au niveau de l’utilisateur sont indiquées via ces en-têtes : x-rate-limit-limit, x-rate-limit-remaining et x-rate-limit-reset.

Pour les endpoints avec limitation de taux au niveau du compte publicitaire, les limites de taux sont indiquées via ces en-têtes : x-account-rate-limit-limit, x-account-rate-limit-remaining et x-account-rate-limit-reset.

Les limites de taux au niveau du compte publicitaire sont fournies uniquement pour les endpoints GET afin de permettre aux applications de synchroniser les données d’entités (telles que les objets de campagne ou d’élément de ligne) à partir d’un seul jeton utilisateur accédant à plusieurs comptes publicitaires. Les actions d’écriture ne sont pas garanties d’utiliser les mêmes limites de taux au niveau du compte publicitaire.

Pour les endpoints limités au niveau du compte publicitaire, la limite de taux au niveau de l’utilisateur est fixée à une valeur élevée représentant un quota global pour l’ensemble de votre application. Lorsque cela est possible, la limite de taux au niveau du compte publicitaire doit prévaloir pour contrôler votre volume de requêtes.

​

Bonnes pratiques

1. Enregistrez dans votre base de données un horodatage correspondant à la dernière synchronisation. Lors de la récupération des données, lorsque c’est possible, utilisez l’option sort_by=updated_at-desc afin de pouvoir arrêter votre processus de synchronisation dès que vous atteignez des données antérieures à votre dernier horodatage synchronisé. Cela évitera de resynchroniser inutilement les mêmes données.

2. Récupérez plusieurs entités en une seule requête : certains endpoints vous permettent de spécifier une liste de valeurs séparées par des virgules pour obtenir plusieurs éléments de données similaires. Cela peut réduire le nombre total d’appels effectués et ainsi utiliser la limite de taux plus efficacement.

3. Demandez la valeur maximale de « count » dans vos requêtes : certains endpoints, comme GET accounts/:account_id/targeting_criteria, sont fortement recommandés d’être appelés avec la valeur maximale de count afin de renvoyer 1000 objets au lieu de la valeur par défaut de 200.

​

Synchronisation des analyses

Consultez le guide sur les limites de taux pour les analyses pour plus d’informations sur les limites de taux de l’endpoint d’analyses.

​

FAQ

Est-il possible d’augmenter les limites de taux pour un compte publicitaire spécifique ou pour notre App ?

Nous ne pouvons généralement pas augmenter les limites de taux, qui sont configurées pour prendre en charge les plus grands comptes publicitaires. Mettez d’abord en œuvre les bonnes pratiques indiquées dans ce document. Si les limites de taux continuent d’affecter votre capacité à monter en charge ou à atteindre vos objectifs business, contactez vos interlocuteurs X Ads API en leur fournissant tous les détails sur le cas d’usage et les requêtes concernées.

​

Périmètres des limites de taux

​

Périmètres pour ce document

• Catégorie : tous les endpoints relevant de la catégorie donnée sont soumis à une limite de taux prélevée sur un quota unique par fenêtre.
• Endpoint : chaque endpoint dispose de sa propre limite allouée, distincte, par fenêtre.

​

Tableau des limites de taux de la X Ads API

​

Limites de taux de la X Ads API

Type d’endpoint	Portée par endpoint ou catégorie	Limite de taux par fenêtre de 1 minute
Écritures (POST, PUT, DELETE)	Catégorie	450
Audience	Endpoint	1 500

Type d’endpoint	Portée par endpoint ou catégorie	Limite de taux par fenêtre de 15 minutes
Analyses (synchrones)	Catégorie	250
Lectures des entités de base (Line Items, Campaigns, etc.) Autres lectures de compte (autres endpoints GET avec :account_id)	Endpoint (niveau compte publicitaire) Endpoint (niveau partiel du compte publicitaire)	10 000 2 000
Critères de ciblage (sauf ci-dessous)	Catégorie	400
Critères de ciblage (tv_markets, tv_shows)	Endpoint	2 000
Audience Insights	Catégorie	400
Keyword Insights	Catégorie	500
Lectures globales (endpoints GET sans :account_id)	Endpoint	5
Conversions	Endpoint	60 000