Limitación de frecuencia de la API de marketing

La API de marketing posee una lógica de limitación de frecuencia propia y es independiente de todas las limitaciones de frecuencia de la API Graph. Por lo tanto, si realizas una llamada a la API de marketing, no se tomará en cuenta para la limitación de la API Graph.

La función que afecta la cuota de limitación de frecuencia de la API de marketing es el acceso estándar a la administración de anuncios. Cuando agregas el producto de la API de marketing en tu panel de apps, de manera predeterminada obtendrás el acceso estándar en el acceso estándar a la administración de anuncios. Esto le dará acceso de desarrollo a la API de marketing. Si necesitas obtener más cuota de limitación de frecuencia, actualiza a acceso avanzado en Acceso estándar de administración de anuncios en la revisión de apps.

Cuotas

Acceso a la API de marketing	Acceso estándar a la administración de anuncios	Capacidad
Acceso de desarrollo	Acceso estándar	Cuota de limitación de frecuencia básica
Acceso estándar	Acceso avanzado	Más cuota de limitación de frecuencia

La mayoría de las solicitudes a la API de marketing y a la API de páginas están sujetas a los límites de frecuencia de caso de uso comercial (BUC) y dependen de los puntos de conexión que consultes. Para averiguarlo, verifica si tu solicitud HTTP contiene un encabezado X-Business-Use-Case. Consulta más detalles en límites de frecuencia de caso de uso comercial.

Límites en el nivel de la API del nivel de la cuenta publicitaria

El límite de frecuencia se encuentra en el nivel de la cuenta publicitaria.
La limitación de frecuencia se produce en tiempo real en un rango de tiempo determinado.
A cada llamada a la API de marketing se asigna una puntuación. Tu puntuación es la suma de tus llamadas a la API.
Aplicamos una puntuación máxima. En general, una llamada a la API de lectura equivale a 1 punto y una llamada a la API de escritura es igual a 3 puntos, y, cuando se alcanza la puntuación máxima, arrojamos un error de limitación.
- Si tu app está en el nivel de desarrollo de la API de marketing:
  - Tu puntuación máxima es de 60.
  - La tasa de depreciación es de 300 segundos.
  - Se te bloqueará durante 300 segundos si alcanzas la puntuación máxima.
- Si tu app está en el nivel estándar de la API de marketing:
  - Tu puntuación máxima es de 9.000.
  - La tasa de depreciación es de 300 segundos.
  - Se te bloqueará durante 60 segundos si alcanzas la puntuación máxima.

Código de error relacionado:17, Error subcode: 2446079, Message: User request limit reached. 613, Error subcode: 1487742, Message: There have been too many calls from this ad-account. Please wait a bit and try again.

Límites de frecuencia de solicitudes por segundo en el nivel de la cuenta publicitaria

Para evitar que los picos repentinos de tráfico sobrecarguen nuestros sistemas, aplicamos un límite de frecuencia en tiempo real en los puntos de conexión de mutación de la API de marketing (operaciones de creación y edición de campañas, conjuntos de anuncios y anuncios).

El límite de frecuencia se aplica por app en el nivel de la cuenta publicitaria.
Límite: 100 solicitudes por segundo (QPS) por combinación de app y cuenta publicitaria.
Se aplica a: operaciones de creación y edición de campañas, conjuntos de anuncios y anuncios.
Este límite funciona en tiempo real y está diseñado para captar los picos de tráfico breves que el intervalo de limitación de frecuencia estándar podría no detectar.

Se verán afectados los siguientes puntos de conexión:

Cuando superes este límite, distribuye las solicitudes de manera más pareja a lo largo del tiempo, en lugar de enviarlas en ráfagas.

Código de error relacionado:613, Error subcode: 5044001, Message: Your ad account {ad_account_id} has exceeded the maximum allowed rate of mutation requests. To resolve this, reduce the frequency of your create, update operations on campaigns, ad sets, and ads.

Cuando se produzca este error, implementa la limitación de solicitudes para no superar las 100 QPS por cuenta publicitaria.

Limitación de frecuencia de la plataforma de las estadísticas de anuncios

El límite de frecuencia se encuentra en el nivel de la app.
La limitación de frecuencia se determina por la capacidad de la infraestructura de backend y los servicios de bajada.
Si tu app está sujeta a limitación de frecuencia, todas las llamadas a la API de estadísticas de anuncios de la app se verán limitadas.
Se aplica limitación de frecuencia en el nivel de la app.

