지오존 생성

지오존을 생성하여 캠페인이 트리거되는 위치와 사용자가 해당 지역에 들어왔을 때 발생하는 일(푸시 메시지, Customer Journey 이벤트 또는 둘 다)을 정의합니다.

캠페인 → 지역 캠페인으로 이동합니다. 지오존 생성을 클릭하여 시작합니다.

캠페인 이름 및 집계 통계 설정

캠페인 이름 필드에 최대 64자의 레이블을 입력합니다. 시내 상점 봄 세일과 같이 짧고 인식하기 쉽게 유지하세요.

선택적으로 집계 통계 필드에서 기존 캠페인을 선택합니다. 그러면 지역 캠페인 푸시는 해당 캠페인의 집계 메시지 통계에서 다른 터치포인트와 함께 계산됩니다.

진입 액션 선택

진입 액션 섹션에서 이러한 액션의 조합을 켭니다. 최소 하나는 켜두고, 둘 이상 켜져 있을 때는 각 이벤트 기반 액션에 다른 이벤트 이름을 지정합니다.

기존 지오존

이 기능이 출시되기 전에 지오존을 생성했다면, 푸시 보내기는 켜져 있고 모든 이벤트 기반 액션은 꺼져 있습니다. 지오존을 열고 저장하여 해당 조합을 변경하세요.

API를 통해 액션의 지속 시간이 0초로 설정된 지오존도 양식에서 해당 액션이 꺼진 것으로 표시됩니다.

이 비교를 사용하여 어떤 액션을 켤지 결정하세요:

액션	선택 시점	캠페인 예시	잘 어울리는 조합
푸시 보내기	Journey 없이 사람들이 도착하는 순간 메시지를 보게 하고 싶을 때	쇼핑객이 가게에 들어서는 순간 “오늘 20% 할인” 푸시	체류 이벤트 발생, 머물렀던 사람들을 나중에 후속 메시지를 위해 플래그 지정할 수 있습니다
이벤트 발생	단 하나의 푸시가 아닌, 더 긴 자동화된 흐름(시간이 지남에 따라 여러 메시지)을 시작하고 싶을 때	PW_GeozoneEntered가 Journey를 시작합니다: 환영 메시지 → 1일 대기 → 로열티 카드 알림	이탈 이벤트 발생, 사람이 실제로 떠났는지 확인한 후에만 Journey가 종료되도록 합니다
이탈 이벤트 발생	사람이 떠났다는 것을 확실히 알고 싶을 때. 이 확인은 늦게 도착할 수 있으며, 방문 후 한참 뒤에 보내는 후속 조치에 좋습니다	방문이 확인되면 PW_GeozoneExited가 “방문은 어떠셨나요?” 설문조사를 트리거합니다	이벤트 발생, 진입 시 환영했던 동일한 Journey가 떠날 때도 제대로 마무리되도록 합니다
체류 이벤트 발생	그냥 지나간 사람이 아니라 실제로 그곳에서 시간을 보낸 사람에게만 관심이 있을 때	PW_GeozoneDwell (내부 시간 = 15분)은 후속 이메일을 위해 “진정으로 관심 있는” 방문자를 플래그 지정합니다	침묵 후 이탈 가정, 방문 중에 사람에게 메시지를 보내지 않고도 CRM에서 두 신호를 모두 받을 수 있습니다
침묵 후 이탈 가정	위치 추적 신호가 자주 끊기는 경우(장소, 백그라운드 앱), 확인된 이탈은 신뢰할 수 없습니다. 이것은 타이머에 따라 어쨌든 발생합니다	PW_GeozoneExitedByTimeout (침묵 = 2시간)은 신호가 약한 경기장에서의 방문을 마감합니다	체류 이벤트 발생, 방문을 신뢰성 있게 마감하고 그들이 실제로 참여했는지 알 수 있습니다

푸시 보내기

아래의 푸시 메시지 작성에서 구성한 푸시 알림을 보냅니다. 예를 들어, 오전 10시에 존에 진입한 기기는 쿨다운이 허용하는 한 즉시 푸시를 받습니다. 이벤트 기반 액션만 원할 경우 이 기능을 끄면 됩니다. 메시지 설정이 사라지고 채울 필요가 없습니다.

이벤트 발생

기기가 존에 진입할 때 사용자 지정 이벤트를 발생시킵니다. Customer Journey에서 트리거 기반 진입으로 사용하세요. 예를 들어, 오후 2시에 존에 진입한 기기는 오후 2시에 PW_GeozoneEntered를 발생시킵니다. 진입과 이벤트는 동시에 발생합니다.

