Klaviyo 데이터 모델 참조

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

계정

Klaviyo 계정 정보 및 메타데이터

표 이름: Accounts
엔드포인트: /accounts
Klaviyo API 참조: Get Accounts

필드 이름	유형	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`	언어 설정 (예: en-US)

쿠폰

할인 및 프로모션 쿠폰입니다.

테이블 이름: Coupons
엔드포인트: /coupons
Klaviyo API 참조: Get Coupons

필드 이름	유형	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

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

테이블 이름: CouponCode
엔드포인트: /coupon-codes
Klaviyo API 참조: Get Coupon Codes

필드 이름	유형	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입니다.

이벤트

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

표 이름: Events
엔드포인트: /events
Klaviyo API 참조: Get Events

필드 이름	유형	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입니다.

흐름

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

표 이름: Flows
엔드포인트: /flows
Klaviyo API 참조: Get Flows

필드 이름	유형	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입니다.

Forms

구독자 정보를 수집하는 가입 양식

표 이름: Forms
엔드포인트: /forms
Klaviyo API 참조: Get Forms

필드 이름	유형	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에 업로드된 이미지입니다.

표 이름: Images
엔드포인트: /images
Klaviyo API 참조: 이미지 가져오기

필드 이름	유형	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`	마지막 수정 타임스탬프입니다.

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

표 이름: 목록
엔드포인트: /lists
Klaviyo API 참조: 목록 가져오기

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

측정항목

추적할 수 있는 이벤트 유형 (예: 'Received Email')을 사용합니다.

표 이름: Metrics
엔드포인트: /metrics
Klaviyo API 참조: Get Metrics

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

프로필

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

테이블 이름: Profiles
엔드포인트: /profiles
Klaviyo API 참조: Get Profiles

필드 이름	유형	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 + 예측 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`	반복되는 JSON	`$.attributes.subscriptions.email.marketing.suppression[*`]	이메일 차단 이유 (예: 반송됨)
`email_marketing_list_suppressions_reason`	반복되는 JSON	`$.attributes.subscriptions.email.marketing.list_suppressions[*`]	목록별 차단 이유입니다.
`push_tokens_ids`	REPEATED STRING	`$.relationships.push-tokens.data[*].id`	연결된 푸시 토큰 ID입니다.

리뷰

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

표 이름: Reviews
엔드포인트: /reviews
Klaviyo API 참조: Get Reviews

필드 이름	유형	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입니다.

세그먼트

특정 기준에 기반한 프로필의 동적 그룹입니다.

표 이름: 세그먼트
엔드포인트: /segments
Klaviyo API 참조: Get Segments

필드 이름	유형	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`	반복 레코드	`$.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입니다.

템플릿

이메일 및 메시지 템플릿

표 이름: Templates
엔드포인트: /templates
Klaviyo API 참조: Get Templates

필드 이름	유형	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

메일의 콘텐츠를 채우는 데 사용되는 웹 피드입니다.

표 이름: WebFeeds
엔드포인트: /web-feeds
Klaviyo API 참조: Get Web Feeds

필드 이름	유형	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에 통합된 데이터 소스입니다.

표 이름: DataSources
엔드포인트: /data-sources
Klaviyo API 참조: Get Data Sources

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

캠페인

목록 또는 세그먼트로 전송된 마케팅 캠페인입니다.

표 이름: 캠페인
엔드포인트: /campaigns
Klaviyo API 참조: Get Campaigns

필드 이름	유형	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)

표 이름: CampaignMessages
엔드포인트: /campaign-messages
Klaviyo API 참조: Get Campaign Message

필드 이름	유형	JSON 경로	설명
`type`	문자열	`$.type`	리소스 유형 (항상 `campaign-message`)
`id`	문자열	`$.id`	고유 식별자입니다.
`definition`	JSON	`$.attributes.definition`	메시지 콘텐츠 및 구성
`send_times`	반복되는 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입니다.

카테고리

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

표 이름: Categories
엔드포인트: /catalog-categories
Klaviyo API 참조: Get Catalog Categories

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

항목

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

표 이름: Items
엔드포인트: /catalog-items
Klaviyo API 참조: Get Catalog Items

필드 이름	유형	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입니다.

변형

카탈로그 상품의 특정 옵션 (예: 사이즈, 색상)입니다.

표 이름: Variants
엔드포인트: /catalog-variants
Klaviyo API 참조: Get Catalog Variants

필드 이름	유형	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`	마지막 업데이트 타임스탬프입니다.