API 및 SDK 엔드포인트

Braze 인스턴스에 맞는 올바른 대시보드 URL, REST API 엔드포인트, SDK 엔드포인트를 확인하세요. 로그인, API 호출, SDK 통합을 위해 이 URL이 필요합니다.

Braze는 대시보드, SDK, REST 엔드포인트를 위해 여러 인스턴스를 관리하며, 이를 “클러스터”라고 부릅니다. Braze 온보딩 매니저가 어떤 클러스터에 속해 있는지 알려드립니다. Braze SDK에 대해 자세히 알아보려면 Braze 101 Braze 학습 과정을 확인하세요.

dashboard.braze.com에서 로그인하면 자동으로 올바른 클러스터 주소로 이동합니다.

중요

SDK를 통합할 때는 SDK 엔드포인트를 사용하세요. REST API를 호출할 때는 REST 엔드포인트를 사용하세요.

API 접근에 대한 자세한 내용은 API 개요 문서를 참조하세요.

커스텀 URL

클러스터의 표준 SDK 엔드포인트 대신 프록시나 커스텀 도메인 같은 커스텀 URL로 네트워크 요청을 보내도록 Braze SDK를 구성할 수 있습니다. 다음 SDK에서 커스텀 URL을 지원합니다.

• Braze Swift SDK: 버전 11.8.0 이상
• Braze Android SDK: 버전 2.11 이상

커스텀 URL 구성하기

SDK를 초기화할 때 SDK 엔드포인트를 설정하는 위치에 커스텀 URL을 설정합니다. 전체 통합 단계는 Braze SDK 통합하기를 참조하세요.

• swift
• android

1
2
3
4
5
6

let configuration = Braze.Configuration(
  apiKey: "YOUR_APP_IDENTIFIER_API_KEY",
  endpoint: "YOUR_CUSTOM_URL"
)
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4

BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"YOUR_APP_IDENTIFIER_API_KEY"
                                                                  endpoint:@"YOUR_CUSTOM_URL"];
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

1
2
3
4
5

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string translatable="false" name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
  <string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_URL</string>
</resources>

1
2
3
4
5

BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5

val brazeConfig = BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build()
Braze.configure(this, brazeConfig)

프록시 구성 테스트하기

앱을 프로덕션에 출시하기 전에 프록시가 예상대로 작동하는지 테스트하세요. SDK가 커스텀 URL로 요청을 보내는지 확인하려면 상세 로깅을 사용합니다.

1. SDK를 초기화하기 전에 개발 빌드에서 상세 로깅을 활성화합니다. SDK별 코드는 상세 로깅을 참조하세요.
2. 테스트 기기 또는 시뮬레이터에서 앱을 실행합니다. 세션이 시작되면 SDK가 요청을 보냅니다.
3. 로그에서 요청 항목을 찾아 요청 URL이 커스텀 URL과 일치하는지 확인합니다.
4. 프록시가 SDK로부터 요청을 수신하는지 확인합니다.

Android에서 커스텀 URL로 전송된 요청이 보이지 않으면 API 키와 엔드포인트 구성을 확인하세요. 로그에 표시되는 요청 항목의 예시는 상세 로그 읽기를 참조하세요.

중요

앱을 프로덕션에 출시하기 전에 상세 로깅을 비활성화하세요.