Klaviyo 데이터 모델 참조

이 페이지에는 Klaviyo 데이터 전송을 실행할 때 BigQuery로 전송되는 데이터가 나와 있습니다. 데이터는 각 필드 이름, 연결된 대상 데이터 유형, 소스 데이터의 JSON 경로를 나열하는 테이블로 구성됩니다.

계정

Klaviyo 계정 정보 및 메타데이터

  • 테이블 이름: Accounts
  • 엔드포인트: /accounts
  • Klaviyo API 참조: 계정 가져오기
필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 account)입니다.
id 문자열 $.id 계정의 고유 식별자입니다.
test_account 문자열 $.attributes.test_account 테스트 계정인지 여부를 나타냅니다.
default_sender_name 문자열 $.attributes.contact_information.default_sender_name 이메일 발신자로 사용되는 기본 이름입니다.
default_sender_email 문자열 $.attributes.contact_information.default_sender_email 발신자로 사용되는 기본 이메일 주소입니다.
website_url 문자열 $.attributes.contact_information.website_url 조직 웹사이트의 URL입니다.
organization_name 문자열 $.attributes.contact_information.organization_name 조직의 이름입니다.
address1 문자열 $.attributes.contact_information.street_address.address1 상세 주소 입력란 1
address2 문자열 $.attributes.contact_information.street_address.address2 상세 주소 입력란 2
city 문자열 $.attributes.contact_information.street_address.city 조직의 도시입니다.
region 문자열 $.attributes.contact_information.street_address.region 주, 도 또는 지역입니다.
country 문자열 $.attributes.contact_information.street_address.country 국가
zip 문자열 $.attributes.contact_information.street_address.zip 우편번호
industry 문자열 $.attributes.industry 계정의 업종 카테고리입니다.
timezone 문자열 $.attributes.timezone 계정의 시간대 설정입니다.
preferred_currency 문자열 $.attributes.preferred_currency 계정에서 사용하는 기본 통화입니다.
public_api_key 문자열 $.attributes.public_api_key 클라이언트 측 통합을 위한 공개 API 키 (사이트 ID)입니다.
locale 문자열 $.attributes.locale 언어 설정 (예: ko-KR)

쿠폰

할인 및 프로모션 쿠폰

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 coupon)입니다.
id 문자열 $.id 쿠폰의 고유한 내부 식별자입니다.
external_id 문자열 $.attributes.external_id 외부 식별자 (이름/ID와 동일한 경우가 많음)
description 문자열 $.attributes.description 쿠폰 혜택에 대한 설명입니다.
low_balance_threshold 문자열 $.attributes.monitor_configuration.low_balance_threshold 잔액 부족 알림을 트리거하는 기준점입니다.

CouponCode

특정 쿠폰에 대해 생성된 개별 고유 코드입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 coupon-code)입니다.
id 문자열 $.id 이 특정 코드 인스턴스의 고유 식별자입니다.
unique_code 문자열 $.attributes.unique_code 실제 영숫자 코드 문자열입니다.
expires_at TIMESTAMP $.attributes.expires_at 이 코드가 만료되는 타임스탬프입니다.
status 문자열 $.attributes.status 코드 상태 (예: ASSIGNED, UNASSIGNED)
coupon_id 문자열 $.relationships.coupon.data.id 상위 쿠폰 정의의 ID입니다.

이벤트

프로필에 대해 추적되는 활동 이벤트 (예: 주문, 제품 조회)입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 event)입니다.
id 문자열 $.id 이벤트의 고유 식별자입니다.
timestamp FLOAT $.attributes.timestamp 이벤트가 발생한 시점의 Unix 타임스탬프입니다.
event_properties JSON $.attributes.event_properties 이벤트 유형과 관련된 커스텀 JSON 속성 (예: 주문 항목)입니다.
datetime TIMESTAMP $.attributes.datetime 이벤트의 ISO 8601 타임스탬프입니다.
uuid 문자열 $.attributes.uuid 이벤트의 범용 고유 식별자입니다.
profile_id 문자열 $.relationships.profile.data.id 이벤트와 연결된 프로필 (고객)의 ID입니다.
metric_id 문자열 $.relationships.metric.data.id 측정항목 (이벤트 유형) 정의의 ID입니다.
attribution_ids REPEATED STRING $.relationships.attributions.data[*].id 이 이벤트에 기여한 캠페인/흐름의 ID입니다.

