프로필 및 이벤트 속성 참조를 위한 허용되는 날짜 및 타임스탬프 형식

학습 내용

API를 통해 전송되거나 CSV 업로드에 포함된 이벤트 및 프로필 속성에서 Klaviyo가 인식하는 날짜 및 시간 형식을 확인해 보세요. 이러한 형식은 속성 값에 적용돼요. 이벤트 생성 API의 time 필드에는 2014-09-30T13:34:08Z과 같은 ISO 8601 타임스탬프를 사용해 주세요.

허용되는 날짜 및 타임스탬프 형식

시간 없이 날짜만 입력할 때는 YYYY-MM-DD, MM/DD/YYYY 또는 MM/DD/YY를 사용해 주세요. 슬래시(/)로 구분된 날짜는 월/일/년 형식을 사용해요. 자정 타임스탬프가 필요하면 시간은 00:00:00을 사용해 주세요. 시간을 추가하지 않고 캘린더 날짜를 유지하려면 아래의 CSV 데이터 유형 안내를 따르세요.

다음 예시는 2014년 9월 30일에 대해 지원되는 타임스탬프 형식을 보여 줍니다. 서로 다른 시간, 시간대 오프셋, 정밀도 수준을 사용해요:

2014-09-30 13:34:08

2014-09-30 13:34:08+00:00

09/30/2014 13:34:08

09/30/14 13:34:08

09/30/2014 13:34

09/30/14 13:34

2014-09-30T13:34:08

2014-09-30 13:34:08.000001

2014-09-30T13:34:08.000001

2014-09-30 13:34:08.000001-04:00

1412098448 (초 단위의 Unix 시간)

스프레드시트를 CSV 파일로 변환하기 전에 날짜 형식을 다시 지정하는 데 도움이 필요하다면, CSV 파일용 날짜 형식 지정 문서를 확인해 주세요.

CSV 업로드에 사용할 데이터 유형을 선택하세요

사용자 지정 프로필 속성을 가져올 때는 Data Type 열에서 타임스탬프(초 단위 Unix 시간 포함)에 대해 Date를 선택해 주세요. 타임스탬프에 시간대 오프셋이 없으면 Klaviyo에서는 이를 UTC로 처리해요.

시간 없이 날짜를 가져오면 Date를 선택할 때 기본 시간으로 UTC 기준 자정이 적용돼요. 이로 인해 프로필의 시간대에 따라 date-property triggered 플로우에서 사용하는 캘린더 날짜가 달라질 수 있어요. 또는 프로필의 시간대를 알 수 없는 경우에는 계정의 시간대에 따라 달라질 수 있어요. 따라서 업로드할 값이 날짜(시간 없음)만 있는 경우에는 지원되는 날짜 전용 형식으로 유지하고 텍스트를 선택해 주세요.

아래는 올바른 날짜/시간 형식으로 업로드할 때 이 CSV 파일이 어떻게 보일 수 있는지 보여주는 예시예요.

Klaviyo에 CSV 파일을 업로드하는 방법에 대한 자세한 내용은 기존 목록에 구독자 추가하는 방법 문서를 확인해 주세요.

추가 자료