사용자 지정 개체에 대해 자주 묻는 질문

학습 내용

사용자 지정 개체와 관련된 자주 묻는 질문에 대한 자세한 내용은 Klaviyo 에서 확인하세요. 아래 리소스에 질문이 보이지 않는다면 커뮤니티 포럼에 문의해 주세요.

객체에 대한 일반적인 질문

개체를 만들려면 개발자가 필요하나요?

예, 이 기능은 데이터 소스를 전송하고 궁극적으로 개체를 생성하기 위해 API를 사용하는 데 의존합니다.

Klaviyo 양식 또는 CSV 업로드를 사용하여 사용자 지정 개체를 만들 수 있나요?

Klaviyo 는 현재 API 를 통해 데이터를 전송하여 새로운 사용자 지정 개체를 생성하는 계정을 필요로 합니다. 

사용자 지정 객체와 프로필 속성 또는 이벤트는 언제 사용해야 하나요?

사용자 지정 개체가 나타내는 카테고리와 프로필 간에 다대일 관계가 있는 경우 사용자 지정 개체를 사용해야 합니다. 예를 들어 고객의 반려동물에 대한 정보를 보관하고 싶은데 고객이 반려동물을 두 마리 이상 키울 수 있다면 프로필 속성이나 이벤트보다 사용자 지정 개체로 표현하는 것이 훨씬 더 효과적입니다.

프로필이 한 번에 하나의 상태만 가질 수 있는 멤버십 상태와 같은 항목을 추적할 때는 프로필 속성이 더 적합합니다. 그러나 프로필의 멤버십에 대한 다른 세부 정보도 저장하려는 경우 개체가 더 효과적일 수 있습니다. 

수신자가 이메일을 몇 번 열었는지와 같이 광범위한 내용을 추적할 때는 이벤트를 사용하는 것이 좋습니다.

생성 후 사용자 지정 개체를 업데이트할 수 있나요?

예, 언제든지 사용자 지정 개체에 필수가 아닌 추가 속성을 추가할 수 있습니다. 자세한 내용은 사용자 지정 개체 업데이트에 대해 읽어보세요. 

언제 이벤트를 발생시켜야 하나요, 아니면 커스텀 오브젝트의 프로퍼티를 업데이트해야 하나요?

이벤트는 플로우를 빠르게 트리거하여 시의적절하고 관련성 있는 메시지를 보낼 수 있도록 하기 위한 것입니다. 개체의 상태가 변경되고 그 결과로 메시지를 트리거하려면 새 정보로 개체를 업데이트하고 플로우를 트리거할 이벤트를 보내야 합니다.

이벤트 트리거된 플로우의 개체 정보로 템플릿을 개인화할 수 있습니다. 이를 달성하는 방법에는 두 가지가 있습니다: 

1. 태그를 사용하여 {{ event }} 태그를 사용하여 이벤트의 메타데이터에 관련 속성을 추가하여 템플릿에서 사용할 수 있습니다. 적시성이 중요한 경우 이 방법이 효과적입니다.
2. 이벤트의 메타데이터에 객체의 ID를 포함하면 {% customobject id={{ event.pet_id }} as pet %}를 사용하여 템플릿에서 객체를 가져올 수 있습니다. 그러나 개체가 최신 속성으로 업데이트되는 데 시간이 다소 걸릴 수 있으므로 개체가 업데이트되기 전에 플로우에서 메시지를 트리거하여 보낼 수 있습니다.

개체 데이터 전송에 관한 질문 

사용자 지정 개체에 대한 데이터 전송을 시작하려면 어떻게 해야 하나요?

1. API를 사용하여 새 데이터 소스를 만듭니다.
2. 데이터 구조를 정의합니다(JSON 예제 참조).
3. 데이터 소스 레코드를 Klaviyo 으로 보내십시오. API.
4. 사용자 지정 개체를 만듭니다.
5. 사용자 지정 객체와 프로필 간의 관계를 만듭니다.

데이터 원본은 어떻게 생성되고 사용되나요?

