Braze Track Events API 이벤트 전달 확장 기능

마지막 업데이트: 2023-12-07

주제:
Tags
이 항목에 대한 자세한 내용 보기

작성 대상:
Developer

User

Admin

Leader

Braze 는 소비자와 브랜드 간의 고객 중심 상호 작용을 실시간으로 향상시키는 고객 참여 플랫폼입니다. 사용 Braze, 다음 작업을 수행할 수 있습니다.

언어 선호도, 위치 선호도 등을 기반으로 타겟팅된 사용자에게 데이터(예: 마케팅 메시지)를 전달하여 전환율을 높이고 주요 비즈니스 목표를 지원합니다.
이메일, 푸시 알림, 인앱 메시지 등 다양한 채널에서 적시에 원하는 언어로 고객에게 개인화된 메시지를 보낼 수 있습니다.
마케팅 및 홍보 캠페인에 특정 사용자를 타깃팅하여 반복 고객 수를 늘립니다.
사용자 행동 및 패턴을 연구하여 사용자 지정된 메시지로 특정 대상을 타깃팅하면 매출이 늘어날 수 있습니다.

다음 Braze Track Events API 이벤트 전달 확장을 사용하면 Adobe Experience Platform Edge Network에 캡처된 데이터를 활용하여 로 전송할 수 있습니다. Braze 를 사용하는 서버측 이벤트 형식으로 Braze User Track API.

이 문서에서는 확장의 사용 사례, 이벤트 전달 라이브러리에 설치하는 방법, 이벤트 전달에서 해당 기능을 사용하는 방법에 대해 설명합니다 규칙.

사용 사례

에서 Edge Network의 데이터를 사용하려면 이 확장 기능을 사용해야 합니다 Braze customer analytics 및 타깃팅 기능을 활용하십시오.

예를 들어, 다중 채널 상태(웹 사이트 및 모바일)를 가지고 있고 트랜잭션 또는 대화형 입력을 웹 사이트 및 모바일 플랫폼의 이벤트 데이터로 캡처하고 있는 소매 조직을 생각해 보십시오. 다양한 사용 태그 규칙에서 이 데이터는 Edge Network로 실시간으로 전송됩니다. 여기에서 Braze 이벤트 전달 확장 프로그램은 관련 이벤트를 Braze 서버측에서 가져온 것입니다.

데이터가 전송되면 조직의 분석 팀이 을 활용할 수 있습니다 Braze’s 데이터 세트를 처리하고 비즈니스 통찰력을 도출하여 그래프, 대시보드 또는 비즈니스 이해 당사자에게 알리는 기타 시각화를 생성하는 기능. 다음을 참조하십시오. Braze 고객 플랫폼의 다양한 사용 사례에 대한 자세한 내용은 페이지를 참조하십시오.

Braze 사전 요구 사항 및 보호 기능

다음 항목이 있어야 합니다. Braze 계정을 사용하여 해당 기술을 사용합니다. 계정이 없는 경우 다음 위치로 이동합니다. 시작 페이지 날짜 Braze 에 연결하려면 Braze Sales 계정 만들기 프로세스를 시작합니다.

API 보호 기능

확장은 다음 중 두 가지를 사용합니다. Braze의 API 및 제한 사항은 아래에 요약되어 있습니다.

API	비율 제한
User Track	분당 50,000개의 요청. 다음을 참조하십시오. User Track API 설명서 을 참조하십시오.
User Identify	분당 요청 20,000개. 다음을 참조하십시오. User Identify API 설명서 을 참조하십시오.

노트

다음 안내서를 참조하십시오. Braze API 제한 그들이 부과하는 한계에 대한 더 자세한 정보를 위해.

청구 가능 데이터 포인트

추가 사용자 지정 속성 보내기 Braze 을(를) 증가시킬 수 있습니다. Braze 데이터 포인트 사용량. 다음 항목에 문의 Braze 계정 관리자가 추가 사용자 지정 특성을 보내기 전에. 다음을 참조하십시오. Braze 설명서 청구 가능 데이터 포인트 추가 정보.

필요한 구성 세부 정보 수집

Edge Network를 Braze를 사용하려면 다음 입력이 필요합니다.

