사용자 지정 개체 시작하기

여러 속성을 하나의 "개체에 저장하고 연결할 수 있는 사용자 지정 개체에 대해 알아보세요."  사용자 지정 개체를 사용하면 프로필 속성을 사용하여 저장할 수 없는 다양한 다중 관계형 데이터 개념을 Klaviyo 에 매핑할 수 있습니다. 그런 다음 메시지, 세그먼트 등에서 사용자 지정 개체를 사용할 수 있습니다. 

사용자 지정 개체는 프로필 속성과 어떻게 다른가요? 

프로필 속성은 간단한 정보를 저장할 수 있는 좋은 방법입니다. 예를 들어, 즐겨찾는 색상 속성이 있는 경우 각 고객이 즐겨찾는 색상을 저장할 수 있습니다. 

하지만 더 많은 데이터나 해당 속성의 여러 버전이 필요하다면 어떻게 해야 할까요? 반려동물을 위한 좋은 예입니다. 프로필 속성을 사용하여 이름, 나이, 품종 등을 저장할 수 있지만 프로필당 한 번만 사용할 수 있습니다.

반려동물이 여러 마리인 경우 사용자 지정 개체를 대신 사용할 수 있습니다. 이렇게 하면 그레이트 데인 플러피는 이름, 나이, 몸무게 등이 적힌 디지털 신분증을, 햄스터 치크스는 같은 정보를 가지고 있지만 (매우) 다른 답변을 얻을 수 있습니다.  

사용 사례 예시

다음은 Klaviyo 에 저장할 수 있는 데이터에서 사용자 지정 개체가 얼마나 유연한지 보여주는 몇 가지 예입니다. 

약속

고객이 약속을 예약할 수 있는 비즈니스인 경우에는 약속 개체를 사용하여 프로필에 대한 약속 데이터를 저장할 수 있습니다.  

약속 개체에 대한 각 개체 레코드 내에 포함할 수 있는 데이터의 몇 가지 예는 다음과 같습니다:

• 약속 ID 
• 예약 날짜
• 예약 담당자(예: 특정 의사, 강사 등)
• 약속 장소
• 약속 유형 

프로필에 여러 약속이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지 및 플로우를 보낼 수 있습니다. 

구독 

고객이 구독을 신청할 수 있는 비즈니스인 경우 구독 개체를 사용하여 프로필에 대한 구독 데이터를 저장할 수 있습니다.  

구독 개체에 대한 각 개체 레코드 내에 포함할 수 있는 데이터의 몇 가지 예는 다음과 같습니다:

• 구독 ID 
• 구독 제품
• 구독 가격
• 구독 상태 
• 다음 청구 날짜

프로필에 여러 개의 구독이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지 및 플로우를 보낼 수 있습니다. 

예약

고객이 예약을 할 수 있는 비즈니스인 경우 예약 개체를 사용하여 프로필에 대한 예약 데이터를 저장할 수 있습니다.  

예약 개체에 대한 각 개체 레코드에는 다음과 같은 데이터가 포함될 수 있습니다:

• 예약 ID
• 예약 날짜
• 예약 위치
• 예약 행사 
• 예약 게스트 수 

프로필에 여러 개의 예약이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지와 플로우를 보낼 수 있습니다. 

애완동물

반려동물 소유자에게 서비스를 제공하는 비즈니스인 경우 반려동물 개체를 사용하여 프로필의 반려동물에 대한 데이터를 저장할 수 있습니다.  

애완동물 개체에 대한 각 개체 레코드에는 다음과 같은 데이터가 포함될 수 있습니다:

• 반려동물 마이크로칩 ID
• 애완동물 이름 
• 반려동물 유형(예: 개 또는 고양이)
• 반려동물 품종
• 반려동물 생일 

프로필에 여러 개의 반려동물이 있는 경우 여러 개의 개체 레코드를 가질 수 있으며, 이 개체 데이터를 사용하여 세그먼트를 만들고 개인화된 메시지와 플로우를 보낼 수 있습니다. 

계정 한도 

사용자 지정 개체에는 3가지 계정 한도 세트가 있습니다: 

• 개체 제한
  한 계정이 보유할 수 있는 총 개체 수입니다.
• 개체 속성 제한
  한 계정이 개체당 가질 수 있는 속성 수입니다.
   
