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

이 페이지에서는 중첩된 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을 트리거하려면 커스텀 이벤트 또는 구매를 선택한 다음, 중첩 속성정보 필터를 추가합니다. 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입니다. 이 크기 제한을 초과하는 요청은 거부됩니다.