1. 이벤트 발생을 켭니다.
2. 이벤트 이름을 설정합니다. 비워두면 시스템 기본 이벤트 PW_GeozoneEntered가 사용되거나, 최대 128자의 고유한 이름을 입력할 수 있습니다.

이벤트는 geozone_code, geozone_name, lat, lng, range, distance의 여섯 가지 속성을 전달합니다. 지오존이 클러스터에 할당된 경우 cluster_code와 cluster_name도 전달합니다.

참고

이벤트는 기기가 존에 진입하기 전이라도 지오존을 저장하는 즉시 Customer Journey 진입 요소 선택기에 나타납니다.

이탈 이벤트 발생

이 이벤트는 누군가 존을 떠나는 순간 발생하지 않습니다. 기기가 먼저 이탈을 감지합니다. 그런 다음 기기가 Pushwoosh에 다음에 연락할 때 이탈을 보고합니다. 이는 기기의 위치를 보내는 주기적인 백그라운드 체크인이며, 실시간 지속적인 연결이 아닙니다.

연락이 얼마나 빨리 이루어지는지는 Pushwoosh가 아닌 기기의 OS 및 백그라운드 설정에 따라 다르므로, 실제 이탈과 이벤트 발생 사이의 지연은 몇 초에서 몇 시간까지 다양할 수 있습니다. 예를 들어, 오후 3시에 떠났지만 오후 3시 45분까지 Pushwoosh에 다시 연락하지 않은 기기는 오후 3시가 아닌 오후 3시 45분에 이벤트를 발생시킵니다.

쿨다운은 이 액션이 아닌 진입 액션을 제어합니다. 기기가 하나의 쿨다운 기간 내에 동일한 지오존에 진입, 이탈, 재진입하는 경우, 반복 진입은 억제되지만 각 실제 이탈은 여전히 자체 이벤트를 발생시키므로, 동일한 방문 문자열에 대해 게이트된 진입보다 더 많은 이탈 이벤트가 발생할 수 있습니다.

1. 이탈 이벤트 발생을 켭니다.
2. 이탈 이벤트 이름을 설정합니다. 비워두면 시스템 기본 이벤트 PW_GeozoneExited가 사용되거나, 고유한 이름을 입력할 수 있습니다.

체류 이벤트 발생

기기가 진입 시점부터 계산하여 내부 시간에 설정한 기간 동안 존 내부에 머무르면 사용자 지정 이벤트를 발생시킵니다.

체류 타이머 작동 방식

이탈 이벤트 발생과 달리, 이 액션은 기기가 Pushwoosh에 연락하기를 기다리지 않습니다. Pushwoosh는 기기가 존에 진입할 때 타이머를 시작하고, 그 사이에 기기가 추가 위치 업데이트를 보내지 않더라도 내부 시간이 경과하면 이벤트를 발생시킵니다.

• 체류당 한 번 발생: 기기가 떠났다가 다시 진입한 후에만 새 타이머가 시작됩니다.
• 연락 불필요: 진입 직후 침묵 상태가 된 기기도 스케줄에 따라 이벤트를 트리거합니다.

예를 들어, 내부 시간을 10분으로 설정하면, 오후 1시에 진입한 기기는 그 사이에 Pushwoosh와 연락이 없더라도 오후 1시 10분에 체류 이벤트를 발생시킵니다.

1. 체류 이벤트 발생을 켭니다.
2. 내부 시간을 1분에서 1440분 사이의 값으로 설정합니다.
3. 체류 이벤트 이름을 설정합니다. 비워두면 시스템 기본 이벤트 PW_GeozoneDwell이 사용되거나, 고유한 이름을 입력할 수 있습니다.

침묵 후 이탈 가정

마지막으로 존 내부에서 확인된 기기가 가정 전 침묵 시간에 설정된 기간 동안 조용해지면(Pushwoosh에 위치 업데이트 전송 중단) 사용자 지정 이벤트를 발생시킵니다.

확인된 이탈 vs 가정된 이탈

이탈 이벤트 발생과 달리, 이 액션은 기기가 존을 떠났다고 보고하기를 기다리지 않습니다. 기기가 외부임을 보여주는 위치 업데이트가 없더라도, 전체 가정 전 침묵 시간 동안 기기가 침묵을 유지하면 발생합니다.

이 두 액션은 다른 질문에 답합니다:

• 이탈 이벤트 발생: 기기가 존 외부에서 위치 업데이트를 보냈습니다.
• 침묵 후 이탈 가정: Pushwoosh는 기기가 업데이트 전송을 중단했기 때문에 방문이 끝난 것으로 처리합니다.