플로우

특정 이벤트 또는 조건에 의해 트리거되는 자동화된 마케팅 흐름입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 flow)입니다.
id 문자열 $.id 흐름의 고유 식별자입니다.
name 문자열 $.attributes.name 흐름의 이름입니다.
status 문자열 $.attributes.status 운영 상태 (예: 라이브, 초안)
archived 부울 $.attributes.archived 흐름이 보관처리되었는지 여부입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
trigger_type 문자열 $.attributes.trigger_type 흐름을 트리거하는 메커니즘입니다 (예: '목록에 추가됨', '측정항목').
flow_actions_ids REPEATED STRING $.relationships.flow-actions.data[*].id 이 흐름 내 작업 (단계)의 ID입니다.
tag_ids REPEATED STRING $.relationships.tags.data[*].id 이 흐름에 할당된 태그의 ID입니다.

설문지

구독자 정보를 수집하기 위한 가입 양식

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 form)입니다.
id 문자열 $.id 양식의 고유 식별자입니다.
name 문자열 $.attributes.name 양식 이름입니다.
status 문자열 $.attributes.status 양식의 상태 (예: 게시 중, 초안)
ab_test 부울 $.attributes.ab_test 양식에서 A/B 테스트를 실행 중인지 여부입니다.
created_at TIMESTAMP $.attributes.created_at 생성 타임스탬프입니다.
updated_at TIMESTAMP $.attributes.updated_at 최종 수정 타임스탬프입니다.

이미지

캠페인 및 템플릿에 사용하기 위해 Klaviyo에 업로드된 이미지입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 image)입니다.
id 문자열 $.id 고유 식별자입니다.
name 문자열 $.attributes.name 이미지의 파일 이름 또는 이름입니다.
image_url 문자열 $.attributes.image_url 이미지에 액세스할 수 있는 공개 URL입니다.
format 문자열 $.attributes.format 이미지 파일 형식 (예: jpeg, png)입니다.
size FLOAT $.attributes.size 파일 크기(바이트)입니다.
hidden 부울 $.attributes.hidden UI에서 이미지가 숨겨져 있는지 여부입니다.
updated_at TIMESTAMP $.attributes.updated_at 최종 수정 타임스탬프입니다.

목록

연락처/프로필의 정적 목록입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 list)입니다.
id 문자열 $.id 목록의 고유 식별자입니다.
name 문자열 $.attributes.name 연락처 목록의 이름입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
opt_in_process 문자열 $.attributes.opt_in_process 수신 동의 설정 (예: 'singleoptin' 또는 'doubleoptin')
tag_ids REPEATED STRING $.relationships.tags.data[*].id 이 목록에 할당된 태그의 ID입니다.
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id 이 목록에 프로필을 추가하여 트리거된 흐름의 ID입니다.

측정항목

추적할 수 있는 이벤트 유형입니다 (예: '이메일 수신').

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 metric)입니다.
id 문자열 $.id 고유 식별자 (예: 일반의 경우 6자 코드, 커스텀의 경우 긴 UUID)입니다.
name 문자열 $.attributes.name 인간이 읽을 수 있는 이름입니다 (예: 'Placed Order').
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
integration JSON $.attributes.integration 이 측정항목을 제공하는 통합에 관한 정보 (예: 이름, 카테고리, 이미지)입니다.
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id 이 측정항목에 의해 트리거된 흐름의 ID입니다.

프로필