• 개체 레코드 제한
  계정에 허용되는 개체 레코드 수입니다.

사용 가능한 개체 및 개체 레코드 수는 모든 계정의 총 활성 프로필 수를 기준으로 합니다. 레코드 한도는 모든 계정에서 공유되는 반면, 개체 한도는 각 계정에 개별적으로 적용됩니다. 

예를 들어 각 계정에 100,000개의 활성 프로필이 있는 5개의 하위 계정이 있는 계정 패밀리가 있는 경우 총 활성 프로필은 500,000개입니다. 아래 차트에서 볼 수 있듯이 프로필이 40만 개가 넘는 계정은 개체 레코드 배수가 10입니다. 따라서 이러한 계정은 최대 500만 개(500,000개 x 10)의 레코드를 합쳐서 최대 500만 개까지 저장할 수 있습니다. 즉, 나머지 4개 계정의 개체 레코드를 합쳐서 200만 개 미만인 경우 하나의 계정에 300만 개의 레코드가 있을 수 있습니다. 계정당 개체 수는 총 프로필 수가 40만 개가 넘기 때문에 각 계정당 최대 5개까지 개체를 보유할 수 있습니다.

또한 모든 계정에는 다음과 같은 한도가 있습니다: 

• 객체당 프로필당 최대 500개의 레코드가 있습니다.
• 모든 사용자 지정 개체는 8KB를 넘지 않아야 합니다.
• 모든 사용자 지정 개체 레코드는 2KB를 넘지 않아야 합니다.

개체 만들기 

Klaviyo 에서 객체 생성을 시작하려면 콘텐츠 > 객체로 이동합니다. 

사용자 지정 개체에 대한 데이터 소스를 만들고 동기화하는 단계를 따르세요. 이 단계가 완료되면 사용자 지정 개체 만들기 버튼을 선택하여 개체를 만듭니다. 

여기에서 개체를 처음부터 새로 만들거나 권장 개체 템플릿을 선택할 수 있습니다. 개체를 처음부터 새로 만들려면 나만의 개체 만들기 버튼을 선택합니다.

객체 생성 워크플로우의 첫 번째 부분에서는 객체에 대해 다음 정보를 설정해야 합니다:

• 이름
  개체를 식별하는 이름입니다.
• 설명 (선택 사항)
  개체가 나타내는 데이터에 대한 설명입니다.
• 데이터 소스
  개체 데이터를 가져올 데이터 소스입니다. 드롭다운에 옵션으로 표시하려면 사용자 지정 개체 API 를 사용하여 Klaviyo 로 레코드 1개 이상을 보내야 합니다. 

개체 ID 설정

개체의 이름을 설정하고 데이터 소스를 선택했다면 다음 단계는 개체 ID를 설정하고 원하는 개체 속성을 매핑하는 것입니다. 이 단계에서는 사용자 지정 개체 API 를 통해 로 전송된 데이터 소스와 연결된 데이터를 미리 볼 수 Klaviyo 있습니다.

개체 레코드를 서로 구별하려면 개체 ID를 설정해야 합니다. 고유 개체 ID에 사용할 데이터 소스 속성을 지정해야 합니다. 

객체 ID는 객체 기록의 특정 인스턴스를 식별하기 위해 사용할 수 있는 고유한 데이터 소스 속성입니다. 예를 들어, 기프트 카드 객체의 경우 고유 할인 코드를 객체 ID로 사용할 수 있습니다. 이 값은 데이터 소스의 각 인스턴스에 고유하며, 모든 객체 기록에 존재합니다. 

Klaviyo 이 데이터 소스에서 동일한 개체 ID를 가진 데이터를 수신할 때마다 연결된 개체 레코드가 업데이트됩니다. 따라서 적절한 레코드가 업데이트되도록 개체 ID를 고유하게 설정하는 것이 중요합니다.

개체 데이터 보내기

기존 개체 레코드를 업데이트하면 전체 레코드가 교체됩니다. 따라서 하나의 속성만 업데이트하려는 경우에도 전체 개체 레코드를 전송하는 것이 중요합니다.

