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

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

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

고려 사항

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

최소 SDK 버전

다음 SDK 버전에서 중첩 오브젝트를 지원합니다:

1단계: 스키마 생성

커스텀 이벤트에서 중첩 데이터에 접근하려면 중첩 이벤트 속성정보가 있는 각 이벤트에 대해 스키마를 생성해야 합니다. 스키마를 생성하려면:

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

향후 새로운 등록정보가 전송되면 스키마가 재생성될 때까지 스키마에 포함되지 않습니다. 스키마는 24시간마다 재생성할 수 있습니다.

2단계: 중첩 오브젝트 사용

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

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

API 요청 본문

• music example
• restaurant example

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"
    }
  }
}
...

Liquid 템플릿

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

• music example
• restaurant example

메시지 트리거

이러한 등록정보를 사용하여 캠페인을 트리거하려면 커스텀 이벤트 또는 구매를 선택한 다음 중첩 등록정보 필터를 추가합니다. 인앱 메시지에서는 메시지 트리거가 아직 지원되지 않지만, 메시지 내 Liquid 개인화의 중첩 등록정보는 여전히 표시됩니다.

• music example
• restaurant example

세분화

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

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

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

개인화

개인화 추가 모달을 사용하여 개인화 유형으로 고급 이벤트 등록정보를 선택합니다. 이렇게 하면 스키마가 생성된 후 중첩 이벤트 등록정보를 추가할 수 있는 옵션이 제공됩니다.

메시지에서 중첩 오브젝트 테스트

대시보드의 미리보기 및 테스트 도구는 중첩 오브젝트 또는 중첩 커스텀 속성에 대한 모의 데이터 추가를 지원하지 않습니다. Liquid를 통해 중첩 데이터를 참조하는 메시지를 테스트하려면, 해당 중첩 속성이 있는 기존 사용자로 메시지를 미리 보거나, 테스트 사용자에게 라이브 캠페인을 실행하여 커스텀 이벤트 등록정보가 포함된 메시지를 미리 볼 수 있습니다.

중첩 커스텀 속성

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

중첩 이벤트 등록정보

중첩 이벤트 등록정보는 라이브 이벤트 트리거가 필요하므로 대시보드에서 미리 볼 수 없습니다. 테스트하려면:

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

자주 묻는 질문

중첩 오브젝트를 사용하면 추가 데이터 포인트가 기록되나요?

이 기능을 추가함으로써 데이터 포인트를 기록하는 방식에는 변경이 없습니다. 중첩 오브젝트를 기반으로 한 세분화는 세그먼트 확장을 사용하며, 추가 데이터 포인트를 사용하지 않습니다.

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

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