속성 및 활동 내역이 포함된 포괄적인 고객 프로필

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 profile)입니다.
id 문자열 $.id 프로필의 고유한 Klaviyo ID입니다.
email 문자열 $.attributes.email 기본 이메일 주소입니다.
phone_number 문자열 $.attributes.phone_number E.164 형식의 전화번호입니다.
external_id 문자열 $.attributes.external_id 외부 시스템의 ID입니다.
first_name 문자열 $.attributes.first_name 이름
last_name 문자열 $.attributes.last_name 성
organization 문자열 $.attributes.organization 회사 또는 조직 이름입니다.
locale 문자열 $.attributes.locale 언어 설정
title 문자열 $.attributes.title 직책
image 문자열 $.attributes.image 프로필 이미지 URL입니다.
created TIMESTAMP $.attributes.created 프로필 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.
last_event_date TIMESTAMP $.attributes.last_event_date 가장 최근 이벤트의 타임스탬프입니다.
address1 문자열 $.attributes.location.address1 주소 입력란 1
address2 문자열 $.attributes.location.address2 주소 입력란 2
city 문자열 $.attributes.location.city 도시.
country 문자열 $.attributes.location.country 국가
latitude 문자열 $.attributes.location.latitude 위도 좌표입니다.
longitude 문자열 $.attributes.location.longitude 경도 좌표입니다.
region 문자열 $.attributes.location.region 주 또는 지역입니다.
zip 문자열 $.attributes.location.zip 우편번호
timezone 문자열 $.attributes.location.timezone 시간대입니다.
ip 문자열 $.attributes.location.ip 포드에 새 IP 주소가 할당됩니다
properties JSON $.attributes.properties 맞춤 속성 키-값 쌍입니다.
email_marketing_can_receive_email_marketing 부울 $.attributes.subscriptions.email.marketing.can_receive_email_marketing 프로필에서 이메일 마케팅을 수신할 수 있는지 여부입니다.
email_marketing_consent 문자열 $.attributes.subscriptions.email.marketing.consent 동의 상태 (예: SUBSCRIBED, UNSUBSCRIBED)
email_marketing_consent_timestamp TIMESTAMP $.attributes.subscriptions.email.marketing.consent_timestamp 동의가 제공된 시간입니다.
email_marketing_last_updated TIMESTAMP $.attributes.subscriptions.email.marketing.last_updated 이메일 동의가 마지막으로 업데이트된 시간입니다.
email_marketing_method 문자열 $.attributes.subscriptions.email.marketing.method 동의 방법 (예: FORM)입니다.
email_marketing_method_detail 문자열 $.attributes.subscriptions.email.marketing.method_detail 메서드의 특정 소스입니다.
email_marketing_custom_method_detail 문자열 $.attributes.subscriptions.email.marketing.custom_method_detail 동의 방법에 대한 맞춤 세부정보입니다.
email_marketing_double_optin 부울 $.attributes.subscriptions.email.marketing.double_optin 이중 수신 동의가 완료되었는지 여부입니다.
sms_marketing_can_receive_sms_marketing 부울 $.attributes.subscriptions.sms.marketing.can_receive_sms_marketing 프로필에서 SMS 마케팅을 수신할 수 있는지 여부입니다.
sms_marketing_consent 문자열 $.attributes.subscriptions.sms.marketing.consent SMS 동의 상태입니다.
sms_marketing_consent_timestamp TIMESTAMP $.attributes.subscriptions.sms.marketing.consent_timestamp SMS 동의가 제공된 시점입니다.
sms_marketing_last_updated TIMESTAMP $.attributes.subscriptions.sms.marketing.last_updated SMS 동의가 마지막으로 업데이트된 시간입니다.
sms_marketing_method 문자열 $.attributes.subscriptions.sms.marketing.method SMS 동의 방법
sms_marketing_method_detail 문자열 $.attributes.subscriptions.sms.marketing.method_detail SMS 동의 방법의 세부정보입니다.
sms_transactional_can_receive_sms_transactional 부울 $.attributes.subscriptions.sms.transactional.can_receive_sms_transactional 프로필에서 거래 SMS를 수신할 수 있는지 여부입니다.
sms_transactional_consent 문자열 $.attributes.subscriptions.sms.transactional.consent 거래 SMS 동의 상태입니다.
sms_transactional_consent_timestamp TIMESTAMP $.attributes.subscriptions.sms.transactional.consent_timestamp 거래 동의가 제공된 시점입니다.
sms_transactional_last_updated TIMESTAMP $.attributes.subscriptions.sms.transactional.last_updated 거래 상태가 마지막으로 업데이트된 시간입니다.
sms_transactional_method 문자열 $.attributes.subscriptions.sms.transactional.method 거래 SMS 방법입니다.
sms_transactional_method_detail 문자열 $.attributes.subscriptions.sms.transactional.method_detail 거래 SMS 방법 세부정보입니다.
mobile_push_can_receive_push_marketing 부울 $.attributes.subscriptions.mobile_push.marketing.can_receive_push_marketing 프로필에서 푸시 마케팅을 수신할 수 있는지 여부입니다.
mobile_push_consent 문자열 $.attributes.subscriptions.mobile_push.marketing.consent 푸시 동의 상태
mobile_push_consent_timestamp TIMESTAMP $.attributes.subscriptions.mobile_push.marketing.consent_timestamp 푸시 동의가 부여된 시간입니다.
predictive_analytics_historic_number_of_orders FLOAT $.attributes.predictive_analytics.historic_number_of_orders 총 이전 주문 수입니다.
predictive_analytics_predicted_number_of_orders FLOAT $.attributes.predictive_analytics.predicted_number_of_orders 예측된 향후 주문
predictive_analytics_average_days_between_orders FLOAT $.attributes.predictive_analytics.average_days_between_orders 주문 간 평균 일수입니다.
predictive_analytics_average_order_value FLOAT $.attributes.predictive_analytics.average_order_value 과거 평균 주문 금액입니다.
predictive_analytics_historic_clv FLOAT $.attributes.predictive_analytics.historic_clv 과거 고객 평생 가치
predictive_analytics_predicted_clv FLOAT $.attributes.predictive_analytics.predicted_clv 예상 고객 평생 가치
predictive_analytics_total_clv FLOAT $.attributes.predictive_analytics.total_clv 과거 + 예측 CLV
predictive_analytics_churn_probability FLOAT $.attributes.predictive_analytics.churn_probability 이탈 가능성 (0~1)입니다.
predictive_analytics_expected_date_of_next_order TIMESTAMP $.attributes.predictive_analytics.expected_date_of_next_order 다음 주문의 예상 날짜입니다.
email_marketing_suppression_reason REPEATED JSON $.attributes.subscriptions.email.marketing.suppression[*] 이메일 전송이 중단된 이유 (예: 반송)
email_marketing_list_suppressions_reason REPEATED JSON $.attributes.subscriptions.email.marketing.list_suppressions[*] 목록별 제외 이유입니다.
push_tokens_ids REPEATED STRING $.relationships.push-tokens.data[*].id 연결된 푸시 토큰 ID입니다.

