사용자 수준 및 광고 계정 수준 한도
모범 사례
-
데이터베이스에 마지막으로 동기화한 시각의 타임스탬프를 저장하고, 해당되는 경우 데이터 요청 시
sort_by=updated_at-desc옵션을 사용하여 마지막 동기화 시각보다 이전 데이터에 도달하면 동기화 프로세스를 중지할 수 있도록 하십시오. 이렇게 하면 동일한 데이터를 불필요하게 반복 동기화하는 일을 피할 수 있습니다. - 하나의 요청에서 여러 엔터티를 요청하십시오: 일부 엔드포인트에서는 쉼표로 구분된 값 목록을 지정해 유사한 데이터를 여러 개 한 번에 조회할 수 있습니다. 이렇게 하면 전체 호출 횟수를 줄일 수 있어 레이트 리밋을 더 효율적으로 활용할 수 있습니다.
- 요청 시 가능한 최대 “count” 값을 사용하십시오: GET accounts/:account_id/targeting_criteria와 같은 일부 엔드포인트는 기본값인 200개 대신 1000개의 오브젝트를 반환하도록 최대 count 값으로 호출할 것을 강력히 권장합니다.
애널리틱스 동기화
FAQ
Rate limit 범위
이 문서에서 사용하는 범위
- 카테고리: 해당 카테고리에 속하는 모든 엔드포인트에 대해 하나의 시간 윈도우당 공통으로 할당된 단일 한도가 적용됩니다.
- 엔드포인트: 각 엔드포인트마다 시간 윈도우별로 고유한 할당 한도가 적용됩니다.
Ads API 레이트 리밋 표
Ads API 요청 한도
| 엔드포인트 유형 | 엔드포인트 또는 범주별 범위 | 1분당 요청 한도 |
|---|---|---|
| 쓰기 요청 (POST, PUT, DELETE) | 범주 | 450 |
| Audience | 엔드포인트 | 1500 |
| 엔드포인트 유형 | 엔드포인트 또는 범주별 범위 | 15분당 요청 한도 |
|---|---|---|
| Analytics (동기식) | 범주 | 250 |
| 핵심 엔티티 조회 (Line Items, Campaigns 등) 기타 계정 조회 (:account_id가 있는 기타 GET 엔드포인트) | 엔드포인트 (광고 계정 수준) 엔드포인트 (부분 광고 계정 수준) | 10,000 2000 |
| 타깃팅 기준 (아래 항목 제외) | 범주 | 400 |
| 타깃팅 기준 (tv_markets, tv_shows) | 엔드포인트 | 2000 |
| Audience Insights | 범주 | 400 |
| Keyword Insights | 범주 | 500 |
| 글로벌 조회 (:account_id가 없는 GET 엔드포인트) | 엔드포인트 | 5 |
| Conversions | 엔드포인트 | 60,000 |