Código de error relacionado:4, Error subcode: 1504022 or 1504039, Message: There have been too many calls from this app. Wait a bit and try again.

Cuando se produce este error, se reducen tus llamadas.

Límites en el nivel de app

El límite de frecuencia se encuentra en el nivel de la app.
La limitación de frecuencia se determina por el número total de usuarios de una app.
Si tu app está sujeta a limitación de frecuencia, todas las llamadas de la app se encuentran limitadas.
Se aplica limitación de frecuencia en el nivel de la app.

Código de error relacionado:4, Message: Application request limit reached

Cuando se produce este error, se reducen tus llamadas.

Límites de casos de uso de negocios en el nivel de la cuenta publicitaria

Calculamos el cupo de la limitación de frecuencia en función del nivel de acceso a la API de marketing y tu app.

La limitación de frecuencia se encuentra en el nivel de la cuenta de anuncios, y se calcula la cuota en función de tu acceso a la API de anuncios sobre apps.
ads_management: en relación con cada cuenta publicitaria en un período de una hora: (100.000 si tu app está en el nivel estándar de la API de marketing, o bien 300 si tu app se encuentra en el nivel de desarrollo) + 40 * Número de anuncios activos.
custom_audience: en relación con cada cuenta publicitaria en un período de una hora: no más de 700.000. No menos de 190.000 si tu app está en el nivel estándar de la API de marketing, o bien 5.000 si tu app está en el nivel de desarrollo + 40 * Número de públicos personalizados activos.
ads_insights: en relación con cada cuenta publicitaria en un período de una hora: (190.000 si su aplicación está en el nivel estándar de la API de anuncios, o bien 600 si tu app se encuentra en el nivel de desarrollo) + 400 * Número de anuncios activos - 0,001 * Errores de usuario.
Administración de catálogos: en relación con cada cuenta publicitaria en un período de una hora: 20.000 + 20.000 * log2 (usuarios únicos).
Lote de catálogos: en relación con cada cuenta publicitaria en un período de una hora: 200 + 200 * log2 (usuarios únicos).
Tu limitación de frecuencia de la API de marketing también puede determinarse por el tiempo total de CPU y el tiempo real en tu cuenta publicitaria. Tendrás más cuota si su app tiene acceso estándar a la API de marketing. Para obtener más detalles, consulta el encabezado HTTP [X-Business-Use-Case](/docs/graph-api/overview/rate-limiting/#headers-2) y límites de frecuencia de caso de uso comercial.

Código de error relacionado:80000, 80003, 80004, 80014, Message: There have been too many calls from this ad-account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.

Verifica el punto de conexión de la API y el encabezado X-Business-Use-Case HTTP para confirmar el tipo de limitación. Consulta más detalles en límites de frecuencia de caso de uso comercial. Cuando se produce este error, reduce los cambios en la cuenta publicitaria.

Límite de frecuencia del gasto en anuncios en el nivel de la cuenta publicitaria

Limitamos la posibilidad de cambiar tus límites de gasto en la cuenta a 10 veces al día para garantizar el rendimiento de la entrega de anuncios.

Se encuentra limitado el número de cambios en el gasto de la cuenta publicitaria, como los campos spend_cap y spend_cap_action.

Código de error relacionado:17, Error subcode: 1885172, Message: You can only change your account spending limit 10 times per day. Please wait to make more changes.

Límites en el nivel del conjunto de anuncios

El número de cambios a los campos del conjunto de anuncios daily_budget y lifetime_budget se encuentra limitado. En relación con los conjuntos de anuncios, solo es posible cambiar el presupuesto 4 veces por hora. Si se supera el límite, el cambio de presupuesto de ese conjunto de anuncios se bloquea durante una hora.

Código de error relacionado:613, Error subcode: 1487632, Message: You can only change your ad set budget 4 times per hour. Please wait to make more changes.

Cuando se produce este error, redúcelos cambios en el conjunto de anuncios.

Límites en el nivel de los anuncios

La creación de anuncios de una determinada cuenta publicitaria está limitada en función del límite de gasto diario.

Código de error relacionado:613, Error subcode: 1487225, Message: User request limit reached.

Verifica el subcódigo de error (1487225) y el punto de conexión de la API para confirmar el tipo de limitación. Cuando se produce este error, reduce progresivamente los cambios. Para aumentar el límite, también puedes aumentar el límite de gasto diario.

Límites de frecuencia de la prevención del uso indebido de datos

Cuando nuestro sistema detecta que determinadas cuentas publicitarias generan una gran cantidad anormal de tráfico, reduciremos de manera temporal la cuota del límite de frecuencia de la API de las cuentas con tráfico anormal, a fin de proteger la estabilidad del sistema y garantizar la experiencia de los otros usuarios. Intenta ponerte en contacto con la asistencia de Meta para obtener ayuda.

Código de error relacionado:613, Error subcode: null, Message: (#613) Calls to this api have exceeded the rate limit.

La diferencia entre este y el límite en el nivel de la API del nivel de la cuenta publicitaria es que este error no contiene códigos de error subyacentes. Si se produce este error, investiga si se activó alguna acción que excede las solicitudes de la API y ponte en contacto con la asistencia de Meta para obtener ayuda.

Manejar errores de limitación

Evaluación inicial

Verificar el nivel de acceso a la API de marketing:

De forma predeterminada, las apps tienen development_access a la API de marketing. Para determinar en qué nivel te encuentras, puedes ir al panel de revisión de apps. Estás en el nivel de desarrollo de acceso a la API de marketing si cuentas con acceso estándar a la función de acceso estándar a la administración de anuncios. Estás en el nivel estándar de acceso a la Marketing API si cuentas con acceso avanzado a la función de acceso estándar a la administración de anuncios. Puedes verificar tu encabezado HTTP y buscar ads_api_access_tier en tu encabezado X-Ad-Account-Usage, X-Business-Use-Case o X-FB-Ads-Insights-Throttle.

Si continúas recibiendo errores relacionados con el límite de frecuencia, considera actualizar al standard_access del acceso estándar a la administración de anuncios. Para obtener el nivel estándar y una cuota de limitación de frecuencia mayor, puedes solicitar acceso avanzado a la función de acceso estándar a la administración de anuncios en el panel de revisión de apps.

Verifica códigos de error: determina los códigos de error específicos relacionados con la limitación en la respuesta de la API.
Verifica encabezados HTTP:
- X-Ad-Account-Usage contiene acc_id_util_pct, reset_time_duration y ads_api_access_tier.
- X-Business-Use-Case contiene call_count, total_cputime, total_time, estimated_time_to_regain_access, etc., información para el punto de conexión del caso de uso comercial.
- X-FB-Ads-Insights-Throttle contiene app_id_util_pct, acc_id_util_pct y ads_api_access_tier para los puntos de conexión de la API de estadísticas de anuncios.
Verifica el panel de apps: proporcionamos consolas en el panel de apps que brindan a los desarrolladores estadísticas detalladas del sistema de limitación de frecuencia y los ayudan a diagnosticar y prevenir problemas relacionadas con la limitación de frecuencia.

Identificar la causa

Límites de frecuencia: ten presentes los límites de frecuencia de la API de marketing de Meta para los diferentes puntos de conexión que se utilizan y verifica si el número de solicitudes de la API se encuentra comprendido dentro de los límites permitidos para la app.
Límites de ráfaga: verifica si los límites de las series de fotos causan problemas durante los períodos de uso pico. Por lo general, el tráfico de ráfaga causará límites en el nivel de la API del nivel de la cuenta publicitaria (Códigos de error relacionados: , 17, 613).
Operaciones incorrectas: investiga si alguna operación incorrecta genera solicitudes de API excesivas.

Medidas de mitigación

Prevenir tráfico de ráfaga: distribuye las solicitudes a la API de manera uniforme para evitar una limitación causada por un gran número de accesos en un corto período de tiempo.
Optimizar solicitudes: combinar varias solicitudes más pequeñas en solicitudes por lotes, ya sea por lotes de identificadores o solicitudes asincrónicas, con el fin de minimizar el número total de llamadas a la API.
Estrategia de retraso: implementar un retraso exponencial al recibir errores de limitación, lo que aumenta gradualmente el tiempo entre intentos. También puedes examinar los encabezados HTTP para estimar el tiempo de restablecimiento.

Otras sugerencias de mitigación

Identificar si estas llamadas son necesarias y reducirlas si no lo son.
En relación con los puntos de conexión que admiten solicitudes asincrónicas, como la API de estadísticas de anuncios, utiliza solicitudes asincrónicas para consultar una gran cantidad de datos.
También puedes intentar pasar una lista de identificadores si necesitas consultar varios objetos de anuncios del mismo tipo.
En lo que respecta a la API de estadísticas, usa parámetros de nivel o filtrado para reducir el número de llamadas.