리뷰

고객이 제출한 제품 리뷰입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 review)입니다.
id 문자열 $.id 리뷰의 고유 식별자입니다.
email 문자열 $.attributes.email 검토자의 이메일입니다.
value 문자열 $.attributes.status.value 상태 값 (예: 게시됨, 거부됨)
reason 문자열 $.attributes.status.rejection_reason.reason 거부 사유(해당하는 경우)
status_explanation 문자열 $.attributes.status.rejection_reason.status_explanation 상태에 대한 자세한 설명입니다.
verified 부울 $.attributes.verified 구매가 확인되었는지 여부입니다.
review_type 문자열 $.attributes.review_type 리뷰 유형 (예: 제품 리뷰)
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
images REPEATED STRING $.attributes.images[*] 리뷰에 첨부된 이미지의 URL입니다.
product_url 문자열 $.attributes.product.url 리뷰한 제품의 URL입니다.
product_name 문자열 $.attributes.product.name 제품 이름입니다.
product_image_url 문자열 $.attributes.product.image_url 제품의 이미지 URL입니다.
product_external_id 문자열 $.attributes.product.external_id 제품의 외부 ID입니다.
rating 정수 $.attributes.rating 평점입니다.
author 문자열 $.attributes.author 리뷰 작성자의 이름입니다.
content 문자열 $.attributes.content 리뷰의 텍스트 콘텐츠입니다.
title 문자열 $.attributes.title 리뷰 제목입니다.
smart_quote 문자열 $.attributes.smart_quote 리뷰에서 강조 표시된 인용문입니다.
public_reply_content 문자열 $.attributes.public_reply.content 판매자의 공개 답글 내용입니다.
public_reply_author 문자열 $.attributes.public_reply.author 답글 작성자입니다.
public_reply_updated 문자열 $.attributes.public_reply.updated 답글 업데이트의 타임스탬프입니다.
event_ids REPEATED STRING $.relationships.events.data[*].id 연결된 이벤트 ID입니다.

