CSV 파일에서 지오존 가져오기

체인의 모든 매장이나 모든 픽업 지점과 같이 수백 개의 위치가 있는 경우, 지도에 하나씩 배치하는 것은 현실적이지 않습니다. 대신 스프레드시트에서 가져오세요.

파일 준비

파일에는 헤더 행과 위치당 하나의 행이 필요하며, 5MB를 초과해서는 안 됩니다. 이는 수만 개의 위치를 저장할 수 있는 공간으로, 단일 지오존 캠페인이 다루기에는 충분한 양입니다. 세 개의 열이 필요합니다.

파일에서는 range나 cooldown과 같은 짧은 헤더를 사용할 수 있습니다. 지오존 가져오기 화면의 매핑 드롭다운에서는 아래 레이블을 사용합니다(예: range → 범위, m).

파일의 열	매핑 대상	필수	참고
Name	이름	예	최대 64자.
Latitude	위도	예	-90에서 90 사이.
Longitude	경도	예	-180에서 180 사이.
Range	범위, m	아니요	미터, 50에서 100,000 사이. 기본 범위, m으로 대체됩니다.
Cooldown	쿨다운, s	아니요	초, 60에서 3,596,400(41일) 사이. 기본 쿨다운, s으로 대체됩니다.
Message	메시지	아니요	푸시 텍스트, 최대 1024자.
Cluster code	클러스터 코드	아니요	기존 클러스터 코드.
Preset code	프리셋 코드	아니요	기존 프리셋 코드.

모든 지오존은 보낼 내용이 필요하므로, 각 행은 메시지 또는 프리셋 중 하나를 가져야 합니다. 이는 행 자체의 열이나 가져오기 화면의 모든 존에 대한 메시지 / 모든 존에 대한 프리셋에서 가져올 수 있습니다. 행에 둘 다 있는 경우 프리셋이 우선합니다.

CSV 예시

다음은 두 개의 위치가 있는 geozones.csv 예시입니다. 두 번째 행은 range를 비워두었으므로 기본 범위, m이 적용됩니다:

name	latitude	longitude	range	message
Store Downtown	40.7128	-74.0060	200	Welcome to our store!
Pickup Point	51.5074	-0.1278		Your order is ready

geozones.csv의 일반 텍스트 형식 표현:

name,latitude,longitude,range,message
Store Downtown,40.7128,-74.0060,200,Welcome to our store!
Pickup Point,51.5074,-0.1278,,Your order is ready

Excel에서 내보낸 파일은 그대로 작동합니다

구분 기호는 파일에서 감지됩니다: 쉼표, 세미콜론 또는 탭. 쉼표는 좌표의 소수점 구분 기호로도 허용되므로, 세미콜론으로 구분된 내보내기에서 55,7558은 올바르게 읽힙니다. 따옴표로 묶인 필드에는 구분 기호와 줄 바꿈이 포함될 수 있습니다.

파일을 UTF-8로 저장하세요. Excel은 다른 이름으로 저장 대화 상자에서 이를 CSV UTF-8로 제공합니다. 지역 인코딩으로 저장된 파일은 라틴어가 아닌 이름이 깨진 문자로 표시됩니다. 바이트 순서 표식(BOM)은 괜찮습니다. 읽을 때 제거됩니다.

가져오는 방법

다음 단계에 따라 파일을 업로드하고 지오존을 생성하세요.

1. 지오 캠페인 페이지에서 CSV 가져오기를 클릭합니다. 지오존 가져오기 화면이 열립니다.

2. CSV 파일을 선택합니다.

3. 지오존 가져오기 화면에서 열을 매핑하고 기본값을 설정합니다.

각 CSV 열을 지오존 필드에 매핑합니다. 각 열 헤더 아래에서 드롭다운을 열고 해당 열이 채워야 할 필드를 선택합니다:

• Pushwoosh가 헤더를 잘못 매칭한 경우, 드롭다운에서 올바른 필드를 선택하세요.
• 열을 무시하려면 가져오지 않음으로 설정하세요.
• 최소한 이름, 위도, 경도를 매핑하세요.
• 파일에 해당 열이 있는 경우 범위, m, 쿨다운, s, 메시지, 클러스터 코드 또는 프리셋 코드를 매핑하세요.

참고

Pushwoosh는 name, store, title, lat, latitude, lng, lon, longitude, radius, range, cooldown, message, cluster, preset과 같은 일반적인 헤더 철자를 자동으로 매칭합니다.

파일이 제공하지 않는 값에 대한 기본값을 설정합니다:

• 기본 범위, m 및 기본 쿨다운, s. 파일에 범위나 쿨다운 열이 없거나 셀이 비어 있는 경우(예시의 “Pickup Point”처럼) 사용됩니다.
• 모든 존에 대한 클러스터. 클러스터를 선택하거나 클러스터 없음으로 둡니다.
• 모든 존에 대한 프리셋. 프리셋이 필요한 모든 행에 대한 선택적 푸시 프리셋입니다.
• 모든 존에 대한 메시지. 파일에 메시지 열이 없는 경우 사용됩니다. 이미 메시지가 있는 행은 자체 텍스트를 유지합니다.

4. 준비된 행과 건너뛴 행의 수를 확인합니다(예: 2개 행 준비됨, 0개 건너뜀). 필요한 경우 매핑이나 스프레드시트를 수정한 다음, 가져오지 않고 확인을 클릭합니다. Pushwoosh는 지오존을 생성하지 않고 전체 파일을 검증합니다. 거부된 행은 줄 번호와 이유와 함께 반환되므로, 스프레드시트를 수정하고 아무것도 절반만 작성된 상태로 남기지 않고 다시 시도할 수 있습니다.

5. 확인 결과가 올바르면 가져오기를 클릭합니다. 지오존은 배치로 생성됩니다. 결과 화면에는 생성된 지오존 수와 실패한 행이 보고됩니다.

가져온 지오존은 활성화됩니다

가져온 지오존은 활성 상태로 생성되며 즉시 푸시를 트리거하기 시작합니다. 아직 푸시를 보내지 않아야 하는 경우, 가져오기 후 각 지오존에 대해 일정을 설정하거나 지오 캠페인 목록에서 일시 중지하세요.

동일한 파일을 두 번 가져오면 모든 지오존의 두 번째 사본이 생성됩니다. 이름은 고유하지 않습니다. 실수를 수정하려면 가져온 지오존을 삭제하고 수정된 파일을 가져오세요.

행을 건너뛰는 이유

확인 또는 가져오기 중에 읽을 수 없는 행은 줄 번호와 함께 나열되고 건너뜁니다. 나머지는 계속 가져옵니다. 다음과 같은 경우 행을 건너뜁니다:

• 이름이 비어 있는 경우
• 위도 또는 경도가 숫자가 아니거나 위 표에 주어진 범위를 벗어나는 경우
• 범위가 숫자가 아니거나 50 ~ 100,000m 범위를 벗어나는 경우
• 쿨다운이 숫자가 아니거나 60 ~ 3,596,400초 범위를 벗어나는 경우
• 행에 메시지나 프리셋이 없는 경우

파일이 아닌 자체 시스템에서 지오존을 생성하려면 addGeoZone API 메서드를 사용하세요.