커스텀 이벤트의 중첩된 오브젝트

이 페이지에서는 중첩된 JSON 데이터를 커스텀 이벤트 및 구매의 등록정보로 전송하는 방법과 메시징에서 이러한 중첩된 오브젝트를 사용하는 방법에 대해 설명합니다.

중첩 오브젝트(다른 오브젝트 안에 있는 오브젝트)를 사용하여 중첩된 JSON 데이터를 커스텀 이벤트 및 구매의 등록정보로 전송할 수 있습니다. 이 중첩된 데이터는 메시지에서 개인화된 정보를 템플릿화하고, 메시지 전송을 트리거하고, 사용자를 세분화하는 데 사용할 수 있습니다.

고려 사항

• 중첩 데이터는 커스텀 이벤트와 구매 이벤트 모두 지원되지만, 다른 이벤트 유형에는 지원되지 않습니다.
• 배열 또는 객체 값을 포함하는 이벤트 속성정보 객체의 이벤트 속성정보 페이로드는 최대 100KB까지 가능합니다.
• 구매 이벤트에 대해서는 이벤트 속성정보 스키마를 생성할 수 없습니다.
• 이벤트 속성정보 스키마는 지난 24시간 동안의 커스텀 이벤트를 샘플링하여 생성됩니다.

최소 SDK 버전

다음 SDK 버전은 중첩 객체를 지원합니다:

1단계: 스키마 생성

중첩된 이벤트 속성정보가 포함된 각 이벤트에 대해 스키마를 생성하여 커스텀 이벤트의 중첩 데이터에 접근할 수 있습니다. 스키마를 생성하려면 다음을 수행합니다:

1. 데이터 설정 > 커스텀 이벤트로 이동합니다.
2. 중첩된 속성정보가 있는 이벤트에 대해 속성정보 관리를 선택합니다.
3. 버튼을 선택하여 스키마를 생성합니다. 스키마를 보려면 플러스 버튼을 선택합니다.

향후 새로운 속성정보가 전송되더라도 스키마가 다시 생성되기 전까지는 스키마에 반영되지 않습니다. 스키마는 24시간마다 다시 생성할 수 있습니다.

2단계: 중첩 객체 사용하기

세분화 및 개인화 중에 중첩된 데이터를 참조할 수 있습니다. 스키마는 필수가 아닙니다. 사용 예시는 다음 섹션을 참조하세요:

• API 요청 본문
• Liquid 템플릿
• 메시지 트리거
• 세분화
• 개인화

API 요청 본문

• 음악 예시
• 레스토랑 예시

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

...
"properties": {
  "songs": [
    {
      "title": "Smells Like Teen Spirit",
      "artist": "Nirvana",
      "album": {
        "name": "Nevermind",
        "yearReleased": "1991"
      }
    },
    {
      "title": "While My Guitar Gently Weeps",
      "artist": "the Beatles",
      "album": {
        "name": "The Beatles",
        "yearReleased": "1968"
      }
    }
  ]
}
...

1
2
3
4
5
6
7
8
9
10
11
12

...
"properties": {
  "r_details": {
    "name": "SandwichEmperor",
    "identifier": "12345678",
    "location" : {
      "city": "Montclair",
      "state": "NJ"
    }
  }
}
...

참고

중첩된 커스텀 이벤트 속성정보의 경우, 연도 값이 0 미만이거나 3000 초과이면 Braze는 해당 값을 사용자에게 저장하지 않습니다.

Liquid 템플릿

다음은 이전 API 요청에서 요청한 중첩된 속성정보를 참조하는 Liquid 템플릿을 만드는 방법을 보여줍니다.

• 음악 예시
• 레스토랑 예시

메시지 트리거

이러한 속성정보를 사용하여 Campaign 또는 Canvas를 트리거하려면, 커스텀 이벤트 또는 구매를 선택한 다음 중첩 속성정보 필터를 추가합니다. Place Order 및 Update Cart 이커머스 트리거는 동일한 필터 유형을 지원합니다.

중요

중첩 속성정보 필터는 인앱 메시지 트리거에 지원되지 않습니다. 인앱 메시지에서 Liquid 개인화를 위해 중첩된 속성정보를 사용하는 것은 여전히 가능합니다.

최상위 수준(기본) 이벤트 속성정보 필터(배열 유형 속성정보 포함)는 인앱 메시지를 트리거하는 데 사용할 수 있습니다. 이러한 필터는 중첩 속성정보 필터와 별개입니다.

• 음악 예시
• 레스토랑 예시

“Created Playlist” 이벤트의 중첩된 속성정보로 Campaign을 트리거하는 예시:

트리거 조건 songs[].album.yearReleased “is” “1968”은 노래 중 하나라도 1968년에 출시된 앨범이 있는 이벤트와 일치합니다. 배열을 순회할 때 대괄호 표기법 []을 사용하며, 순회된 배열의 항목 중 하나라도 이벤트 속성정보와 일치하면 매칭됩니다.

중요

같지 않음 필터는 배열의 속성정보 중 제공된 값과 일치하는 항목이 하나도 없는 경우에만 매칭됩니다.

예를 들어, Canvas A에는 액션 기반 커스텀 이벤트 중첩 속성정보 필터 같음 “smartwatch”가 있고, Canvas B에는 액션 기반 커스텀 이벤트 중첩 속성정보 필터 같지 않음 “simphone”이 있다고 가정합니다. 속성정보에 “smartwatch”와 “simphone”이 모두 있으면 두 Canvases가 모두 트리거됩니다. 하지만 속성정보에 “simphone” 또는 “sim only”가 있으면 어느 Canvas도 트리거되지 않습니다.

“Ordered” 이벤트의 중첩된 속성정보로 Campaign을 트리거하는 예시:

r_details.name: “SandwichEmperor”
r_details.location.city: “Montclair”

참고

이벤트 속성정보에 [] 또는 . 문자가 포함된 경우, 해당 부분을 큰따옴표로 감싸서 이스케이프하세요. 예를 들어, "songs[].album".yearReleased는 리터럴 속성정보 "songs[].album"이 포함된 이벤트와 일치합니다.

세분화

중첩된 이벤트 속성정보를 기반으로 사용자를 세분화하려면 세그먼트 확장을 사용해야 합니다. 스키마를 생성한 후, 중첩 객체 탐색기가 세분화 섹션에 표시됩니다.

세분화는 트리거와 동일한 표기법을 사용합니다(메시지 트리거 참조).

세그먼트 확장을 편집하거나 생성하려면 “Edit Segments” 권한이 필요합니다.

개인화

개인화 추가 모달을 사용하여 개인화 유형으로 고급 이벤트 속성정보를 선택합니다. 이를 통해 스키마가 생성된 후 중첩된 이벤트 속성정보를 추가할 수 있습니다.

메시지에서 중첩된 객체 테스트하기

대시보드의 미리보기 및 테스트 도구는 중첩된 객체 또는 중첩 커스텀 속성에 대한 모의 데이터 추가를 지원하지 않습니다. Liquid를 통해 중첩 데이터를 참조하는 메시지를 테스트하려면, 해당 중첩 속성을 가진 기존 사용자로 메시지를 미리 볼 수 있으며, 커스텀 이벤트 속성정보가 포함된 메시지는 테스트 사용자에게 실시간 Campaign을 발송하여 미리 볼 수 있습니다.

중첩 커스텀 속성

1. API를 통해 테스트 사용자 프로필에 중첩 속성을 가져옵니다.
2. Campaign 또는 Canvas에서 미리보기 및 테스트로 이동합니다.
3. 사용자로 미리보기를 선택하고 테스트 사용자를 검색합니다. Liquid는 해당 사용자 프로필의 실제 중첩 속성을 사용하여 렌더링됩니다.

중첩된 이벤트 속성정보

중첩된 이벤트 속성정보는 실시간 이벤트 트리거가 필요하기 때문에 대시보드에서 미리 볼 수 없습니다. 테스트하려면 다음과 같이 합니다:

1. 테스트 사용자만 타겟팅하고 중첩된 속성정보가 포함된 커스텀 이벤트에 의해 트리거되거나 해당 이벤트를 참조하는 Campaign 또는 캔버스 단계를 생성합니다.
2. 테스트 오디언스에게 Campaign을 발송합니다.
3. API 또는 SDK를 사용하여 테스트 사용자 프로필에 중첩된 객체 페이로드가 포함된 커스텀 이벤트를 기록합니다.
4. 중첩된 속성정보 값으로 메시지가 올바르게 렌더링되는지 확인합니다.

자주 묻는 질문

중첩된 객체를 사용하면 추가 데이터 포인트가 기록되나요?

이 기능을 추가해도 데이터 포인트 기록 방식에는 변화가 없습니다. 중첩된 객체를 기반으로 한 세분화는 세그먼트 확장을 사용하며, 이는 추가 데이터 포인트를 사용하지 않습니다.

얼마나 많은 중첩 데이터를 전송할 수 있나요?

이벤트의 속성정보 중 하나 이상이 중첩 데이터를 포함하는 경우, 이벤트에 포함된 모든 속성정보의 최대 페이로드 크기는 100KB입니다. 이 크기 제한을 초과하는 요청은 거부됩니다.