세그먼트

특정 기준에 따른 동적 프로필 그룹입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 segment)입니다.
id 문자열 $.id 세그먼트의 고유 식별자입니다.
name 문자열 $.attributes.name 세그먼트 이름입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
is_active 부울 $.attributes.is_active 세그먼트가 활성 상태인지 여부입니다.
is_processing 부울 $.attributes.is_processing 세그먼트가 처리 중인지 여부입니다.
is_starred 부울 $.attributes.is_starred 세그먼트에 별표표시/즐겨찾기 표시가 있는지 여부입니다.
tag_ids REPEATED STRING $.relationships.tags.data[*].id 연결된 태그의 ID입니다.
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id 이 세그먼트로 트리거된 흐름의 ID입니다.
condition_groups REPEATED ConditionGroup $.attributes.definition.condition_groups[*] 세그먼트를 정의하는 논리 조건 그룹입니다.

ConditionGroup

필드 이름 유형 JSON 경로 설명
conditions REPEATED 조건 conditions[*] 그룹 내 개별 조건 목록입니다.

조건

필드 이름 유형 JSON 경로 설명
type 문자열 type 조건 유형 (예: profile-property)입니다.
value JSON N/A 조건 값/구성입니다.

태그

캠페인, 흐름, 목록을 정리하는 데 사용되는 태그입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 tag)입니다.
id 문자열 $.id 고유 태그 식별자입니다.
name 문자열 $.attributes.name 태그 이름입니다.
tag_group_id 문자열 $.relationships.tag-group.data.id 이 태그가 속한 태그 그룹의 ID입니다.

템플릿

이메일 및 메시지 템플릿

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 template)입니다.
id 문자열 $.id 고유 식별자입니다.
name 문자열 $.attributes.name 템플릿 이름입니다.
editor_type 문자열 $.attributes.editor_type 사용된 편집기 (예: 드래그 앤 드롭)
html 문자열 $.attributes.html HTML 콘텐츠
text 문자열 $.attributes.text 템플릿의 텍스트 버전입니다.
amp 문자열 $.attributes.amp 템플릿의 AMP 버전입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.

WebFeeds

메시지에 콘텐츠를 채우는 데 사용되는 웹 피드입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 web-feed)입니다.
id 문자열 $.id 고유 식별자입니다.
name 문자열 $.attributes.name 피드 이름입니다.
url 문자열 $.attributes.url 피드 소스 URL입니다.
request_method 문자열 $.attributes.request_method HTTP 메서드 (GET/POST)
content_type 문자열 $.attributes.content_type 콘텐츠 유형 (예: JSON)
status 문자열 $.attributes.status 피드의 상태입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.

DataSources

Klaviyo에 통합된 데이터 소스입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 data-source)입니다.
id 문자열 $.id 고유 식별자입니다.
title 문자열 $.attributes.title 데이터 소스의 제목입니다.
visibility 문자열 $.attributes.visibility 공개 상태 수준입니다.
description 문자열 $.attributes.description 설명 텍스트

캠페인