키 유형	설명	예
Braze 인스턴스	와 연결된 REST 엔드포인트 Braze 계정입니다. 다음을 참조하십시오. Braze 설명서 인스턴스 지침을 참조하십시오.	`https://rest.iad-03.braze.com`
API 키	다음 Braze 와 연결된 API 키 Braze 계정입니다. 다음을 참조하십시오. Braze 에 대한 설명서 REST API 키 지침을 참조하십시오.	`YOUR-BRAZE-REST-API-KEY`

보안 생성

새로 만들기 이벤트 전달 암호 값을 로 설정합니다. Braze API 키. 값을 안전하게 유지하면서 계정에 대한 연결을 인증하는 데 사용됩니다.

설치 및 구성 Braze 확장

확장을 설치하려면 이벤트 전달 속성 만들기 또는 편집할 기존 속성을 대신 선택하십시오.

선택 확장 왼쪽 탐색. 다음에서 카탈로그 탭, 선택 설치 카드 사용 Braze 확장명.

설치 Braze 확장명.

다음 화면에서 다음을 입력합니다 구성 값 이전에 수집한 항목 Braze:

브레이즈 나머지 끝점 URL: 의 값을 입력할 수 있습니다. Braze 제공된 입력에서 일반 텍스트로 나머지 끝점 URL입니다.
API 키: 다음을 선택합니다. 비밀 데이터 요소 을(를) 포함하는 이전에 만든 Braze API 키.

선택 저장 완료 시.

다음 Braze 확장 구성 페이지입니다.

만들기 Send Event 규칙

확장을 설치한 후 새 이벤트 전달을 만듭니다 규칙 원하는 대로 조건을 구성합니다. 규칙에 대한 작업을 구성할 때 다음을 선택합니다 브레이즈 확장을 선택한 다음 를 선택합니다 이벤트 보내기 작업 유형.

이벤트 전달 규칙 작업 구성을 추가합니다.

사용자 식별

입력	설명
외부 사용자 ID	길고 무작위적이며 잘 분산된 UUID 또는 GUID입니다. 사용자 ID의 이름을 지정하는 다른 방법을 선택하는 경우 길이도 길고 무작위적이며 잘 배포되어야 합니다. 자세히 알아보기 제안된 사용자 ID 명명 규칙.
사용자 ID 동기화	사용자 식별자를 브레이즈합니다.
사용자 별칭	별칭은 대체 고유 사용자 식별자 역할을 합니다. 별칭을 사용하여 코어 사용자 ID가 아닌 다른 차원의 사용자를 식별합니다. 사용자 별칭 객체는 식별자 자체에 대한 alias_name과 별칭 유형을 나타내는 alias_label의 두 부분으로 구성됩니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 하나의 alias_name만 가질 수 있습니다.

노트

이벤트를 사용자에게 연결하려면 다음 중 하나를 채워야 합니다. 외부 사용자 ID 필드 또는 사용자 식별자 동기화 필드 또는 사용자 별칭 섹션.

이벤트 데이터

입력	설명	필수 여부
이벤트 이름	이벤트 이름.	예
이벤트 시간	ISO 8601 또는 의 문자열로 표시된 날짜-시간 `yyyy-MM-dd'T'HH:mm:ss:SSSZ` 포맷.	예
앱 식별자	앱 식별자 또는 app_id 는 활동을 앱 그룹의 특정 앱과 연결하는 매개 변수입니다. 상호 작용 중인 앱 그룹 내의 앱을 지정합니다. 에 대해 자세히 알아보기 API 식별자 유형.
이벤트 속성	이벤트의 사용자 지정 속성이 포함된 JSON 개체입니다.

노트

다음 전송 이벤트 동기화 작업에는 다음만 필요합니다: 이벤트 이름 및 이벤트 시간 지정할 수 있지만 사용자 지정 속성 필드에 가능한 많은 정보를 포함해야 합니다. 에 대한 자세한 내용은 Braze 이벤트 개체를 참조하십시오. 공식 문서.

사용자 속성

사용자 속성은 지정된 사용자 프로필에서 제공된 이름 및 값으로 속성을 만들거나 업데이트하는 필드가 포함된 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(미국 및 캐나다)').
Facebook	ID(문자열), 좋아요(문자열 배열), num_friends(정수) 중 하나를 포함하는 해시.
Twitter	ID(정수), screen_name(문자열, Twitter 핸들), followers_count(정수), friends_count(정수), states_count(정수) 중 하나를 포함하는 해시입니다.

