요금 제한

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

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

요청 유형별 사용량 제한

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

API 요청 일괄 처리

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

사용자 추적 요청 일괄 처리

각 /users/track 요청에는 최대 75개의 이벤트 객체, 75개의 속성 객체 및 75개의 구매 객체가 포함될 수 있습니다. 각 객체(이벤트, 속성 및 구매 배열)는 각각 한 명의 사용자를 업데이트할 수 있습니다. 따라서 한 번의 통화로 최대 225명의 사용자를 업데이트할 수 있습니다. 또한 단일 고객 프로필을 여러 객체로 업데이트할 수 있습니다.

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

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","example1@email.com"]
    },
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","example1@email.com"]
    }
  ]
}

사용량 제한 모니터링

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분의 지연을 허용하는 것이 좋습니다.