목록 또는 세그먼트로 전송되는 마케팅 캠페인

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 campaign)입니다.
id 문자열 $.id 고유 식별자입니다.
name 문자열 $.attributes.name 캠페인 이름입니다.
status 문자열 $.attributes.status 캠페인 상태 (예: 전송됨, 예약 중)
archived 부울 $.attributes.archived 캠페인이 보관처리되었는지 여부입니다.
included REPEATED STRING $.attributes.audiences.included 포함된 목록/세그먼트의 ID입니다.
excluded REPEATED STRING $.attributes.audiences.excluded 제외된 목록/세그먼트의 ID입니다.
send_options JSON $.attributes.send_options 전송 구성 (예: 스마트 전송)
tracking_options JSON $.attributes.tracking_options 추적 구성 (예: utm 매개변수)입니다.
send_strategy JSON $.attributes.send_strategy 배송 기간 전략입니다.
created_at TIMESTAMP $.attributes.created_at 생성 타임스탬프입니다.
scheduled_at TIMESTAMP $.attributes.scheduled_at 캠페인이 전송되도록 예약된 시간입니다.
updated_at TIMESTAMP $.attributes.updated_at 최종 업데이트 타임스탬프입니다.
send_time TIMESTAMP $.attributes.send_time 실제 전송 시간입니다.
tag_ids REPEATED STRING $.relationships.tags.data[*].id 연결된 태그의 ID입니다.
campaign_message_ids REPEATED STRING $.relationships.campaign-messages.data[*].id 이 캠페인에 포함된 메시지의 ID입니다.

CampaignMessages

캠페인 내 개별 메시지 (이메일/SMS)

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형 (항상 campaign-message)입니다.
id 문자열 $.id 고유 식별자입니다.
definition JSON $.attributes.definition 메시지 콘텐츠 및 구성
send_times REPEATED JSON $.attributes.send_times[*] 전송 예약 시간
created_at TIMESTAMP $.attributes.created_at 생성 타임스탬프입니다.
updated_at TIMESTAMP $.attributes.updated_at 최종 업데이트 타임스탬프입니다.
campaign_id 문자열 $.relationships.campaign.data.id 상위 캠페인의 ID입니다.
template_id 문자열 $.relationships.template.data.id 사용된 템플릿의 ID입니다.
image_id 문자열 $.relationships.image.data.id 첨부된 이미지의 ID입니다.

카테고리

카탈로그의 제품 카테고리입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다.
id 문자열 $.id 고유 식별자입니다.
name 문자열 $.attributes.name 카테고리 이름입니다.
external_id 문자열 $.attributes.external_id 외부 시스템 ID입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.

항목

카탈로그의 개별 제품 또는 상품입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다.
id 문자열 $.id 고유 식별자입니다.
external_id 문자열 $.attributes.external_id 외부 시스템 ID입니다.
title 문자열 $.attributes.title 항목 제목/이름입니다.
description 문자열 $.attributes.description 설명이 있습니다.
price FLOAT $.attributes.price 상품 가격.
url 문자열 $.attributes.url 항목의 URL입니다.
image_full_url 문자열 $.attributes.image_full_url 원본 크기 이미지의 URL입니다.
image_thumbnail_url 문자열 $.attributes.image_thumbnail_url 썸네일 이미지의 URL입니다.
images REPEATED STRING $.attributes.images[*] 추가 이미지 URL 목록입니다.
custom_metadata JSON $.attributes.custom_metadata 커스텀 메타데이터 키-값입니다.
published 부울 $.attributes.published 간행물 상태입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.
variants_ids REPEATED STRING $.relationships.variants.data[*].id 이 상품의 옵션 ID입니다.

변형