예를 들어 레코드에 있는 속성 5개 중 1개만 업데이트하려고 한다고 가정해 보겠습니다. ID와 업데이트하려는 속성 1개만 업데이트된 데이터로 전송하면 나머지 4개 속성은 null로 설정됩니다. 프로필 관계에 새로 null 필드 중 하나가 사용되었다면(예: 이메일 주소와 같은 프로필 식별자) 해당 개체는 더 이상 해당 프로필과 연결되지 않습니다.

맵 개체 속성 

개체 속성을 매핑하여 데이터 소스 내에서 Klaviyo 에서 개체 내에서 사용할 수 있는 정보를 선택할 수 있습니다.

그러나 이 이유로 인해, 객체 데이터를 표준화된 날짜 및 타임스탬프 형식으로 객체 인제스트 API를 통해 전송하는 것을 권장합니다. 특정 속성의 값이 알려지지 않은 경우 해당 속성에 null 값을 설정할 수 있습니다.

개체 속성을 매핑합니다:

1. 데이터 소스 속성 열에서 개체에 포함할 데이터 소스 속성을 선택합니다. 
2. 매핑된 속성 열에 데이터 소스 속성이 개체에 갖도록 할 이름을 입력합니다. 
3. 데이터 유형 열에서 데이터 소스 속성의 적절한 데이터 유형을 선택합니다.
4. 개체에서 이 속성을 필수로 설정하려면 필수 열에서 확인란을 선택합니다.
5. 추가 객체 속성을 매핑해야 하는 경우 매핑 추가 버튼을 선택합니다. 

매핑의 중첩된 데이터

기본적으로 개체 관리자 인터페이스는 1단계 중첩을 지원합니다. 더 심층적인 데이터에 액세스하려면 원하는 경로를 수동으로 입력해야 합니다.

예를 들어 아래 데이터 소스를 살펴보세요. 

{
 " type": "data-source-record",
 " attributes": {
 " record": {
 " child": {
 " child_id": "d64b8458",
 " name": {
          "first": "Theodore",
          "last": "Customer"
        },
 " birth_date": "2022-04-12",
 " email": "jon.customer@klaviyo.com",
        "전화 번호": [
 " +11234567899",
 " +13456789123"
 ]
 }
   }      
  }
}

자녀의 이름에 대한 데이터에 액세스하려면 데이터가 너무 멀리 중첩되어 있어 인터페이스로 액세스하기 어려우므로 다음 경로를 입력할 수 있습니다.

소스 데이터에 배열이 있는 경우 위치별로 매핑할 속성을 찾을 수 있습니다. 예를 들어, 경로 끝에 [0]을 포함하여 phone_numbers 배열 내의 첫 번째 전화번호를 가져올 수 있습니다. 

관계 추가 

개체 ID를 설정하고 개체 속성을 매핑한 후 다음 단계는 개체에 관계를 추가하는 것입니다. 

관계는 개체를 관련 프로필에 연결합니다. 다음 정보를 정의하여 관계를 설정합니다: 

• 관계 이름
  관계의 이름을 설정합니다. 예를 들어 애완동물 개체가 있는 경우 관계 이름을 '애완동물 소유자'와 같이 설정할 수 있습니다.
• 소스 데이터
  프로필과 연결하려는 데이터 소스 속성을 선택합니다. 
• 프로필 식별자
  프로필 식별자 (예: 이메일, 휴대폰 번호 등)를 설정합니다. 개체를 프로필에 연결하려면 데이터 소스에 포함되어야 합니다. 다른 속성 연결 버튼을 사용하여 추가 속성 및 식별자 쌍을 추가합니다.

매핑 확인 및 개체 생성

개체 속성 매핑 및 관계 설정을 완료했으면 확인 모달에서 매핑을 확인하고 개체 만들기 버튼을 선택합니다. 개체가 생성되면 기존 매핑은 편집할 수 없으며, 데이터는 즉시 동기화가 시작됩니다. 

다음 정보와 함께 의 객체 페이지에 객체가 나열됩니다:Klaviyo 

• 개체 이름
• 생성 날짜
• 마지막 업데이트 날짜
• 상태

사용자 지정 개체 상태 상태

 사용자 지정 개체를 게시할 때는 세 가지 상태가 있습니다: 

• 초안
  개체가 아직 편집 가능하지만 게시되거나 활성화되지 않은 상태입니다. 