각각에 대해 별도의 Customer Journey 트리거를 구축하세요. 두 가지를 하나의 트리거로 결합하면 어느 신호에서든 발생하며, 실제 이탈과 단순히 보고를 중단한 기기를 구별할 수 없습니다.

예를 들어, 가정 전 침묵 시간을 30분으로 설정하면, 오후 4시에 존 내부에서 마지막으로 목격된 기기는 그 시간 동안 침묵을 유지하면 오후 4시 30분에 가정된 이탈 이벤트를 발생시킵니다.

1. 침묵 후 이탈 가정을 켭니다.
2. 가정 전 침묵 시간을 5분에서 1440분 사이의 값으로 설정합니다.
3. 가정된 이탈 이벤트 이름을 설정합니다. 비워두면 시스템 기본 이벤트 PW_GeozoneExitedByTimeout이 사용되거나, 고유한 이름을 입력할 수 있습니다.

참고

이탈, 체류 및 가정된 이탈 이벤트는 위에서 나열한 여섯 가지 속성 외에 dwell_seconds라는 추가 속성을 전달합니다. 이는 기기가 진입부터 이벤트 발생까지 존 내부에서 보낸 시간입니다.

• 이탈 이벤트 발생은 실제 위치 업데이트에서 비롯되므로 distance도 전달합니다.
• 체류 이벤트 발생과 침묵 후 이탈 가정은 distance를 전달하지 않습니다. 둘 다 위치 업데이트가 아닌 서버 타이머에서 발생합니다.

푸시 메시지 작성

푸시 보내기가 켜져 있는 상태에서 알림 작성 방법을 선택합니다:

• 메시지 작성: 양식에 직접 푸시 텍스트를 입력합니다(최대 1024자). 단일 지오존에서 빠른 일회성 메시지를 보낼 때 이 옵션을 사용하세요.
• 기존 프리셋 사용: 제목, 딥 링크, 사용자 지정 사운드 및 플랫폼별 페이로드가 포함된 전체 템플릿을 위해 저장된 프리셋을 선택합니다.

선택적 메시지 설정을 구성합니다:

• iOS에서 기본 사운드 재생: iOS 기기에서 시스템 푸시 사운드를 사용합니다.
• 인박스에 저장: 배달 후 기기의 인앱 인박스에 푸시를 보관하여 사용자가 나중에 다시 볼 수 있도록 합니다. 활성화된 경우 인박스 만료(1-30일)를 설정하고 선택적으로 인박스 아이콘 URL을 설정합니다. 자세히 알아보기.

트리거 위치 설정

트리거 위치의 모양을 선택합니다:

• 원: 주소를 검색하거나, 검색창에 원시 좌표를 붙여넣거나, 지도 아무 곳이나 클릭하여 마커를 놓습니다. 원의 핸들을 드래그하여 범위를 설정합니다. 범위는 50m에서 100km 사이로 설정할 수 있습니다. 기본값은 200m입니다.

• 다각형: 지도를 클릭하여 모서리를 하나씩 놓아 쇼핑몰 평면도나 행사장 경계와 같은 영역의 윤곽을 그립니다. 모서리를 드래그하여 이동하고, 모서리를 마우스 오른쪽 버튼으로 클릭하여 삭제합니다. 다각형은 3개에서 100개의 고유한 모서리가 필요합니다. 첫 번째 모서리를 다시 클릭하여 모양을 닫을 필요는 없습니다.

기기는 다각형 모양이라도 원을 모니터링합니다

휴대폰은 다각형 모양이 아닌 원만 모니터링할 수 있습니다. 다각형을 그리면 Pushwoosh는 이를 완전히 포함하는 원을 계산합니다. 이 원은 모양의 중심에 위치하며 가장 먼 모서리까지의 반경을 가집니다(최소 50m). 기기는 해당 원에 들어서는 즉시 깨어나 위치를 보고합니다.

푸시 자체는 그 시점에서 아직 발생하지 않습니다. 서버가 기기가 실제로 그린 다각형 내부에 있음을 확인한 후에만 발생합니다. 이것이 푸시가 모양에 도달하기 전에 기기를 깨울 수 있지만, 사용자가 실제로 해당 지역에 들어간 후에만 전달되는 이유입니다.

저장된 지오존을 편집할 때 모양을 전환할 수 있습니다:

• 다각형 지오존을 원으로 변환하려면 원을 선택하고 평소와 같이 중심과 범위를 설정합니다.
• 원 지오존을 다각형으로 변환하려면 다각형을 선택하고 새 모서리를 그립니다.
• 다각형의 모든 모서리를 지우면(모양 지우기) 원으로 되돌아갑니다.

