Skip to content

이벤트 객체

이 문서에서는 이벤트 객체의 다양한 구성요소, 이 객체를 사용하는 방법 및 참고할 수 있는 예제에 대해 설명합니다.

이벤트 객체란 무엇인가요?

이벤트 객체는 특정 이벤트가 발생할 때 API를 통해 전달되는 객체입니다. 이벤트 객체는 이벤트 배열에 포함됩니다. 이벤트 배열의 각 이벤트 객체는 특정 사용자가 지정된 시간 값에 수행한 커스텀 이벤트의 단일 발생을 나타냅니다. 이벤트 객체에는 다양한 필드가 있어 메시지, 데이터 수집, 개인화에서 이벤트 속성정보를 설정하고 사용하여 커스터마이즈할 수 있습니다.

특정 플랫폼에 대한 커스텀 이벤트 설정 방법은 개발자 가이드의 플랫폼 통합 가이드를 참조하세요. 플랫폼에 따라 관련 문서를 참조하세요:

객체 본문

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

{
  // One of "external_id" or "user_alias" or "braze_id" or "email" or "phone" is required
  "external_id" : (optional, string) External user ID,
  "user_alias" : (optional, User Alias Object) User alias object,
  "braze_id" : (optional, string) Braze user identifier,
  "email": (optional, string) User email address,
  "phone": (optional, string) User phone number,
  "app_id" : (optional, string) see App Identifier,
  "name" : (required, string) the name of the event,
  "time" : (required, datetime as string in ISO 8601 or in `yyyy-MM-dd'T'HH:mm:ss:SSSZ` format),
  "properties" : (optional, Properties Object) properties of the event
  // Setting this flag to true will put the API in "Update Only" mode.
  // When using a "user_alias", "Update Only" mode is always true.
  "_update_existing_only" : (optional, boolean)
  // See following notes regarding anonymous push token imports
}

기존 프로필만 업데이트

Braze에서 기존 고객 프로필만 업데이트하려면 요청 본문에 _update_existing_only 키를 true 값으로 전달해야 합니다. 이 값을 생략하면 external_id가 아직 존재하지 않는 경우 Braze가 새 고객 프로필을 생성합니다.

이벤트 속성정보 객체

커스텀 이벤트와 구매에는 이벤트 속성정보가 포함될 수 있습니다. “properties” 값은 키가 속성정보 이름이고 값이 속성정보 값인 객체여야 합니다. 속성정보 이름은 255자 이하의 비어 있지 않은 문자열이어야 하며, 앞에 달러 기호($)가 올 수 없습니다.

속성정보 값은 다음 데이터 유형 중 하나일 수 있습니다:

데이터 유형 설명
숫자 정수 또는 플로트
불리언 true 또는 false
날짜/시간 ISO 8601 형식의 문자열이거나 다음 형식 중 하나여야 합니다:
- yyyy-MM-ddTHH:mm:ss:SSSZ
- yyyy-MM-ddTHH:mm:ss
- yyyy-MM-dd HH:mm:ss
- yyyy-MM-dd
- MM/dd/yyyy
- ddd MM dd HH:mm:ss.TZD YYYY

배열 내에서는 지원되지 않습니다.

참고: “T”는 시간 지정자이며 입력 안내가 아니므로 변경하거나 제거하면 안 됩니다.

시간대가 없는 시간 속성은 기본적으로 자정 UTC로 설정됩니다(대시보드에서는 회사 시간대의 자정 UTC에 해당하는 값으로 표시됩니다).

미래 타임스탬프가 있는 이벤트는 기본적으로 현재 시간으로 설정됩니다.
문자열 255자 이하.
배열 배열에는 날짜/시간을 포함할 수 없습니다.
객체 객체는 문자열로 수집됩니다.

배열 또는 객체 값을 포함하는 이벤트 속성정보 객체의 이벤트 속성정보 페이로드는 최대 100 KB까지 가능합니다.

예약 키

다음 키는 예약되어 있으며 커스텀 이벤트 속성정보로 사용할 수 없습니다:

  • time
  • event_name

이벤트 속성정보 지속성

이벤트 속성정보는 상위 이벤트에 의해 트리거된 메시지의 필터링 및 Liquid 개인화를 위해 설계되었습니다. 기본적으로 Braze 사용자 프로필에 지속적으로 저장되지 않습니다. 세분화에서 이벤트 속성정보 값을 사용하려면 이벤트 속성정보 값을 장기적으로 저장하는 다양한 접근 방식을 설명하는 커스텀 이벤트를 참조하세요.

이벤트 예시 요청

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "events" : [
    {
      "external_id" : "user1",
      "app_id" : "your-app-id",
      "name" : "watched_trailer",
      "time" : "2013-07-16T19:20:30+01:00"
    },
    {
      "external_id" : "user1",
      "app_id" : "your-app-id",
      "name" : "rented_movie",
      "time" : "2013-07-16T19:20:45+01:00",
      "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
      }
    },
    {
      "user_alias" : { "alias_name" : "device123", "alias_label" : "my_device_identifier"},
      "app_id" : "your-app-id",
      "name" : "watched_trailer",
      "time" : "2013-07-16T19:20:50+01:00"
    }
  ]
}

이벤트 오브젝트

제공된 예시를 통해 누군가가 최근 예고편을 시청한 후 영화를 대여한 것을 확인할 수 있습니다. Campaign에 들어가서 이러한 속성정보를 기반으로 사용자를 세분화할 수는 없지만, 이러한 속성정보를 영수증 형태로 활용하여 Liquid를 사용해 채널을 통해 커스텀 메시지를 보내는 데 전략적으로 사용할 수 있습니다. 예를 들어, “안녕하세요 Alex, Alex Smith 감독의 The Sad Egg를 대여해 주셔서 감사합니다. 대여 내역을 기반으로 추천 영화를 알려드립니다…“와 같이 보낼 수 있습니다.
New Stuff!