카탈로그 항목의 특정 옵션 (예: 크기, 색상)

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다.
id 문자열 $.id 고유 식별자입니다.
external_id 문자열 $.attributes.external_id 외부 시스템 ID입니다.
title 문자열 $.attributes.title 변형 제목입니다.
description 문자열 $.attributes.description 설명이 있습니다.
sku 문자열 $.attributes.sku 재고 관리 단위입니다.
inventory_policy FLOAT $.attributes.inventory_policy 인벤토리 관리 정책입니다.
inventory_quantity FLOAT $.attributes.inventory_quantity 현재 재고 수량입니다.
price FLOAT $.attributes.price 가격
url 문자열 $.attributes.url 변형 URL입니다.
image_full_url 문자열 $.attributes.image_full_url 전체 이미지 URL 사용 가능 여부 (불리언)
image_thumbnail_url 문자열 $.attributes.image_thumbnail_url 썸네일 이미지 URL입니다.
images REPEATED STRING $.attributes.images[*] 이미지 목록입니다.
published 부울 $.attributes.published 간행물 상태입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 업데이트 타임스탬프입니다.

FlowActions

플로우와 연결된 플로우 작업입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 flow-action입니다.
id 문자열 $.id 흐름 작업의 고유 식별자입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
message_id 문자열 $.attributes.definition.id 작업 메시지 정의의 고유 ID입니다.
message_temporary_id 문자열 $.attributes.definition.temporary_id 메시지 정의에 할당된 임시 ID입니다.
message_type 문자열 $.attributes.definition.type 메시지 유형(예: email, sms)
condition_groups REPEATED ConditionGroup $.attributes.definition.data.action_output_filter.condition_groups[*] 흐름 작업 출력 필터와 연결된 조건입니다.
next_if_true 문자열 $.attributes.definition.links.next_if_true 조건이 true로 평가되는 경우 다음 흐름 작업의 ID입니다.
next_if_false 문자열 $.attributes.definition.links.next_if_false 조건이 false로 평가되는 경우 다음 흐름 작업의 ID입니다.

FormVersions

지정된 양식의 양식 버전입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 form-version입니다.
id 문자열 $.id 양식 버전의 고유 식별자입니다.
form_type 문자열 $.attributes.form_type 양식 유형(예: popup, embed, banner)
variation_name 문자열 $.attributes.variation_name 양식 변형의 이름입니다.
ab_test JSON $.attributes.ab_test A/B 테스트 구성 및 대안 설정
status 문자열 $.attributes.status 양식 버전의 운영 상태입니다(예: draft, live).
created_at TIMESTAMP $.attributes.created_at 생성 타임스탬프입니다.
updated_at TIMESTAMP $.attributes.updated_at 최종 수정 타임스탬프입니다.

PushTokens

푸시 알림을 위한 모바일 앱 프로필과 연결된 푸시 토큰입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 push-token입니다.
id 문자열 $.id 푸시 토큰의 고유 식별자입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
token 문자열 $.attributes.token 기기 푸시 토큰 문자열입니다.
enablement_status 문자열 $.attributes.enablement_status 푸시 알림 사용 설정 상태(예: AUTHORIZED, UNAUTHORIZED)
platform 문자열 $.attributes.platform 모바일 플랫폼(예: ios, android)
vendor 문자열 $.attributes.vendor 공급업체 서비스 제공업체(예: apns, fcm)
background 문자열 $.attributes.background 푸시 알림의 백그라운드 새로고침 상태입니다.
recorded_date TIMESTAMP $.attributes.recorded_date 푸시 토큰이 기록된 날짜입니다.
metadata JSON $.attributes.metadata 커스텀 기기 또는 푸시 토큰 메타데이터입니다.
profile_id 문자열 $.relationships.profile.data.id 이 푸시 토큰과 연결된 고객 프로필의 ID입니다.

TagGroups

태그를 정리하고 분류하는 데 사용되는 태그 그룹입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 tag-group입니다.
id 문자열 $.id 태그 그룹의 고유 식별자입니다.
name 문자열 $.attributes.name 태그 그룹의 이름입니다.
exclusive 부울 $.attributes.exclusive 이 그룹 내의 태그가 상호 배타적인지 여부입니다.
default 부울 $.attributes.default 계정의 기본 태그 그룹인지 여부입니다.

