CSV 업로드를 사용하여 지오펜싱을 가져오는 방법

학습 내용

CSV 파일을 업로드해 여러 지오펜스 위치를 Klaviyo로 가져오는 방법을 알아보세요.

목차

CSV 업로드를 사용하여 지오펜싱을 가져오려면:

1. CSV 파일을 생성합니다.
2. CSV 파일을 업로드합니다.
3. 가져오기 내역을 검토합니다.

시작하기 전에 알아야 할 것

아직 지오펜스가 없으면 대상 > 지오펜싱으로 이동한 다음 지오펜스 만들기를 선택해 주세요. 첫 번째 위치를 만들려면 지오펜싱 시작하기를 따라 진행한 다음, 다시 돌아와 나머지 위치를 가져오세요.

CSV 파일을 생성하세요

업로드하기 전에, 헤더 행이 있는 50 MB 이하의 CSV 파일을 준비해 주세요. 각 데이터 행은 지오펜스 위치 1개를 나타내요. 각 위치에는 다음을 위한 열이 필요해요:

• 이름
• 주소, 또는 5개 열 모두(도로명, 도시, 주, 국가 및 우편번호), 또는 위도와 경도 모두

다음 선택적 열 중 어떤 것이든 포함할 수도 있어요:

• 반경 — 중심에서 지오펜스 가장자리까지의 거리로, 50～10,000m입니다
• 설명
• 상태 — 활성 또는 비활성, 이벤트를 트리거하기 위해 지오펜스가 활성화되어 있는지 여부
• 입장 — true 또는 false, 프로필이 지오펜스에 들어올 때 이벤트를 트리거할지 여부
• 종료 — true 또는 false, 프로필이 지오펜스를 벗어날 때 이벤트를 트리거할지 여부

CSV에서든, 가져오기 중에 선택한 기본값을 통해서든 각 위치에 대해 Enter 또는 Exit 중 최소 하나를 true로 설정해 주세요. 둘 다 false로 설정된 행은 가져오지 않습니다.

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

CSV 파일 업로드

파일이 준비되면:

1. 오디언스 > 지오펜싱으로 이동해 주세요.
2. 위치 가져오기를 선택하세요.
3. 지오펜싱을 만들 위치 업로드 화면에서 파일을 업로드 영역으로 끌어다 놓거나, 파일 선택 을 클릭해 파일을 찾아보세요.
4. 파일을 선택한 후 다음을 선택해 업로드해 주세요.
5. CSV 열을 Klaviyo의 지오펜스 필드에 매핑해 주세요. 이름 및 위에 나열된 위치 형식 중 하나를 매핑하세요. 각 지오펜스 필드는 1개의 열에만 매핑할 수 있어요. 가져오지 않으려는 열은 열 무시를 선택하거나 체크박스를 선택 해제해 주세요.

6. 모든 매핑이 올바르게 보이면 다음을 선택해 주세요.
7. 기본값 확인에서 진입 이벤트, 이탈 이벤트, 상태, 반경의 값을 선택해 주세요. 해당하는 CSV 값이 누락되었거나 비어 있을 때 적용돼요. 초기 기본값은 진입 이벤트: True, 이탈 이벤트: False, 상태: 활성, 반경: 500미터예요.

화면 오른쪽에 있는 지도에서 지오펜스 반경을 시각적으로 미리 볼 수 있어요. 지도 위에 있는 검색창에 예시 주소를 입력하면 실제 위치에서 지오펜스가 대략 얼마나 크게 표시될지 확인할 수 있어요.

1. 기본값을 설정한 후 가져오기를 선택하세요.

가져오기 기록 검토

가져오기를 선택하면 가져오기 기록이 자동으로 열려요. 나중에 다시 돌아오려면 대상 > 지오펜싱으로 이동한 다음 가져오기 기록을 선택하세요. 지난 7일 동안의 가져오기가 표시되며, 날짜와 시간, 가져온 위치 수, 상태가 포함돼요. 결과가 표시되기 전에는 가져오기가 대기 중 또는 처리 중 상태일 수 있어요:

• 완료 ― 모든 위치를 성공적으로 가져왔습니다.
• 부분 완료 — 모든 위치가 가져오기되지 않았거나 계정이 지오펜스 한도에 도달해 가져오기가 중지되었어요. 가져오기되지 않은 행의 CSV를 받으려면 실패한 행 다운로드를 선택하세요. 그런 다음 내용을 수정해 다시 업로드할 수 있어요.
• 실패 ― 가져오기를 성공적으로 완료할 수 없었어요. 일부 위치는 이미 생성되었을 수 있으니, 다시 시도하기 전에 가져온 개수를 확인해 주세요. 거부된 행에 대한 보고서를 확인하려면 실패한 행 다운로드를 선택해 주세요.

가져오기는 파일 크기에 따라 몇 초에서 몇 분까지 걸릴 수 있어요. 페이지에서 다른 곳으로 이동해도 가져오기는 백그라운드에서 계속 진행돼요.

모범 사례

• 지오펜싱을 쉽게 관리할 수 있도록 위치 이름은 설명적이고 일관되게 지정해 주세요. 가져오기를 하면 새 지오펜스가 생성되며, 기존 이름과 일치하더라도 해당 지오펜스는 업데이트되지 않아요. 기존 지오펜스 또는 가져오기에서 이전 행과 위도, 경도, 반경이 동일한 행은 중복으로 간주되어 건너뛰어요.
• 건물의 특정 출입구나 대규모 단지 내의 위치처럼 정확한 위치 지정이 필요할 때는 주소 대신 위도/경도 열을 사용해 주세요.
• 대량 배치를 가져오기 전에 위치 2~3개로 구성된 작은 테스트 파일로 시작해 보세요. 이 방법을 사용하면 전체 업로드를 진행하기 전에 열 매핑과 기본값이 올바른지 확인할 수 있어요.
• 일부만 가져오기되었거나 가져오기에 실패한 후 실패한 행 보고서를 검토해 주세요. 거부된 각 행의 validation_errors 열을 확인한 다음 해당 행을 수정하고 다시 업로드해 주세요. 문제에는 필수 필드 누락, 위치를 찾을 수 없는 주소, 범위를 벗어난 좌표 또는 반경 값, 중복된 지오펜싱, 또는 Enter와 Exit가 모두 false로 설정된 경우가 포함됩니다.

결과

가져오기가 성공적으로 완료되면 가져오기 기록에서 닫기를 선택해 대상 > 지오펜싱으로 돌아가세요. 가져온 지오펜싱은 설정한 상태와 설정값으로 표시돼요. 위치 기반 메시징을 위해 플로우와 세그먼트에서 지오펜스 이벤트를 사용할 수 있어요.

추가 자료