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

학습 내용

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

개체에 대한 일반적인 질문

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

API를 통해 맞춤 데이터를 전송하려면 개발자가 필요해요. Klaviyo에서 데이터 소스를 만들고 오브젝트를 구성할 수 있어요.

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

Klaviyo 양식과 CSV 업로드는 사용자 지정 객체 레코드를 전송하지 않아요. API를 사용해 사용자 지정 데이터를 전송한 다음, Klaviyo에서 객체에 매핑해 주세요.

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

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

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

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

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

네, 계정의 객체 속성 한도까지 필수가 아닌 속성을 추가할 수 있어요. 자세한 내용은 사용자 지정 객체 업데이트를 읽어보세요.

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

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

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

1. 이벤트 데이터에 필요한 속성을 포함한 다음, 템플릿에서 참조하세요. 예를 들어 이벤트에 pet_name 속성이 포함되어 있다면 {{ event.pet_name }}을(를) 사용하세요. 적시성이 중요할 때 효과적이에요.
2. 이벤트 데이터에 객체의 ID를 포함한 다음, 템플릿에서 해당 객체를 가져오세요. Name 속성이 있고 pet_id라는 이벤트 속성이 있는 Pet라는 객체의 경우 {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}을(를) 사용하세요. 이 이름들은 사용 중인 객체, 속성, 이벤트 필드 이름으로 바꿔 주세요. 객체 업데이트가 사용 가능해지기까지 시간이 걸릴 수 있으므로, 객체에 최신 값이 반영되기 전에 플로우 메시지가 전송될 수 있어요.

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

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

1. API를 사용하여 새 데이터 출처를 만드세요.
2. Bulk Create Data Source Records의 예시 JSON을 사용해 데이터 구조를 정의해 주세요.
3. API를 통해 데이터 소스 레코드를 Klaviyo로 전송하세요.
4. 생성을 선택해 해당 데이터 원본을 사용하여 사용자 정의 개체를 만드세요. 고유한 개체 ID를 선택하고 사용하려는 속성을 매핑하세요.
5. 이메일이나 전화번호 같은 데이터의 프로필 식별자를 매핑해서 사용자 지정 객체와 프로필 간 관계를 만드세요.
6. 매핑을 검토한 다음 객체 만들기를 클릭하고, 확인을 위해 객체 만들기를 다시 클릭하세요.

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

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

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

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

개발자가 JSON 형식의 데이터를 Klaviyo로 전송해야 해요. 여러 텍스트 값을 가진 속성의 경우 문자열 배열을 전송하고 목록(텍스트)로 매핑해 주세요. 세그먼트와 플로우에서 이러한 값을 필터링할 수 있어요. 필터링에 대한 자세한 내용은 세그먼트 조건 참조를 확인해 주세요.

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

• 텍스트
• 숫자(정수)
• 숫자(십진수)
• Timestamp: 날짜와 시간은 UTC에 저장돼요. 2025-04-03처럼 시간대가 없는 값은 2025-04-03 00:00:00 UTC로 처리돼요. 2025-04-03T00:00:00+03:00처럼 오프셋이 있는 값은 2025-04-02 21:00:00 UTC로 변환돼요.
• 부울
• 목록(문자)

목록(텍스트)은 ["dog", "cat"]처럼 문자열 배열을 지원해요. 숫자 배열, 중첩된 목록 또는 객체는 지원하지 않아요. 데이터 소스 레코드 API의 예시 페이로드는 데이터 소스 레코드 대량 생성을 참고해 주세요.

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

매핑된 각 사용자 지정 객체 속성에는 최대 2 KB까지 포함될 수 있으며, 매핑된 각 사용자 지정 객체 레코드에는 최대 8 KB까지 포함될 수 있어요.

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

커스텀 객체에 사용할 속성은 중첩하지 않고 JSON 객체를 정의하는 것을 권장해요. 중첩된 데이터의 경우 데이터 소스 속성 드롭다운에서 속성을 선택하거나, JSON 경로를 직접 입력해 주세요. 텍스트 값 목록의 경우 목록 자체를 목록(텍스트)(으)로 매핑해 주세요. 배열에서 단일 항목을 매핑하려면 [0]은 첫 번째 항목, [1]은 두 번째 항목처럼 위치를 사용해 주세요.

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

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

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

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

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

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

예, 그렇습니다. 플로우를 라이브로 설정하기 전에 사용자 지정 객체를 기반으로 한 날짜 트리거 플로우에서 {{ object }} 데이터를 사용하는 메시지를 미리 볼 수 있어요.

이메일을 미리 보려면:

1. 사용자 정의 객체를 기반으로 한 날짜 트리거 플로우에서 이메일을 연 다음, 이메일 편집기에서 미리보기를 클릭해 주세요.
2. 해당 객체의 레코드에 연결된 프로필을 선택한 다음, 개인화된 메시지를 검토해 주세요.

미리보기는 선택한 프로필과 연결된 샘플 객체를 사용해요. 사용할 수 있는 항목이 없으면 동일한 객체 유형의 샘플 레코드를 사용해요. 표시된 값을 확인해 주세요. 미리보기는 어떤 레코드가 플로우를 트리거할지 확인해 주지 않아요. 사용 가능한 레코드가 없으면 미리볼 객체 데이터가 없어요.

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

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