커스텀 객체에 대해 자주 묻는 질문

학습 내용

Klaviyo의 사용자 지정 객체와 관련된 자주 묻는 질문을 살펴보세요. 아래 리소스에서 질문에 대한 답을 찾을 수 없다면, 커뮤니티 포럼에서 문의해 주세요.

개체에 대한 일반적인 질문

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

네, 이 기능은 API를 사용해 데이터 소스를 전송하고, 최종적으로 객체를 만드는 방식에 따라 달라져요.

Klaviyo 양식이나 CSV 업로드를 사용해 사용자 지정 오브젝트를 만들 수 있나요?

Klaviyo에서는 현재 API를 통해 데이터를 보내 새 맞춤 객체를 만들려면 계정이 필요해요.

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

사용자 지정 객체가 나타내는 카테고리와 프로필 간에 다대일 관계가 있을 때는 사용자 지정 객체를 사용해야 해요. 예를 들어 고객의 반려동물 정보를 유지하려고 하는데 고객에게 반려동물이 한 마리 이상일 수 있다면, 이를 프로필 속성이나 이벤트로 표현하는 것보다 사용자 지정 객체로 표현하는 것이 훨씬 더 적합해요.

멤버십 상태처럼 프로필에서 한 번에 하나의 상태만 가질 수 있는 항목을 트래킹할 때는 프로필 속성이 더 적합해요. 하지만 프로필의 멤버십에 대한 다른 세부 정보도 저장하려면 객체가 더 적합할 수 있어요.

수신자가 이메일을 몇 번 열었는지처럼 광범위한 내용을 트래킹할 때는 이벤트를 사용하는 것이 좋다고 권장해요.

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

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

이벤트를 발생시키는 경우와 커스텀 오브젝트의 속성을 업데이트하는 경우는 각각 언제인가요?

이벤트는 플로우를 빠르게 트리거하도록 설계되어, 시의적절하고 관련성 높은 메시지를 보낼 수 있어요. 객체의 상태가 변경되어 그 결과로 메시지를 트리거하려는 경우, 새 정보로 객체를 업데이트하고 플로우를 트리거하기 위해 이벤트를 보내야 해요.

이벤트 트리거 플로우에서 객체 정보를 사용해 템플릿을 개인화 할 수 있어요. 이를 달성하는 방법은 두 가지가 있어요:

1. {{ event }} 태그를 사용해 템플릿에서 사용할 수 있도록 이벤트 메타데이터에 관련 속성을 추가하세요. 시기 적절함이 중요한 경우에 잘 작동해요.
2. 이벤트의 메타데이터에 객체의 ID를 포함하면, 템플릿에서 {% customobject id={{ event.pet_id }} as pet %}을(를) 사용해 해당 객체를 가져올 수 있어요. 다만 객체가 최신 속성으로 업데이트되는 데 시간이 걸릴 수 있어, 객체가 업데이트되기 전에 플로우가 트리거되어 메시지가 발송될 수도 있어요.

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

사용자 지정 객체에 대한 데이터를 보내려면 어떻게 시작하나요?

1. API를 사용하여 새 데이터 출처를 만드세요.
2. 데이터 구조를 정의하세요(예시 JSON 참조).
3. API를 통해 데이터 소스 레코드를 Klaviyo로 전송하세요.
4. 만들기를 클릭하여 사용자 정의 개체를 만드세요.
5. 사용자 지정 개체와 프로필 간의 관계를 생성해 주세요.

데이터 소스는 어떻게 생성되고 사용되나요?

새 데이터 소스를 만든 후 Klaviyo는 API 요청에 대한 응답의 일부로 고유 식별자를 반환해요. 이를 통해 Klaviyo는 데이터 소스를 식별할 수 있으며, 특히 한 계정에 데이터 소스가 여러 개인 경우(예: 브랜드가 비즈니스를 위해 의존하는 각 맞춤 연동, 데이터 웨어하우스 또는 맞춤형 타사 연동용 1개)에도 유용해요.

이 고유 식별자를 사용하면 개발자가 Klaviyo API를 통해 데이터 소스 레코드를 만들 수 있어요.

데이터를 어떻게 형식화해야 하나요?

개발자가 JSON 형식의 데이터를 Klaviyo로 전송해야 해요. 데이터는 쉼표로 구분된 목록이 포함된 텍스트로 전송하는 것을 권장해요. 쉼표로 구분된 이 문자열의 값으로 필터링하려면 세분화와 플로우 필터의 “포함” 연산자를 사용할 수 있어요. 필터링에 대한 자세한 내용은 세그먼트 조건 참조를 확인하세요. 

커스텀 객체에서 지원되는 데이터 유형:

• 텍스트
• 정수
• 소수
• 날짜 - 모든 날짜/시간은 시스템에서 UTC로 변환돼요. 예를 들어 “2025-04-03”을 업로드하면 “2025-04-03 00:00:00”으로 변환돼요. 시간대가 3시간 빠른 고객의 경우 날짜/시간은 “2025-04-02 21:00:00”으로 표시돼요.
• 부울

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

맞춤 객체의 데이터 한도는 어떻게 되나요?

속성당 최대 2KB, 전체 레코드당 총 8KB까지 업로드할 수 있습니다.

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

맞춤 객체에 사용할 속성을 중첩하지 않고 JSON 객체를 정의하는 것을 권장해요. 소스 데이터가 깊게 중첩되어 있거나 목록을 사용하는 경우, 객체 관리자에서 JSON 경로를 수동으로 입력해야 해요. 목록의 경우 해당 목록 내 위치(예: 첫 번째 값 또는 두 번째 값)에만 속성을 매핑할 수 있어요.

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

네, 2개 이상의 프로필 식별자(예: 이메일 및 전화번호)를 사용해 사용자 지정 오브젝트 레코드를 프로필에 연결하려면, 값 중 하나가 null이더라도 매번 동기화할 때마다 두 속성을 모두 포함해야 합니다. 

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

내 객체가 플로우를 트리거하지 않았고 이벤트에서 객체 ID를 얻지 못했더라도, 메시지를 여전히 개인화할 수 있나요?

네, 객체 필터를 사용해 메시징을 개인화할 때 적합한 객체를 찾을 수 있어요.

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

현재 {{ object }} 태그를 사용할 때는 앱의 미리 보기 기능으로 메시지를 확인할 수 없습니다.

플로우 메시지를 테스트하려면:

1. 날짜 트리거 플로우를 생성하고 라이브로 설정하세요.
2. 최소 24시간 후에 트리거되는 날짜가 포함된 객체로 프로필을 생성하세요.

웹후크 및 Klaviyo 코드 같은 플로우 작업을 사용해 오브젝트를 업데이트할 수 있나요?

현재로서는 먼저 원본 데이터 소스를 업데이트한 다음, 허용된 형식으로 수정된 객체를 Klaviyo로 다시 보내는 것을 권장해요. 이 두 시스템의 동기화가 깨지면, 시스템에서 오래된 레코드를 Klaviyo로 다시 보내 원래 값으로 되돌릴 위험이 있어요.