클러스터 및 쿨다운 선택

쿨다운은 푸시가 전송된 후의 침묵 기간입니다. 독립형 지오존의 경우, 동일한 기기는 쿨다운이 만료될 때까지 해당 지오존에서 다른 알림을 받지 않습니다. 이는 기기가 이탈했다가 다시 진입하더라도 마찬가지입니다. 지오존이 클러스터에 속한 경우, 쿨다운은 대신 전체 클러스터에 적용됩니다. 기기는 푸시를 보낸 지오존뿐만 아니라 해당 클러스터의 모든 지오존에 대해 침묵을 유지합니다.

쿨다운 필드에서 세 가지 모드 중 하나를 선택합니다:

모드	쿨다운 설정 방법	동작
독립형	이 지오존에 대해 직접 일, 시간, 분을 설정합니다. 최소 1분, 최대 41일입니다.	쿨다운은 이 지오존에만 적용됩니다.
기존 클러스터 사용	기존 클러스터의 쿨다운을 적용합니다.	클러스터 쿨다운이 이 지오존의 자체 쿨다운을 재정의합니다.
새 클러스터	새 클러스터를 만들고 쿨다운을 설정합니다. 클러스터 생성을 참조하세요.	클러스터 쿨다운이 이 지오존의 자체 쿨다운을 재정의합니다.

캠페인 실행 시점 스케줄링

캠페인 스케줄 섹션은 진입 액션이 실행될 수 있는 시점을 제한합니다. 푸시 또는 진입 이벤트는 해당 순간에 지오존이 활성 상태이고 쿨다운이 배달을 허용하는 경우에만 실행됩니다.

캠페인을 특정 날짜 범위로 제한

이 필드들은 선택 사항입니다. 9월 10일부터 10월 23일까지의 휴일 프로모션이나 기간 한정 매장 오픈과 같이 전체 캠페인을 특정 날짜 범위 내에서 실행하고 싶을 때 설정하세요.

• 시작 날짜: 지오존이 실행될 수 있는 첫날입니다.
• 종료 날짜: 지오존이 실행될 수 있는 마지막 날입니다.

참고

• 두 날짜 모두 포함됩니다. 지오존은 종료 날짜의 마지막까지 계속 실행됩니다.
• 주간 스케줄. 날짜 범위는 아래의 일일 모드 대신 함께 작동합니다.
• 시간대. 시작 날짜, 종료 날짜 및 주간 시간은 모두 스케줄의 시간대를 사용하며, 지오존을 저장하는 순간 브라우저의 시간대에서 설정됩니다. 팀이 여러 지역에 걸쳐 작업하는 경우 특히 캠페인이 따르기를 원하는 시간대에서 저장하세요. 새로운 항상 활성 지오존은 아직 스케줄 시간대가 없으므로, 한 번 이상 편집하고 저장할 때까지 날짜는 UTC로 평가됩니다.

지오존 실행 방식 선택

24시간 내내 실행하려면 항상 활성을 선택하고, 요일별 특정 시간대에만 실행을 제한하려면 선택한 요일 및 시간에만을 선택합니다.

항상 활성

캠페인은 24/7 실행됩니다. 추가 스케줄 구성은 필요하지 않습니다.

선택한 요일 및 시간에만

캠페인은 여기서 설정한 시간대 내에서만 실행됩니다:

1. 캠페인을 실행할 각 요일을 켭니다.
2. 해당 요일의 시작 및 종료 시간을 설정합니다.

참고

제어판은 하루에 단일 시간대만 지원합니다. API를 통해 하루에 여러 시간대로 지오존이 구성된 경우, 양식에서 스케줄 편집이 불가능합니다. 저장을 클릭하여 기존 스케줄을 변경 없이 유지하세요. 수정하려면 API를 사용하세요.

어떤 모드를 선택했든 상관없이 저장을 클릭하여 완료합니다. 지오존은 즉시 활성화됩니다. 스케줄을 설정한 경우, 푸시는 구성된 시간대에만 실행됩니다.

스케줄을 따르는 액션

• 푸시 보내기, 이벤트 발생 및 기기가 존에 진입할 때 실행되는 기타 액션은 활성 스케줄 시간대 동안 그리고 쿨다운이 배달을 허용할 때만 실행됩니다.
• 이탈 이벤트 발생, 체류 이벤트 발생 및 침묵 후 이탈 가정은 스케줄이 아닌 방문을 따릅니다. 스케줄이 활성 상태일 때 기기가 진입했다면, 이러한 액션은 일일 시간대가 닫힌 후에도 여전히 실행될 수 있습니다.