만들기 Send Purchase Event 규칙

확장을 설치한 후 새 이벤트 전달을 만듭니다 규칙 원하는 대로 조건을 구성합니다. 규칙에 대한 작업을 구성할 때 다음을 선택합니다 브레이즈 확장을 선택한 다음 를 선택합니다 구매 이벤트 보내기 작업 유형.

브레이즈 구매 작업 유형 이벤트 전달 규칙 작업 구성을 추가합니다.

사용자 식별

입력	설명
외부 사용자 ID	길고 무작위적이며 잘 분산된 UUID 또는 GUID입니다. 사용자 ID의 이름을 지정하는 다른 방법을 선택하는 경우 길이도 길고 무작위적이며 잘 배포되어야 합니다. 자세히 알아보기 제안된 사용자 ID 명명 규칙.
사용자 ID 동기화	사용자 식별자를 브레이즈합니다.
사용자 별칭	별칭은 대체 고유 사용자 식별자 역할을 합니다. 별칭을 사용하여 코어 사용자 ID가 아닌 다른 차원의 사용자를 식별합니다. 사용자 별칭 객체는 식별자 자체에 대한 alias_name과 별칭 유형을 나타내는 alias_label의 두 부분으로 구성됩니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 하나의 alias_name만 가질 수 있습니다.

노트

이벤트를 사용자에게 연결하려면 다음 중 하나를 완료해야 합니다. 외부 사용자 ID 필드, 사용자 식별자 동기화 필드 또는 사용자 별칭 섹션.

구매 데이터

입력	설명	필수 여부
제품 ID	구매용 식별자. (예: 제품 이름 또는 제품 범주)	예
구매 시간	ISO 8601 또는 의 문자열로 표시된 날짜-시간 `yyyy-MM-dd'T'HH:mm:ss:SSSZ` 포맷.	예
통화	의 문자열로 통화 표시 ISO 4217 알파벳 통화 코드 포맷.	예
가격	가격.	예
수량	제공하지 않은 경우 기본값은 1입니다. 최대값은 100보다 작아야 합니다.
앱 식별자	앱 식별자 또는 app_id 는 활동을 앱 그룹의 특정 앱과 연결하는 매개 변수입니다. 상호 작용 중인 앱 그룹 내의 앱을 지정합니다. 에 대해 자세히 알아보기 API 식별자 유형.
구매 속성	구매의 사용자 지정 속성을 포함하는 JSON 개체입니다.

노트

다음 전송 이벤트 동기화 작업에는 다음만 필요합니다: 이벤트 이름 및 이벤트 시간 지정할 수 있지만 사용자 지정 속성 필드에 가능한 많은 정보를 포함해야 합니다. 에 대한 자세한 내용은 Braze 이벤트 개체를 참조하십시오. 공식 문서.

사용자 속성

사용자 속성은 지정된 사용자 프로필에서 제공된 이름 및 값으로 속성을 만들거나 업데이트하는 필드가 포함된 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(미국 및 캐나다)').
Facebook	ID(문자열), 좋아요(문자열 배열), num_friends(정수) 중 하나를 포함하는 해시.
Twitter	ID(정수), screen_name(문자열, Twitter 핸들), followers_count(정수), friends_count(정수), states_count(정수) 중 하나를 포함하는 해시입니다.

내에서 데이터 유효성 검사 Braze

이벤트 컬렉션 및 Adobe Experience Platform 통합에 성공했습니다. 다음 내에서 이벤트가 표시됩니다. Braze 콘솔 시점 사용자 프로필 보기. 특히 로 전송되는 새 이벤트 데이터 Braze 다음에 반영됩니다. Purchases 특정 사용자의 섹션 개요 탭.

다음 단계

이 안내서에서는 전환 이벤트를에 보내는 방법을 다룹니다. Braze 이벤트 전달을 사용합니다. 로 전송된 이벤트 데이터의 다운스트림 애플리케이션에 대한 자세한 내용 Braze을(를) 참조하십시오. 공식 문서.

Experience Platform의 이벤트 전달 기능에 대한 자세한 내용은 이벤트 전달 개요.

이전 페이지