Track Events API 이벤트 전달 확장 기능
Braze Track Events API 이벤트 전달 확장 기능을 사용하면 Adobe Experience Platform Edge Network에서 캡처한 데이터를 활용하여
/users/trackAPI를 통해 서버 측 이벤트 형태로 Braze에 전송할 수 있습니다.
이 문서에서는 확장 기능의 사용 사례, 이벤트 전달 라이브러리에 설치하는 방법, 이벤트 전달 규칙에서 기능을 활용하는 방법을 다룹니다.
Adobe 이벤트 전달 사용은 Braze 데이터 포인트 사용량을 증가시킬 수 있습니다. 자세한 내용은 데이터 포인트에 대한 Braze 설명서를 참조하세요.
사용 사례
이 확장 기능은 Edge Network의 데이터를 Braze에서 활용하여 고객 분석 및 타겟팅 기능을 사용할 수 있도록 합니다.
예를 들어, 멀티채널(웹사이트 및 모바일)을 운영하는 소매 조직이 웹사이트와 모바일 플랫폼에서 트랜잭션 또는 대화형 입력을 이벤트 데이터로 캡처하는 경우를 생각해 보세요.
다양한 태그 규칙을 사용하여 이 데이터는 실시간으로 Edge Network에 전송됩니다. 여기서 Braze 이벤트 전달 확장 기능이 서버 측에서 관련 이벤트를 자동으로 Braze에 전송합니다.
사용량 제한
| API | 사용량 제한 |
|---|---|
| User Track | 분당 50,000건의 요청. 자세한 내용은 User Track API 설명서를 참조하세요. |
통합
1단계: 필수 구성 세부 정보 수집
Edge Network를 Braze에 연결하려면 다음이 필요합니다:
| 키 유형 | 설명 |
|---|---|
| Braze 인스턴스 | Braze 인스턴스는 Braze 온보딩 매니저에게 문의하거나 API 개요 페이지에서 확인할 수 있습니다. |
| Braze REST API 키 | 모든 권한이 있는 Braze REST API 키. Braze 대시보드의 설정 > API 키에서 생성할 수 있습니다. |
2단계: 시크릿 생성
새 이벤트 전달 시크릿을 생성하고 값을 Braze API 키로 설정합니다. 이 시크릿은 값을 안전하게 유지하면서 계정에 대한 연결을 인증하는 데 사용됩니다.
3단계: Braze 확장 기능 설치 및 구성
- 확장 기능을 설치하려면 이벤트 전달 속성을 생성하거나 기존 속성을 선택하여 편집합니다.
- 다음으로, 왼쪽 탐색에서 Extensions를 선택합니다. Catalog 탭에서 Braze 확장 기능 카드의 Install을 선택합니다.
- 다음 화면에서 REST 인스턴스와 API 키를 입력하고 완료되면 Save를 선택합니다.
4단계: 이벤트 전송 규칙 생성
확장 기능을 설치한 후, 새 이벤트 전달 규칙을 생성하고 원하는 대로 조건을 구성합니다. 규칙의 동작을 구성할 때 Braze 확장 기능을 선택한 다음 동작 유형으로 Send Event를 선택합니다.
| 입력 | 설명 |
|---|---|
| 외부 사용자 ID | 길고 무작위적이며 잘 분산된 UUID 또는 GUID. 사용자 ID 이름을 지정하는 다른 방법을 선택하는 경우에도 길고 무작위적이며 잘 분산되어야 합니다. 권장 사용자 ID 명명 규칙에 대해 자세히 알아보세요. |
| Braze 사용자 ID | Braze 사용자 식별자. |
| 사용자 별칭 | 별칭은 대체 고유 사용자 식별자 역할을 합니다. 별칭을 사용하여 핵심 사용자 ID와 다른 차원에서 사용자를 식별할 수 있습니다. 사용자 별칭 오브젝트는 식별자 자체인 alias_name과 별칭 유형을 나타내는 alias_label 두 부분으로 구성됩니다. 사용자는 서로 다른 레이블을 가진 여러 별칭을 가질 수 있지만 alias_label당 하나의 alias_name만 가질 수 있습니다. |
이벤트를 사용자에게 연결하려면 External User ID 필드, Braze User Identifier 필드 또는 User Alias 섹션 중 하나를 입력해야 합니다.
| 입력 | 설명 | 필수 |
|---|---|---|
| 이벤트 이름 | 이벤트의 이름. | 예 |
| 이벤트 시간 | ISO 8601 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식의 문자열로 된 날짜-시간. |
예 |
| 앱 식별자 | 앱 식별자 또는 app_id는 워크스페이스 내 특정 앱과 활동을 연결하는 매개변수입니다. 워크스페이스 내에서 상호작용하는 앱을 지정합니다. |
아니요 |
| 이벤트 등록정보 | 이벤트의 커스텀 등록정보를 포함하는 JSON 오브젝트. | 아니요 |
Braze Send Event 동작에는 Event Name과 Event Time만 지정하면 되지만, 커스텀 등록정보 필드에 가능한 한 많은 정보를 포함하는 것이 좋습니다. 자세한 내용은 이벤트 오브젝트를 참조하세요.
사용자 속성은 지정된 고객 프로필에서 제공된 이름과 값으로 속성을 생성하거나 업데이트하는 필드를 포함하는 JSON 오브젝트일 수 있습니다. 다음 등록정보가 지원됩니다:
| 사용자 속성 | 설명 |
|---|---|
| 이름 | 사용자의 이름. |
| 성 | 사용자의 성. |
| 전화번호 | 사용자의 전화번호. |
| 이메일 | 사용자의 이메일 주소. |
| 성별 | 다음 문자열 중 하나: “M”, “F”, “O”(기타), “N”(해당 없음), “P”(밝히고 싶지 않음). |
| 도시 | 사용자의 도시. |
| 국가 | ISO-3166-1 alpha-2 형식의 문자열로 된 사용자의 국가. |
| 언어 | ISO-639-1 형식의 문자열로 된 사용자의 언어. |
| 생년월일 | “YYYY-MM-DD” 형식의 문자열로 된 사용자의 생년월일(예: 1980-12-21). |
| 시간대 | IANA 시간대 데이터베이스의 시간대 이름(예: ‘America/New_York’ 또는 ‘Eastern Time (US & Canada)’). |
id(문자열), likes(문자열 배열), num_friends(정수) 중 하나를 포함하는 해시. |
|
id(정수), screen_name(문자열, X(구 Twitter) 핸들), followers_count(정수), friends_count(정수), statuses_count(정수) 중 하나를 포함하는 해시. |
구성 내에서 추가된 모든 속성은 속성 값의 변경 여부와 관계없이 이벤트가 Braze에 전송될 때마다 전송됩니다. 사용자 속성을 구성할 때 이것이 데이터 포인트 사용량에 미치는 영향을 반드시 확인하세요.
5단계: 구매 이벤트 전송 규칙 생성
확장 기능을 설치한 후, 새 이벤트 전달 규칙을 생성하고 원하는 대로 조건을 구성합니다. 규칙의 동작을 구성할 때 Braze 확장 기능을 선택한 다음 동작 유형으로 Send Purchase Event를 선택합니다.
| 입력 | 설명 |
|---|---|
| 외부 사용자 ID | 길고 무작위적이며 잘 분산된 UUID 또는 GUID. 사용자 ID 이름을 지정하는 다른 방법을 선택하는 경우에도 길고 무작위적이며 잘 분산되어야 합니다. 권장 사용자 ID 명명 규칙에 대해 자세히 알아보세요. |
| Braze 사용자 ID | Braze 사용자 식별자. |
| 사용자 별칭 | 별칭은 대체 고유 사용자 식별자 역할을 합니다. 별칭을 사용하여 핵심 사용자 ID와 다른 차원에서 사용자를 식별할 수 있습니다. 사용자 별칭 오브젝트는 식별자 자체인 alias_name과 별칭 유형을 나타내는 alias_label 두 부분으로 구성됩니다. 사용자는 서로 다른 레이블을 가진 여러 별칭을 가질 수 있지만 alias_label당 하나의 alias_name만 가질 수 있습니다. |
이벤트를 사용자에게 연결하려면 External User ID 필드, Braze User Identifier 필드 또는 User Alias 섹션 중 하나를 완료해야 합니다.
| 입력 | 설명 | 필수 |
|---|---|---|
| 제품 ID | 구매 식별자. (예: 제품 이름 또는 제품 카테고리) | 예 |
| 구매 시간 | ISO 8601 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식의 문자열로 된 날짜-시간. |
예 |
| 통화 | ISO 4217 알파벳 통화 코드 형식의 문자열로 된 통화. | 예 |
| 가격 | 오브젝트의 가격. | 예 |
| 수량 | 구매 수량. 제공되지 않으면 기본값은 1입니다. 최대값은 100 미만이어야 합니다. | 아니요 |
| 앱 식별자 | 앱 식별자 또는 app_id는 워크스페이스 내 특정 앱과 활동을 연결하는 매개변수입니다. 워크스페이스 내에서 상호작용하는 앱을 지정합니다. |
아니요 |
| 구매 등록정보 | 구매의 커스텀 등록정보를 포함하는 JSON 오브젝트. | 아니요 |
Send Purchase Event 동작에는 Product ID, Purchase Time, Currency, Price만 지정하면 되지만, 구매 등록정보 필드에 가능한 한 많은 정보를 포함하는 것이 좋습니다. 자세한 내용은 구매 오브젝트를 참조하세요.
구성 보기에서 각 이벤트와 함께 속성을 전송할지 여부를 선택할 수 있습니다.
사용자 속성은 지정된 고객 프로필에서 제공된 이름과 값으로 속성을 생성하거나 업데이트하는 필드를 포함하는 JSON 오브젝트일 수 있습니다. 다음 등록정보가 지원됩니다:
| 사용자 속성 | 설명 |
|---|---|
| 이름 | 사용자의 이름. |
| 성 | 사용자의 성. |
| 전화번호 | 사용자의 전화번호. |
| 이메일 | 사용자의 이메일 주소. |
| 성별 | 다음 문자열 중 하나: “M”, “F”, “O”(기타), “N”(해당 없음), “P”(밝히고 싶지 않음). |
| 도시 | 사용자의 도시. |
| 국가 | ISO-3166-1 alpha-2 형식의 문자열로 된 사용자의 국가. |
| 언어 | ISO-639-1 형식의 문자열로 된 사용자의 언어. |
| 생년월일 | “YYYY-MM-DD” 형식의 문자열로 된 사용자의 생년월일(예: 1980-12-21). |
| 시간대 | IANA 시간대 데이터베이스의 시간대 이름(예: ‘America/New_York’ 또는 ‘Eastern Time (US & Canada)’). |
id(문자열), likes(문자열 배열), num_friends(정수) 중 하나를 포함하는 해시. |
|
id(정수), screen_name(문자열, X(구 Twitter) 핸들), followers_count(정수), friends_count(정수), statuses_count(정수) 중 하나를 포함하는 해시. |
구성 내에서 추가된 모든 속성은 속성 값의 변경 여부와 관계없이 이벤트가 Braze에 전송될 때마다 전송됩니다. 사용자 속성을 구성할 때 이것이 데이터 포인트 사용량에 미치는 영향을 반드시 확인하세요.
6단계: Braze에서 데이터 검증
이벤트 수집과 Adobe Experience Platform 통합이 성공적으로 완료되면 사용자 프로필 보기 시 Braze 콘솔에서 이벤트를 확인할 수 있습니다. 구체적으로, Braze에 전송된 새 이벤트 데이터는 특정 사용자의 개요 탭에 있는 Purchases 또는 Custom Events 섹션에 반영됩니다.