• 게시
  개체는 데이터 소스로 전송한 데이터에서 사용자 지정 개체 레코드를 생성합니다.  데이터 소스에서 수천 개의 레코드를 전송한 경우 개체가 즉시 게시됩니다. 수백만 개의 레코드를 전송한 경우 게시하는 데 몇 시간이 걸릴 수 있습니다. 완료되면 상태가 활성으로 변경됩니다.
• 활성
  개체가 게시되어 라이브 상태입니다. 모든 사용자 지정 개체 레코드는 데이터 소스에서 전송된 데이터에 따라 생성되었습니다. 이 개체에 대한 새 데이터가 전송되면 프로필에 연결된 추가 사용자 지정 개체 레코드가 생성됩니다.

프로필 페이지의 개체

프로필 페이지에도 관련 개체가 표시되므로 프로필과 관련된 개체 레코드를 볼 수 있습니다. 개체 레코드를 보려면 프로필 페이지의 개체 탭으로 이동합니다. 개체 카드 위의 드롭다운 메뉴를 사용하여 개체 간에 전환할 수 있습니다. 

전체 개체 레코드를 보려면 점 3개 메뉴를 선택하고 보기를 클릭합니다. 전체 개체 레코드가 포함된 사이드 패널이 나타납니다. 

개체 업데이트 

개체에 대한 새 데이터 전송을 시작하려면 데이터 소스에 추가 개체 속성을 추가한 다음 이 새 속성을 포함하도록 개체 매핑을 편집합니다. 이전에 생성된 모든 객체는 해당 데이터를 사용할 수 없으므로 이 속성에 대해 null을 반환하지만 앞으로는 이 속성을 사용하여 객체를 생성하고 업데이트합니다.

아직 객체에 매핑되지 않은 새 객체 속성을 전송하는 경우 사용자 지정 객체를 업데이트하여 해당 속성을 포함할 수 있습니다. 그런 다음 모든 사용자 지정 개체 레코드가 이 데이터를 포함하도록 재처리됩니다.

개체를 업데이트하려면

1. 사이드바에서 콘텐츠 > 개체를 클릭합니다. Klaviyo
2. 편집하려는 개체의 이름을 선택합니다. 
3. 오른쪽 상단 모서리에 있는 다음을 클릭합니다.

4. 맵 객체 속성 섹션에서 매핑 추가를 클릭합니다.

   이 옵션은 개체에 추가할 수 있는 추가 속성이 있는 경우에만 사용할 수 있습니다.

5. 데이터 소스 속성 열에서 개체에 포함할 데이터 소스 속성을 선택합니다. 
6. 매핑된 속성 열에 데이터 소스 속성이 개체에 갖도록 할 이름을 입력합니다. 

7. 데이터 유형 열에서 데이터 소스 속성의 적절한 데이터 유형을 선택합니다.

   새로 매핑된 속성은 필수로 표시할 수 없습니다.

   

8. 오른쪽 상단 모서리에 있는 다음을 클릭합니다. 
9. 오른쪽 상단 모서리에 있는 다음을 클릭합니다. 관계를 변경할 필요가 없습니다.
10. 변경 사항 게시를 클릭합니다.

이 프로세스를 완료하면 데이터 소스의 모든 레코드가 재처리되고 기존 사용자 지정 개체 레코드가 그에 따라 업데이트됩니다. 

개체 삭제 

개체를 삭제하려면 

1. 사이드바에서 콘텐츠 > 개체를 클릭합니다. Klaviyo
2. 개체 오른쪽에 있는 메뉴에서 삭제를 클릭합니다. 
   
3. 삭제를 다시 클릭하여 개체 제거를 확인합니다. 
4. 개체 및 연결된 모든 사용자 지정 개체 레코드가 삭제됩니다. 

이전 객체의 데이터 소스를 사용하여 새 사용자 지정 객체를 만들면 이미 동기화한 데이터를 사용하여 새 사용자 지정 객체 레코드가 생성됩니다. 동일한 데이터를 사용하지만 새 레코드가 있는 새 개체로 간주되므로 이 새 개체를 사용하려면 모든 세그먼트, 플로우, 템플릿 및 캠페인을 업데이트해야 합니다.

추가 자료 

템플릿에서 사용자 지정 개체를 사용하는 방법

세그먼트에서 사용자 지정 개체를 사용하는 방법

플로우에서 사용자 지정 개체를 사용하는 방법

사용자 지정 개체 API 개요