CSV 업로드를 사용하여 지오펜싱을 가져오는 방법
학습 내용
CSV 파일을 업로드해 여러 지오펜스 위치를 Klaviyo로 가져오는 방법을 알아보세요.
목차
CSV 업로드를 사용하여 지오펜싱을 가져오려면:
CSV 파일을 생성하세요
업로드하기 전에, 올바른 형식의 CSV 파일이 필요해요. 파일의 각 행은 지오펜스 위치 1개를 나타내요. 각 위치에는 다음에 대한 열이 필요해요:
- 이름
- 주소 또는 위도 및 경도
다음 선택적 열 중 어떤 것이든 포함할 수도 있어요:
- 반경 — 지오펜스 영역의 크기(미터)
- 설명
- 상태 — 활성 또는 비활성, 이벤트를 트리거하기 위해 지오펜스가 활성화되어 있는지 여부
- 입장 — true 또는 false, 프로필이 지오펜스에 들어올 때 이벤트를 트리거할지 여부
- 종료 — true 또는 false, 프로필이 지오펜스를 벗어날 때 이벤트를 트리거할지 여부

가져오기 플로우에서 미리 서식이 지정된 템플릿을 바로 다운로드할 수 있어요. 오디언스 > 지오펜싱 > 위치 가져오기 로 이동한 다음 나만의 템플릿 만들기를 선택하세요. 표시되는 모달에서 포함할 열을 선택한 다음 다운로드를 선택하세요. 다운로드한 파일을 Excel 또는 Google Sheets 같은 스프레드시트 도구에서 열고 위치 데이터를 입력하세요. 그런 다음 파일을 .csv로 저장하세요, .text/csv, 또는.applications/csv.

CSV 파일 업로드
파일이 준비되면:
- 오디언스 > 지오펜싱으로 이동해 주세요.
- 위치 가져오기를 선택하세요.
- 지오펜싱을 만들 위치 업로드 화면에서 파일을 업로드 영역으로 끌어다 놓거나, 파일 선택 을 클릭해 파일을 찾아보세요.
- 파일이 업데이트되면 다음을(를) 선택하세요.
- CSV 열을 Klaviyo의 지오펜스 필드에 매핑해 주세요.

- 모든 매핑이 올바르게 보이면 다음을 선택해 주세요.
- CSV에 포함되지 않았거나 특정 행에서 비어 있는 지오펜스 속성에 대해 기본값을 선택해 주세요.
- 화면 오른쪽에 있는 지도에서 지오펜스 반경을 시각적으로 미리 볼 수 있어요. 지도 위에 있는 검색창에 예시 주소를 입력하면 실제 위치에서 지오펜스가 대략 얼마나 크게 표시될지 확인할 수 있어요.

- 기본값을 설정한 후 가져오기를 선택하세요.
가져오기 기록 검토
가져오기를 시작한 후에는 가져오기 기록에서 상태를 추적할 수 있어요. 각 항목에는 가져오기 날짜와 시간, 가져온 위치 수, 그리고 결과가 표시돼요:
- 완료 ― 모든 위치를 성공적으로 가져왔습니다.
- 부분 완료 — 일부 위치는 가져왔지만 다른 위치는 실패했어요. 가져오지 못한 행의 CSV를 받으려면 실패한 행 다운로드 를 선택한 다음, 해당 행을 수정하고 다시 업로드할 수 있어요.
- 실패 ― 가져온 위치가 없습니다

가져오기는 파일 크기에 따라 몇 초에서 몇 분까지 걸릴 수 있어요. 페이지에서 다른 곳으로 이동해도 가져오기는 백그라운드에서 계속 진행돼요.
모범 사례
- 위치 이름은 설명적이고 일관되게 유지해 주세요. Klaviyo uses the Name field as the primary identifier, so clear names make it easier to manage your geofences later.
- 건물의 특정 출입구나 대규모 단지 내의 위치처럼 정확한 위치 지정이 필요할 때는 주소 대신 위도/경도 열을 사용해 주세요.
- 대량으로 가져오기 전에 두세 개의 위치로 구성된 작은 테스트 파일로 시작해 보세요. 이 방법을 사용하면 전체 업로드를 진행하기 전에 열 매핑과 기본값이 올바른지 확인할 수 있어요.
- 부분적으로 가져온 경우에는 가져오기 실패 행 보고서를 확인해 주세요. 일반적인 문제로는 형식이 잘못된 주소, 상태 또는 입장/퇴장 열의 지원되지 않는 값, 또는 필수 필드 누락이 있어요.
결과
가져오기에 성공하면 설정한 상태 및 설정과 함께 Klaviyo의 위치 섹션에 위치가 표시돼요. 이 지오펜싱을 플로우와 세그먼트에서 사용해 프로필의 위치를 기반으로 메시지를 트리거할 수 있어요.
추가 자료
- 지오펜스 시작하기
스토어 근처에 있는 프로필에 메시지를 보내 스토어 내 참여를 유도할 수 있도록 Klaviyo에서 지오펜스를 만드는 방법을 알아보세요. 이 문서에서는 첫 번째 지오펜스를 만드는 방법을 안내합니다.