UniversalContent

메시지 및 템플릿에 재사용 가능한 범용 콘텐츠 블록입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 template-universal-content입니다.
id 문자열 $.id 범용 콘텐츠 블록의 고유 식별자입니다.
name 문자열 $.attributes.name 범용 콘텐츠 블록의 이름입니다.
definition_content_type 문자열 $.attributes.definition.content_type 정의의 콘텐츠 유형입니다(예: block, template).
definition_type 문자열 $.attributes.definition.type 콘텐츠의 구성요소 유형입니다(예: text, button, image).
definition_data JSON $.attributes.definition.data 콘텐츠 정의의 구조적 데이터 및 페이로드입니다.
created TIMESTAMP $.attributes.created 생성 타임스탬프입니다.
updated TIMESTAMP $.attributes.updated 최종 수정 타임스탬프입니다.
screenshot_status 문자열 $.attributes.screenshot_status 미리보기 스크린샷 생성 상태입니다(예: completed, pending).
screenshot_url 문자열 $.attributes.screenshot_url 콘텐츠 미리보기 스크린샷의 공개 URL입니다.

MetricProperties

특정 측정항목에 정의된 속성 및 구조적 속성입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 metric-property입니다.
id 문자열 $.id 측정항목 속성의 고유 식별자입니다.
sample_values JSON $.attributes.sample_values 이 측정항목 속성에 대해 캡처된 샘플 데이터 값입니다.
label 문자열 $.attributes.label 인간이 읽을 수 있는 속성 라벨입니다.
property 문자열 $.attributes.property 이벤트 속성의 키 이름입니다.
inferred_type 문자열 $.attributes.inferred_type 이 속성에 대해 Klaviyo에서 추론한 데이터 유형입니다(예: string, boolean, numeric).
metric_id 문자열 $.relationships.metric.data.id 상위 측정항목 정의의 ID입니다.

TrackingSettings

캠페인 및 흐름의 계정 수준 UTM 추적 매개변수입니다.

필드 이름 유형 JSON 경로 설명
type 문자열 $.type 리소스 유형입니다. 항상 tracking-setting입니다.
id 문자열 $.id 추적 설정의 고유 식별자입니다.
auto_add_parameters 부울 $.attributes.auto_add_parameters 메시지 링크에 UTM 매개변수가 자동으로 추가되는지 여부입니다.
utm_source UtmParameter $.attributes.utm_source 흐름 및 캠페인의 _utm_source parameter 구성입니다.
utm_medium UtmParameter $.attributes.utm_medium 흐름 및 캠페인의 _utm_medium parameter 구성입니다.
utm_campaign UtmParameter $.attributes.utm_campaign 흐름 및 캠페인의 _utm_campaign 매개변수 구성입니다.
utm_id UtmParameter $.attributes.utm_id 흐름 및 캠페인의 _utm_id 매개변수 구성입니다.
utm_term UtmParameter $.attributes.utm_term 흐름 및 캠페인의 _utm_term 매개변수 구성입니다.
custom_parameters REPEATED CustomParameter $.attributes.custom_parameters 캠페인 및 흐름 링크에 추가된 맞춤 추적 매개변수입니다.

UtmParameter

필드 이름 유형 JSON 경로 설명
flow ParameterContext flow 흐름의 UTM 매개변수 설정 컨텍스트입니다.
campaign ParameterContext campaign 캠페인의 UTM 매개변수 설정 컨텍스트입니다.

ParameterContext

필드 이름 유형 JSON 경로 설명
type 문자열 type 리소스 유형입니다.
value 문자열 value 매개변수 템플릿 값 또는 속성 키(예: emailsubject, campaignid)

CustomParameter

필드 이름 유형 JSON 경로 설명
flow ParameterContext flow 흐름의 맞춤 추적 매개변수 컨텍스트입니다.
campaign ParameterContext campaign 캠페인의 맞춤 추적 매개변수 컨텍스트입니다.
name 문자열 name 맞춤 추적 매개변수의 이름입니다.