사용자 정의 개체 시작하기

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

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

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

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

반려동물이 여러 마리 있는 경우 대신 사용자 정의 개체를 사용할 수 있습니다. 이렇게 하면 Fluffy the Great Dane은 이름, 나이, 체중 등에 대한 자신만의 디지털 ID 카드를 가지고 있으며, Cheeks the hamster는 동일한 정보를 가지고 있지만 (매우) 다른 답변을 가지고 있습니다. 

사용 사례 예시

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

약속

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

약속 개체에 대한 각 개체 레코드 내에서 포함하려는 데이터의 예는 다음과 같습니다.

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

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

구독

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

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

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

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

예약

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

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

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

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

반려동물

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

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

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

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

계정 한도

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

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

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

예를 들어, 계정당 활성 프로필이 100,000개이고 하위 계정이 5개인 계정 가족이 있는 경우 총 활성 프로필은 500,000개에 해당합니다. 아래 차트에서 볼 수 있듯이 프로필이 40만 개 이상인 계정의 개체 레코드 승수는 10입니다. 결과적으로 이러한 계정은 총 5백만 개의 레코드(500,000 x 10)를 저장할 수 있습니다. 즉, 나머지 4개의 계정을 합하면 개체 레코드가 2백만 개 미만인 경우 3백만 개의 레코드가 있는 계정을 1개 만들 수 있습니다. 계정당 개체 수는 프로필 수를 합하면 40만 개가 넘으므로 각 계정에는 최대 5개의 개체를 포함할 수 있습니다.

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

• 개체당 프로필당 최대 500개의 레코드입니다.
• 모든 사용자 정의 개체는 8KB 미만이어야 합니다.
• 모든 사용자 정의 개체 레코드는 2KB 미만이어야 합니다.

개체를 만듭니다.

Klaviyo에서 개체 만들기를 시작하려면 콘텐츠 > 개체로 이동합니다. 개체 만들기 를 클릭합니다.

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

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

• 이름
  개체를 식별할 수 있는 이름입니다
• 설명 (선택 사항)
  개체가 나타내는 데이터에 대한 설명입니다.
• 데이터 원본
  개체 데이터가 있는 데이터 소스입니다.

새 데이터 출처를 생성하려면 데이터 출처 선택 드롭다운을 클릭한 다음 새 데이터 출처 생성을 선택합니다.

데이터 출처를 생성하려면 다음 정보를 설정해야 합니다.

• 이름
  개체 데이터의 출처를 식별할 수 있는 고유한 이름입니다.
• 설명 (선택 사항)
  데이터 출처에 대한 설명입니다.

개체 ID를 설정합니다

오브젝트 이름을 설정하고 데이터 소스를 선택했다면, 다음 단계는 오브젝트 ID를 설정하고 원하는 오브젝트 속성을 매핑하는 거예요. 이 단계에서는 커스텀 오브젝트 API를 통해 Klaviyo로 전송된 데이터 소스와 연결된 데이터를 미리 볼 수 있어요.

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

개체 ID는 개체 레코드의 특정 인스턴스를 식별하는 데 사용할 수 있는 고유한 데이터 원본 속성이어야 합니다. 예를 들어 기프트 카드 개체를 사용하는 경우 고유 할인 코드와 같은 것을 개체 ID로 사용할 수 있습니다. 이는 데이터 출처의 각 인스턴스에 대해 고유하며 모든 개체 레코드에 대해 존재합니다.

Klaviyo가 동일한 개체 ID로 데이터 소스로부터 데이터를 수신할 때마다 관련 개체 레코드가 업데이트됩니다. 따라서 개체 ID가 고유하여 적절한 레코드가 업데이트되는 것이 중요합니다.

개체 데이터를 전송합니다.

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

예를 들어 레코드의 5개 속성 중 1개만 업데이트한다고 가정해 보겠습니다. ID와 업데이트하려는 1개의 속성만으로 업데이트된 데이터를 보내면 다른 4개의 속성은 널로 설정됩니다. 프로필 관계에 새로 빈 필드 중 하나(예: 이메일 주소와 같은 프로필 식별자)가 사용된 경우 개체는 더 이상 해당 프로필과 관련이 없습니다.

개체 매핑 속성

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

하지만 이런 이유로, 객체 수집 API를 통해 객체 데이터를 표준화된 날짜 및 타임스탬프 형식으로 전송하는 것을 권장해요. 특정 속성의 값을 알 수 없는 경우, 해당 속성에 null 값을 설정할 수 있어요.

개체 속성을 매핑하려면 다음과 같이 하세요.

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

매핑에 중첩된 데이터

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

예시로 아래 데이터 출처를 살펴보세요.

text Copy

{
  "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",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

자식 이름에 대한 데이터에 액세스하려면 다음 경로를 입력할 수 있습니다. 그렇지 않으면 데이터가 너무 멀리 중첩되어 있어 인터페이스로 액세스할 수 없기 때문입니다.

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

관계 추가

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

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

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

매핑 확인 및 개체 생성

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

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

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

사용자 정의 개체 상태

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

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

프로필 페이지의 개체

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

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

개체를 업데이트합니다.

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

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

개체를 업데이트하려면 다음과 같이 하세요.

1. Klaviyo 사이드바에서 콘텐츠 > 개체 를 클릭합니다.
2. 수정하려는 개체의 이름을 선택합니다.
3. 오른쪽 상단에서 다음을 클릭합니다 .
4. 개체 속성 매핑 섹션 에서 매핑 추가를 클릭합니다.

1. 데이터 원본 속성 열에서 개체에 포함할 데이터 원본 속성을 선택합니다.
2. 매핑된 속성 열에 개체에 데이터 원본 속성을 포함할 이름을 입력합니다.
3. 데이터 유형 열에서 데이터 소스 속성에 적합한 데이터 유형을 선택해 주세요.

1. 오른쪽 상단에서 다음을 클릭합니다 .
2. 오른쪽 상단에서 다음을 클릭합니다 . 관계를 변경할 필요가 없습니다.
3. 변경 사항 게시 를 클릭합니다.

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

개체를 삭제합니다.

개체를 삭제하려면 다음과 같이 하세요.

1. Klaviyo 사이드바에서 콘텐츠 > 개체 를 클릭합니다.
2. 개체 오른쪽에 있는 메뉴에서 삭제를 클릭합니다.
   

3. 삭제 를 다시 클릭하여 개체 제거를 확인합니다.
4. 개체 및 관련된 모든 사용자 지정 개체 레코드가 삭제됩니다.

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