새 데이터 소스를 생성하면 Klaviyo 에서 API 요청에 대한 응답의 일부로 고유 식별자를 반환합니다. 특히 계정에 여러 개의 데이터 소스(예: 브랜드가 비즈니스에 의존하는 사용자 지정 연동, 데이터 웨어하우스 또는 사용자 지정 타사 연동 각각에 대해 1개)가 있는 경우 Klaviyo 에서 데이터 소스를 식별할 수 있습니다.

개발자는 이 고유 식별자를 사용하여 Klaviyo의 API 을 통해 데이터 소스 레코드를 만들 수 있습니다.

데이터 포맷은 어떻게 해야 하나요?

개발자는 JSON 형식의 데이터를 Klaviyo 으로 보내야 합니다. 쉼표로 구분된 목록으로 데이터를 텍스트로 전송하는 것이 좋습니다. 세분화 및 플로우 필터의 "포함" 연산자를 사용하여 쉼표로 구분된 이 문자열의 값을 필터링할 수 있습니다. 필터링에 대한 자세한 내용은 세그먼트 조건 참조를 참조 하세요.  

사용자 지정 개체에서 지원되는 데이터 유형:

• 텍스트
• 정수
• 십진수
• 날짜 - 모든 날짜는 시스템에서 UTC로 변환됩니다. 예를 들어 "2025-04-03"을 업로드하면 "2025-04-03 00:00:00"으로 변환됩니다. 시간대가 3시간 앞선 고객의 경우 날짜는 "2025-04-02 21:00:00"이 됩니다.
• 부울(Boolean) 데이터

리스트 데이터 유형은 현재 지원되지 않습니다. 데이터 소스 레코드 API 에 대한 페이로드 예시는 데이터 소스 레코드 대량 생성을 참조하세요.

사용자 지정 개체의 데이터 한도는 어떻게 되나요?

속성당 최대 2KB, 총 기록당 8KB까지 업로드할 수 있습니다.

중첩된 데이터로 매핑할 수 있나요?

사용자 지정 객체에 사용할 프로퍼티를 중첩하지 않고 JSON 객체를 정의하는 것이 좋습니다. 소스 데이터가 깊게 중첩되어 있거나 리스트를 사용하는 경우 개체 관리자에 JSON 경로를 수동으로 입력해야 합니다. 리스트의 경우 프로퍼티를 해당 리스트 내의 위치(예: 첫 번째 또는 두 번째 값)에만 매핑할 수 있습니다.

프로필에 여러 개의 식별자를 연결할 수 있나요?

예. 2개 이상의 프로필 식별자(예: 이메일 및 전화번호)를 사용하여 사용자 지정 개체 레코드를 프로필에 연결하려면 프로필 식별자 중 하나의 값이 null인 경우에도 모든 동기화에서 해당 속성을 모두 포함해야 합니다.  

플로우에서 객체 사용에 관한 질문 

날짜 트리거 플로우에 트리거 분할 또는 트리거 필터를 사용할 수 있나요?

현재로서는 날짜 트리거 플로우에 대한 트리거 분할 및 트리거 필터를 만들 수 없습니다.

내 개체가 플로우를 트리거하지 않았고 이벤트의 개체 id 가 없는 경우에도 메시지를 개인화할 수 있나요?

예, 개체 필터를 사용하여 메시징을 맞춤 설정할 때 적합한 개체를 찾을 수 있습니다. 

개체가 플로우를 트리거할 때 플로우 메시지를 미리 볼 수 있나요? 

현재는 앱에서 미리보기 기능을 사용하여 메시지를 볼 수 없습니다. {{ object }} 태그를 사용하면 메시지를 볼 수 없습니다.

플로우 메시지를 테스트합니다:

1. 날짜 트리거 플로우를 만들고 라이브 플로우로 설정합니다.
2. 최소 24시간 후에 트리거되는 날짜가 있는 개체를 사용하여 프로필을 만듭니다.

웹후크 및 Klaviyo 코드와 같은 플로우 액션을 사용하여 개체를 업데이트할 수 있나요?

이때 원본 데이터 소스를 먼저 업데이트한 다음 수정된 개체를 허용된 형식으로 Klaviyo 으로 보내는 것이 좋습니다. 이 두 시스템이 동기화되지 않으면 오래된 레코드를 시스템에서 Klaviyo 으로 되돌아가서 원래 값으로 되돌릴 위험이 있습니다.