사용자 지정 개체 시작하기
학습 내용
객체를 설정하는 방법과 Klaviyo 에서 객체를 사용하는 방법 등 사용자 지정 객체에 대해 알아보세요.
시작하기 전에 알아야 할 것시작하기 전에 알아야 할 것
이 기능을 사용하려면 사용자 지정 개체에 대한 액세스 권한이 있어야 합니다.
사용자 지정 개체란 무엇인가요?사용자 지정 개체란 무엇인가요?
사용자 지정 개체는 프로필 속성을 사용하여 저장할 수 없는 다양한 다중 관계형 데이터 개념을 Klaviyo 에 매핑할 수 있도록 활성화하는 Klaviyo 의 데이터 구조 유형입니다. 예를 들어 고객의 반려동물에 대한 데이터를 Klaviyo 에 저장하려고 한다고 가정해 보겠습니다. 각 애완동물에는 이름, 나이, 품종 등 여러 가지 속성이 있습니다. 등) 프로필에 여러 개의 반려동물이 있는 경우 프로필 속성으로 이 정보를 저장하기가 어렵습니다.
그런 다음 이 개체 데이터를 플로우, 템플릿 및 세그먼트( Klaviyo )에서 사용하여 마케팅을 더욱 맞춤화할 수 있습니다.
사용 사례 예시사용 사례 예시
다음은 Klaviyo 에 저장할 수 있는 데이터에서 사용자 지정 개체가 얼마나 유연한지 보여주는 몇 가지 예입니다.
약속약속
고객이 약속을 예약할 수 있는 비즈니스인 경우에는 약속 개체를 사용하여 프로필에 대한 약속 데이터를 저장할 수 있습니다.
약속 개체에 대한 각 개체 레코드 내에 포함할 수 있는 데이터의 몇 가지 예는 다음과 같습니다:
- 약속 ID
- 예약 날짜
- 예약 담당자(예: 특정 의사, 강사 등)
- 약속 장소
- 약속 유형
프로필에 여러 약속이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지 및 플로우를 보낼 수 있습니다.
구독구독
고객이 구독을 신청할 수 있는 비즈니스인 경우 구독 개체를 사용하여 프로필에 대한 구독 데이터를 저장할 수 있습니다.
구독 개체에 대한 각 개체 레코드 내에 포함할 수 있는 데이터의 몇 가지 예는 다음과 같습니다:
- 구독 ID
- 구독 제품
- 구독 가격
- 구독 상태
- 다음 청구 날짜
프로필에 여러 개의 구독이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지 및 플로우를 보낼 수 있습니다.
예약예약
고객이 예약을 할 수 있는 비즈니스인 경우 예약 개체를 사용하여 프로필에 대한 예약 데이터를 저장할 수 있습니다.
예약 개체에 대한 각 개체 레코드에는 다음과 같은 데이터가 포함될 수 있습니다:
- 예약 ID
- 예약 날짜
- 예약 위치
- 예약 행사
- 예약 게스트 수
프로필에 여러 개의 예약이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지와 플로우를 보낼 수 있습니다.
애완동물애완동물
반려동물 소유자에게 서비스를 제공하는 비즈니스인 경우 반려동물 개체를 사용하여 프로필의 반려동물에 대한 데이터를 저장할 수 있습니다.
애완동물 개체에 대한 각 개체 레코드에는 다음과 같은 데이터가 포함될 수 있습니다:
- 반려동물 마이크로칩 ID
- 애완동물 이름
- 반려동물 유형(예: 개 또는 고양이)
- 반려동물 품종
- 반려동물 생일
프로필에 여러 개의 반려동물이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지와 플로우를 보낼 수 있습니다.
계정 한도계정 한도
계정의 객체 한도는 계정의 프로필 한도와 클라비요 고급 데이터 플랫폼 요금제 가입 여부에 따라 달라집니다. 이 기능을 사용하려면 최소한 유료 이메일 요금제 또는 클라비요 고급 데이터 플랫폼 평가판이 필요하며, CSM을 통해 요청할 수 있습니다. 계정 패밀리 내에서 활동하는 경우, 한도에는 클라비요 고급 데이터 플랫폼 요금제의 한도가 반영됩니다. 청구에 대한 자세한 내용은 Klaviyo에서 공유 청구의 작동 방식을 참조하세요.
사용자 지정 개체에는 3가지 계정 한도 세트가 있습니다:
-
개체 제한
한 계정이 보유할 수 있는 총 개체 수입니다. - 개체 속성 제한
한 계정이 개체당 가질 수 있는 속성 수입니다. -
개체 레코드 제한
계정에 허용되는 개체 레코드 수입니다.
사용 가능한 개체 및 개체 레코드 수는 모든 계정의 총 활성 프로필 수를 기준으로 합니다. 레코드 한도는 모든 계정에서 공유되는 반면, 개체 한도는 각 계정에 개별적으로 적용됩니다.
예를 들어 각 계정에 100,000개의 활성 프로필이 있는 5개의 하위 계정이 있는 계정 패밀리가 있는 경우 총 활성 프로필은 500,000개입니다. 아래 차트에서 볼 수 있듯이 프로필이 40만 개가 넘는 계정은 개체 레코드 배수가 10입니다. 따라서 이러한 계정은 최대 500만 개(500,000개 x 10)의 레코드를 합쳐서 최대 500만 개까지 저장할 수 있습니다. 즉, 나머지 4개 계정의 개체 레코드를 합쳐서 200만 개 미만인 경우 하나의 계정에 300만 개의 레코드가 있을 수 있습니다. 계정당 개체 수는 총 프로필 수가 40만 개가 넘기 때문에 각 계정당 최대 5개까지 개체를 보유할 수 있습니다.
클라비요 고급 데이터 플랫폼 요금제를 사용 중인 경우, 객체 기록 배수는 계정의 총 프로필 수를 기준으로 합니다. 이메일 요금제만 사용하는 경우 이 배율은 계정의 활성 프로필 한도를 기준으로 합니다.
| 프로필 | 클라비요 고급 데이터 플랫폼 요금제 | 개체 수 | 개체 속성 수 | 객체 레코드 승수 |
| 무료 요금제 | 없음 | 0 | 0 | N/A |
| 250 - 400,000 | 없음 | 1 | 15 | 10x |
| 유료 | 5 | 30 | 10x | |
| 400,000명 이상 | 없음 | 10x | ||
| 유료 | 10x |
또한 모든 계정에는 다음과 같은 한도가 있습니다:
- 객체당 프로필당 최대 500개의 레코드가 있습니다.
- 모든 사용자 지정 개체는 8KB를 넘지 않아야 합니다.
- 모든 사용자 지정 개체 레코드는 2KB를 넘지 않아야 합니다.
개체 만들기
Klaviyo 에서 객체 생성을 시작하려면 콘텐츠 > 객체로 이동합니다.
다음 단계에 따라 사용자 지정 개체에 대한 데이터 소스를 만들고 동기화합니다. 이 단계가 완료되면 사용자 지정 개체 만들기 버튼을 선택하여 개체를 만듭니다.
여기에서 개체를 처음부터 새로 만들거나 권장 개체 템플릿을 선택할 수 있습니다. 개체를 처음부터 새로 만들려면 나만의 개체 만들기 버튼을 선택합니다.
객체 생성 워크플로우의 첫 번째 부분에서는 객체에 대해 다음 정보를 설정해야 합니다:
-
이름
개체를 식별하는 이름입니다. - 설명 (선택 사항)
개체가 나타내는 데이터에 대한 설명입니다. - 데이터 소스
개체 데이터를 가져올 데이터 소스입니다. 드롭다운에 옵션으로 표시되려면 사용자 지정 개체 API 를 사용하여 로 레코드 1개 이상을 전송해야 합니다.Klaviyo
개체 ID 설정
개체의 이름을 설정하고 데이터 소스를 선택했다면 다음 단계는 개체 ID를 설정하고 원하는 개체 속성을 매핑하는 것입니다. 이 단계에서는 사용자 지정 개체 API 를 통해 로 전송된 데이터 소스와 연결된 데이터를 미리 볼 수 Klaviyo 있습니다.
개체 레코드를 서로 구별하려면 개체 ID를 설정해야 합니다. 고유 개체 ID에 사용할 데이터 소스 속성을 지정해야 합니다.
객체 ID는 객체 기록의 특정 인스턴스를 식별하기 위해 사용할 수 있는 고유한 데이터 소스 속성입니다. 예를 들어, 기프트 카드 객체의 경우 고유 할인 코드를 객체 ID로 사용할 수 있습니다. 이 값은 데이터 소스의 각 인스턴스에 고유하며, 모든 객체 기록에 존재합니다.
Klaviyo 이 데이터 소스에서 동일한 개체 ID를 가진 데이터를 수신할 때마다 연결된 개체 레코드가 업데이트됩니다. 따라서 적절한 레코드가 업데이트되도록 개체 ID를 고유하게 설정하는 것이 중요합니다.
개체 데이터 보내기개체 데이터 보내기
기존 객체 레코드를 업데이트하면 전체 객체가 교체됩니다. 따라서 하나의 레코드만 업데이트하려는 경우에도 매번 전체 개체를 전송하는 것이 중요합니다.
예를 들어 개체의 레코드 5개 중 1개만 업데이트하고 싶다고 가정해 보겠습니다. ID와 업데이트하려는 레코드 1개만 포함된 업데이트 데이터를 전송하면 나머지 4개의 레코드는 null로 설정됩니다. 프로필 관계에 새로 null 필드 중 하나가 사용되었다면(예: 이메일 주소와 같은 프로필 식별자) 해당 개체는 더 이상 해당 프로필과 연결되지 않습니다.
맵 개체 속성맵 개체 속성
개체 속성을 매핑하여 데이터 소스 내에서 Klaviyo 에서 개체 내에서 사용할 수 있는 정보를 선택할 수 있습니다.
미리 보기 중인 데이터 원본의 특정 인스턴스에 표시된 데이터만 드롭다운에서 사용할 수 있습니다. 새 데이터 샘플 버튼을 사용하여 데이터 원본의 인스턴스를 순환할 수 있습니다.
그러나 이러한 이유로 개체 수집 API를 통해 표준화된 형식으로 개체 데이터를 전송하는 것이 좋습니다. 특정 속성의 값을 알 수 없는 경우 해당 속성에 대해 null 값을 설정할 수 있습니다.
개체 속성을 매핑합니다:
- 데이터 소스 속성 열에서 개체에 포함할 데이터 소스 속성을 선택합니다.
- 매핑된 속성 열에 데이터 소스 속성이 개체에 갖도록 할 이름을 입력합니다.
- 데이터 유형 열에서 데이터 소스 속성의 적절한 데이터 유형을 선택합니다.
- 개체에서 이 속성을 필수로 설정하려면 필수 열에서 확인란을 선택합니다.
- 추가 객체 속성을 매핑해야 하는 경우 매핑 추가 버튼을 선택합니다.
개체 속성이 필수로 설정된 경우 데이터 원본에 존재해야 하며 null 값을 설정할 수 없습니다. 필수 속성이 없으면 개체 레코드가 생성되지 않습니다.
매핑의 중첩된 데이터
기본적으로 개체 관리자 인터페이스는 1단계 중첩을 지원합니다. 더 심층적인 데이터에 액세스하려면 원하는 경로를 수동으로 입력해야 합니다.
예를 들어 아래 데이터 소스를 살펴보세요.
{
"type": "데이터-source-record",
"attributes": {
"기록": {
"자식": {
"자식_ID": "d64b8458",
"이름": {
"first": "Theodore",
"last": "Customer"
},
"생년월일": "2022-04-12",
"이메일": "jon.customer@klaviyo.com",
"전화번호": [
"+11234567899",
"+13456789123"
]
}
}
}
}
관계 추가
개체 ID를 설정하고 개체 속성을 매핑한 후 다음 단계는 개체에 관계를 추가하는 것입니다.
관계는 개체를 관련 프로필에 연결합니다. 다음 정보를 정의하여 관계를 설정합니다:
-
관계 이름
관계의 이름을 설정합니다. 예를 들어 애완동물 개체가 있는 경우 관계 이름을 '애완동물 소유자'와 같은 이름으로 설정할 수 있습니다. -
소스 데이터
프로필과 연결하려는 데이터 소스 속성을 선택합니다. -
프로필 식별자
프로필 식별자 (예: 이메일, 전화번호 등)를 설정합니다. 프로필과 연결할 객체의 데이터 소스에 이 식별자가 포함되어 있어야 합니다. 다른 속성 연결 버튼을 사용하여 추가 속성 및 식별자 쌍을 추가합니다.
매핑 확인 및 개체 생성
개체 속성 매핑 및 관계 설정을 완료했으면 확인 모달에서 매핑을 확인하고 개체 만들기 버튼을 선택합니다. 개체가 생성되면 기존 매핑은 편집할 수 없으며, 데이터는 즉시 동기화가 시작됩니다.
다음 정보와 함께 의 객체 페이지에 객체가 나열됩니다:Klaviyo
- 개체 이름
- 생성 날짜
- 마지막 업데이트 날짜
- 상태
사용자 지정 개체 상태 상태
사용자 지정 개체를 게시할 때는 세 가지 상태가 있습니다:
-
초안
이 개체는 아직 편집 가능하며 게시되거나 활성화되지 않았습니다. -
게시
개체가 데이터 소스로 전송한 데이터에서 사용자 지정 개체 레코드를 만들고 있습니다. 데이터 소스에서 수천 개의 레코드를 전송한 경우 개체가 즉시 게시됩니다. 수백만 개의 레코드를 전송한 경우에는 게시하는 데 몇 시간이 걸릴 수 있습니다. 완료되면 상태가 활성으로 변경됩니다. -
활성
개체가 게시되어 라이브 상태입니다. 데이터 소스에서 전송된 데이터에 따라 모든 사용자 지정 개체 레코드가 생성되었습니다. 이 개체에 대한 새 데이터가 전송되면 프로필에 연결된 추가 사용자 지정 개체 레코드가 생성됩니다.
프로필 페이지의 개체
프로필 페이지에도 관련 개체가 표시되므로 프로필과 관련된 개체 레코드를 볼 수 있습니다. 개체 레코드를 보려면 프로필 페이지의 개체 탭으로 이동합니다. 개체 카드 위의 드롭다운 메뉴를 사용하여 개체 간에 전환할 수 있습니다.
전체 개체 레코드를 보려면 점 3개 메뉴를 선택하고 보기를 클릭합니다. 전체 개체 레코드가 포함된 사이드 패널이 나타납니다.
개체 업데이트개체 업데이트
사용자 지정 개체를 변경하면 활성 사용자 지정 개체도 변경됩니다.
개체에 대한 새 데이터 전송을 시작하려면 데이터 소스에 추가 개체 속성을 추가한 다음 이 새 속성을 포함하도록 개체 매핑을 편집합니다. 이전에 생성된 모든 객체는 해당 데이터를 사용할 수 없으므로 이 속성에 대해 null을 반환하지만 앞으로는 이 속성을 사용하여 객체를 생성하고 업데이트합니다.
아직 객체에 매핑되지 않은 새 객체 속성을 전송하는 경우 사용자 지정 객체를 업데이트하여 해당 속성을 포함할 수 있습니다. 그런 다음 모든 사용자 지정 개체 레코드가 이 데이터를 포함하도록 재처리됩니다.
개체를 업데이트하려면
- 사이드바에서 콘텐츠 > 개체를 클릭합니다. Klaviyo
- 편집하려는 개체의 이름을 선택합니다.
- 오른쪽 상단 모서리에 있는 다음을 클릭합니다.
-
맵 객체 속성 섹션에서 매핑 추가를 클릭합니다.
이 옵션은 개체에 추가할 수 있는 추가 속성이 있는 경우에만 사용할 수 있습니다.
- 데이터 소스 속성 열에서 개체에 포함할 데이터 소스 속성을 선택합니다.
- 매핑된 속성 열에 데이터 소스 속성이 개체에 갖도록 할 이름을 입력합니다.
-
데이터 유형 열에서 데이터 소스 속성의 적절한 데이터 유형을 선택합니다.
새로 매핑된 속성은 필수로 표시할 수 없습니다.
- 오른쪽 상단 모서리에 있는 다음을 클릭합니다.
- 오른쪽 상단 모서리에 있는 다음을 클릭합니다. 관계를 변경할 필요가 없습니다.
- 변경 사항 게시를 클릭합니다.
이 프로세스를 완료하면 데이터 소스의 모든 레코드가 재처리되고 기존 사용자 지정 개체 레코드가 그에 따라 업데이트됩니다.
개체 삭제개체 삭제
개체를 삭제한 후에는 검색하거나 되돌릴 수 없습니다. 이러한 사용자 지정 개체를 사용한 모든 세그먼트, 플로우, 템플릿 또는 캠페인은 더 이상 의도한 대로 작동하지 않습니다.
개체를 삭제하려면
- 사이드바에서 콘텐츠 > 개체를 클릭합니다. Klaviyo
- 개체 오른쪽에 있는 메뉴에서 삭제를 클릭합니다.
- 삭제를 다시 클릭하여 개체 제거를 확인합니다.
- 개체 및 연결된 모든 사용자 지정 개체 레코드가 삭제됩니다.
이전 객체의 데이터 소스를 사용하여 새 사용자 지정 객체를 만들면 이미 동기화한 데이터를 사용하여 새 사용자 지정 객체 레코드가 생성됩니다. 동일한 데이터를 사용하지만 새 레코드가 있는 새 개체로 간주되므로 이 새 개체를 사용하려면 모든 세그먼트, 플로우, 템플릿 및 캠페인을 업데이트해야 합니다.
추가 자료