Skip to content

사용량 제한

Braze API 인프라는 고객 기반 전체에서 대량의 데이터를 처리하도록 설계되었습니다. 이를 위해 워크스페이스별로 API 사용량 제한을 적용합니다.

사용량 제한은 API가 주어진 시간 동안 수신할 수 있는 요청의 수입니다. 대규모 시스템에서 발생하는 부하 기반 서비스 거부 사고의 대부분은 악의적인 공격이 아닌 소프트웨어 또는 구성 오류로 인해 의도치 않게 발생합니다. 사용량 제한은 이러한 오류로 인해 고객이 Braze API 리소스를 사용하지 못하는 상황을 방지합니다. 지정된 시간 프레임 내에 너무 많은 요청이 전송되면, 429 상태 코드와 함께 오류 응답이 표시될 수 있으며, 이는 사용량 제한에 도달했음을 나타냅니다.

요청 유형별 사용량 제한

다음은 다양한 요청 유형의 기본 API 사용량 제한입니다. 이러한 기본 한도는 요청에 따라 늘릴 수 있습니다. 자세한 내용은 고객 성공 매니저에게 문의하세요.

사용량 제한이 다른 요청

공유 사용량 제한이 있는 요청

다음 요청은 시간당 250,000건의 사용량 제한이 있으며, 이들 간에 공유됩니다.

같은 고유 오디언스로 간주되는 것은 무엇인가요?

이는 다음 세 가지 엔드포인트에 적용됩니다: /messages/send, /campaigns/trigger/send, /canvas/trigger/send.

이 엔드포인트의 경우, 브로드캐스트 요청은 다음 모든 조건이 일치할 때 같은 고유 오디언스를 타겟팅하는 것으로 간주됩니다:

  • 트리거되는 캠페인 또는 캔버스(API 요청에서 지정된 경우 campaign_id 또는 canvas_id)
  • 타겟팅되는 오디언스(세그먼트 또는 필터, 또는 API 캠페인의 경우 API 요청의 segment_id)
  • 연결된 오디언스 필터(API 요청에서 지정된 경우 audience 오브젝트)

이러한 속성의 각 고유 조합은 별개의 오디언스로 간주되므로, 각 고유 오디언스에 대한 추가 사용량 제한은 각 조합에 독립적으로 적용됩니다.

API 요청 배치 처리

Braze API는 배치 처리를 지원하도록 구축되었습니다. 배치 처리를 통해 Braze는 단일 API 호출에서 가능한 한 많은 데이터를 수집할 수 있으므로 많은 API 호출을 할 필요가 없습니다. Braze가 데이터를 한 번에 하나씩 처리하는 것보다 배치로 처리하는 것이 더 효율적입니다. 예를 들어, 1,000건의 배치 API 호출을 처리하는 데는 75,000건의 개별 호출을 처리하는 것보다 적은 리소스가 필요합니다. 배치 처리는 시간당 75,000회 이상의 호출이 필요할 수 있는 모든 애플리케이션에 매우 중요합니다.

사용자 추적 엔드포인트에 대한 요청 배치 처리

각 /users/track 요청은 attributes, events, purchases 전체에서 최대 75개의 오브젝트를 결합하여 포함할 수 있습니다. 각 오브젝트는 한 명의 사용자를 업데이트할 수 있습니다. 단일 고객 프로필은 여러 오브젝트에 의해 업데이트될 수 있습니다.

레거시 사용량 제한

레거시 사용량 제한을 적용받는 고객의 경우, 각 배열(attributes, events, purchases)에 최대 75개의 오브젝트를 독립적으로 포함할 수 있으며, 요청당 최대 225개의 오브젝트를 결합할 수 있습니다.

/users/track 사용량 제한에 대한 자세한 내용은 POST: 사용자 생성 및 업데이트를 참조하세요.

이 엔드포인트에 대한 요청은 일반적으로 다음 순서로 처리가 시작됩니다:

  1. 속성
  2. 이벤트
  3. 구매

메시징 엔드포인트 요청 배치 처리

메시징 엔드포인트에 대한 단일 요청은 다음 중 하나에 도달할 수 있습니다:

  • 최대 50개의 특정 external_ids(각각 개별 메시지 매개변수 포함)
  • Braze 대시보드에서 생성된 임의 크기의 세그먼트(segment_id로 지정)
  • 요청에서 연결된 오디언스 오브젝트로 정의된 임의 크기의 추가 오디언스 필터와 일치하는 사용자

배치 요청 예시

다음 예시에서는 external_id를 사용하여 이메일과 SMS에 대해 하나의 API 호출을 수행합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    },
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    }
  ]
}

사용량 제한 모니터링

Braze로 전송된 모든 API 요청은 응답 헤더에 다음 정보를 반환합니다:

이 정보는 Braze 대시보드가 아닌 API 요청의 응답 헤더에 의도적으로 포함됩니다. 이를 통해 시스템이 API와 상호 작용할 때 실시간으로 더 잘 대응할 수 있습니다. 예를 들어, X-RateLimit-Remaining 값이 특정 임계값 이하로 떨어지면 모든 트랜잭션 이메일이 발송되도록 전송 속도를 늦출 수 있습니다. 또는 값이 0에 도달하면 X-RateLimit-Reset에 지정된 시간이 경과할 때까지 모든 전송을 일시 중지할 수 있습니다.

API 한도에 대한 질문이 있는 경우 고객 성공 매니저에게 문의하거나 고객지원 티켓을 열어주세요.

엔드포인트 간 최적의 지연

엔드포인트 간의 최적 지연 시간을 이해하는 것은 Braze API에 연속 호출을 할 때 매우 중요합니다. 엔드포인트가 다른 엔드포인트의 성공적인 처리에 의존하는 경우 문제가 발생하며, 너무 빨리 호출하면 오류가 발생할 수 있습니다. 예를 들어, /user/alias/new 엔드포인트를 통해 사용자에게 별칭을 할당한 후 해당 별칭을 사용하여 /users/track 엔드포인트를 통해 커스텀 이벤트를 전송하는 경우, 얼마나 기다려야 할까요?

정상적인 조건에서 데이터 최종 일관성이 발생하는 시간은 10~100ms(1/10초)입니다. 그러나 일관성이 발생하는 데 더 오랜 시간이 걸리는 경우가 있을 수 있으므로, 오류 확률을 최소화하기 위해 후속 호출 사이에 5분의 지연을 두는 것을 권장합니다.

사용량 제한 재설정

사용량 제한은 롤링 윈도우가 아닌 정시에 재설정됩니다. 예를 들어, 한도가 시간당 250,000건의 요청인 경우, 오후 10:00~10:59 사이에 50,000건의 요청을 보내고 오후 11:00~11:59 사이에 또 다른 250,000건의 요청을 보낼 수 있습니다. 카운터가 매 정시에 재설정되기 때문입니다.
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!