> For the complete documentation index, see [llms.txt](https://docs.groobee.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.groobee.ai/new-admin/push/push-create/event-trigger.md).

# 이벤트 트리거 발송 캠페인 만들기

## **이벤트 트리거 발송**

* 이벤트 트리거 발송은 타겟이 특정 이벤트를 충족하는 시점에 발송을 하는 발송 방식입니다.
* 이벤트가 발생되면 즉시 또는 설정한 대기 시간 후에 발송이 가능하며, 특정 행동을 하는 타겟을 적절한 시점에 타겟팅 할 수 있는 방식입니다.

{% hint style="warning" %}
이벤트 트리거 발송은 피로도 설정 여부와 상관없이 발송됩니다.
{% endhint %}

***

## **1단계 : 기본 설정** <a href="#step1" id="step1"></a>

<figure><img src="/files/VH4TwdVtHHOy6gBmEPek" alt=""><figcaption></figcaption></figure>

### **단계 이동**

각 단계를 클릭하여 해당하는 단계로 이동할 수 있습니다. 각 단계의 필수 값이 입력되어야만 이동 가능합니다.

### **캠페인 기본 정보**

![](/files/ld6lnlm0OAKCFxQ6AjQU)

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="306.72265625"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/qWUXSR7LGSiH78yxS2p7" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

<img src="/files/j7ARXPln1mmGvB3idigS" alt="" width="563">

캠페인을 진행할 대상 타겟을 설정합니다. 발송 타입이 이벤트 트리거 발송인 경우 세그먼트 설정은 선택 사항이며, 설정하지 않을 시 모든 사용자 대상 중 설정한 이벤트가 발생한 사용자에게 메시지가 발송됩니다.

* 세그먼트 설정 : 세그먼트 불러오기로 저장된 세그먼트를 불러올 수 있습니다. 상세보기를 클릭하여 해당 세그먼트의 상세 정보를 확인합니다.
  * AI 세그먼트 : 이벤트 트리거 캠페인에서는 사용할 수 없습니다.
  * 세그먼트 : 활용 범위가 '온사이트(Web/Hybrid, Native)'로 저장된 세그먼트만 선택 가능합니다.

{% hint style="info" %}
설정한 타겟 중 우리 사이트에서 이벤트가 발생한 대상에게 설정한 시점에 발송되며, 발송 시 발송에 필요한 정보가 있는 대상에게 발송됩니다.
{% endhint %}

{% hint style="warning" %}
세그먼트 불러오기는 현재 만드는 캠페인에서 사용 가능한 세그먼트만 표시됩니다. 오프사이트 이벤트 트리거 캠페인은 기존 어드민에서 만든 온사이트 세그먼트를 사용할 수 있습니다.
{% endhint %}

### **트리거 설정**

![](/files/QX2oIOZG19UyYtnRUu93)

* 발송 시점을 결정할 트리거 이벤트를 설정합니다.
* 해당 이벤트가 발생하고, 이벤트에 따라 필요한 설정된 조건을 만족하면 대기 시간 후 발송합니다.
* 이벤트 트리거로 선택한 이벤트에 따라 조건을 설정할 수 있습니다.
* 아래의 표를 참고해 주세요.

<table><thead><tr><th width="122.1015625">이벤트</th><th width="147.7734375">조건</th><th>설명</th></tr></thead><tbody><tr><td>장바구니 행동</td><td>담은 상품명</td><td>장바구니 행동이 발생했을 때, 입력한 상품명과 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>담은 상품 코드</td><td>장바구니 행동이 발생했을 때, 입력한 상품 코드와 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>담은 총액</td><td>장바구니 행동이 발생했을 때, 입력한 담은 총액이 선택한 조건을 충족하면 발송합니다.</td></tr><tr><td>주문 행동</td><td>주문 완료 상품명</td><td>주문 행동이 발생했을 때, 입력한 주문 완료 상품명과 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>주문 완료 상품 코드</td><td>주문 행동이 발생했을 때, 입력한 주문 완료 상품 코드와 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>주문 총액</td><td>주문 행동이 발생했을 때, 입력한 주문 총액이 선택한 조건을 충족하면 발송합니다.</td></tr><tr><td>방문 행동</td><td>회원가입</td><td>방문 행동이 발생했을 때, 회원가입이 발생하면 발송합니다.</td></tr><tr><td>커스텀 이벤트</td><td>커스텀 이벤트명</td><td>커스텀 이벤트가 발생했을 때, 선택한 커스텀 이벤트와 조건을 충족하면 발송합니다.</td></tr></tbody></table>

### **대기 시간 설정**

![](/files/CGGEDLqqygaNhWO2Vj5N)

* 이벤트가 발생한 후 조건을 만족한 대상에게 즉시 또는 지정한 시간만큼 대기 후 메시지를 발송합니다.
  * 즉시 : 이벤트 조건을 만족한 대상에게 메시지를 즉시 발송합니다.
  * 지정 : 대기 시간을 지정하면 이벤트 조건을 만족한 시점에서 지정된 시간만큼 대기 후 발송합니다. 대기 시간은 최소 1분부터 최대 24시간 사이로 지정할 수 있습니다.

{% hint style="warning" %}
이벤트 트리거를 충족하여 설정한 대기 시간 후의 시간이 21:00\~08:00에 해당되는 메시지는 야간 광고 수신에 동의한 대상에게만 발송됩니다.
{% endhint %}

{% hint style="warning" %}
캠페인 진행에서 중지 상태로 변경하면, 대기 시간에 있던 메시지는 발송되지 않습니다.
{% endhint %}

### **추가 필터 이벤트 설정**

![](/files/02KpH1kfib5aWkVXGaPo)

* 대기 시간이 '지정'일 경우 추가 필터 이벤트를 설정할 수 있습니다.
* 지정된 대기 시간 후 발송이 나갈 시점에 추가적인 이벤트가 발생한 대상을 제외하고 발송합니다.
* 추가 필터 이벤트를 설정하지 않으면 이벤트 트리거 조건을 만족한 모든 대상에게 지정한 대기 시간 후 발송됩니다
  * 예시) 장바구니에 담은 총액이 100,000 일 때 3시간 후 발송을 하는 경우, 추가 필터 이벤트로 주문 완료 이벤트를 설정한다면 3시간 동안 구매 완료 이벤트가 발생한 대상은 제외하고, 구매가 없는 대상에게만 발송됩니다.
* 아래의 표를 참고해 주세요.

<table><thead><tr><th width="136.54296875">추가 필터 이벤트</th><th width="138.203125">조건</th><th>설명</th></tr></thead><tbody><tr><td>주문 행동</td><td>주문 완료</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 주문 완료가 발생한 대상은 제외하고 발송합니다.</td></tr><tr><td></td><td>주문 총액</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 입력한 주문 총액이 선택한 조건을 충족한 대상은 제외하고 발송합니다.</td></tr><tr><td>커스텀 이벤트</td><td>커스텀 이벤트명</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 선택한 커스텀 이벤트와 조건을 충족한 대상은 제외하고 발송합니다.</td></tr></tbody></table>

{% hint style="info" %}
추가 필터 이벤트는 대기 시간이 지정일 경우만 설정 가능합니다.
{% endhint %}

### **이벤트 트리거 요약**

![](/files/UBpmKw6so1d7PIQI5NGV)

![](/files/LN3cNITAsEN2EmEhNy4V)

* 이벤트 트리거 요약에서 현재까지 설정한 이벤트 트리거, 대기 시간, 추가 필터 이벤트 등의 요약된 내용을 확인할 수 있습니다.
* 요약을 확인하여 내용이 잘 설정됐는지 검토 해볼 수 있습니다.

{% hint style="info" %}
여러 개의 값을 입력했을 경우 하나의 값만 확인하고, 남은 값은 말줄임 처리됩니다.
{% endhint %}

***

## **2단계 : 메시지 설정** <a href="#step2" id="step2"></a>

메시지 설정에서는 실제 발송될 메시지 본문을 작성하여 작성된 메시지를 미리보기와 발송 테스트를 통해 확인할 수 있습니다.

<img src="/files/e3cv06NhoP7Lm0NQfZJb" alt="" width="563">

### **메시지 기본 설정**

![](/files/SHxFXBH6vaY1AabpXJc1)

* 알림 목적 : 광고성 / 정보성
  * 광고성 : 광고성 푸시 알림 수신 동의를 한 사용자에게만 메시지가 발송됩니다.
  * 정보성 : 광고성 푸시 알림 수신 동의와 상관없이, 푸시 알림 메시지를 수신할 수 있는 모든 대상에게 메시지가 발송됩니다.
* 광고 문구 표기 : 선택한 언어에 맞는 광고 문구 표기를 메시지 미리보기에서 확인할 수 있습니다.
  * [광고 문구 표기는 설정 > 푸시 알림 설정 > 광고 문구 표기](/new-admin/settings/push.md)에서 설정할 수 있습니다.

• 발송 OS : 만들기 1단계에서 설정한 발송 OS를 표시합니다.

### **메시지 작성**

![](/files/OItTqFGA4w2xH8q9PJrO)

* 실제 발송될 푸시 알림 메시지 내용을 작성합니다.

#### **ⓐ 제목**

* 푸시 알림 메시지의 제목을 작성합니다.
* 알림 목적이 광고성은 최대 31자까지 작성 가능하며, 정보성은 최대 40자까지 작성 가능합니다.

#### **ⓑ 내용**

* 푸시 알림 메시지 내용을 설정합니다.&#x20;

#### **ⓒ 수신 거부 표기**

* 고정된 수신 거부 방법을 사용하고 싶을 시 설정하면 내용 뒤에 표기되어 발송합니다.
* 설정 > 푸시 알림 설정 > 수신 거부 방법 표기 에서 값을 설정할 수 있습니다.

{% hint style="info" %}
설정된 값은 새로운 캠페인부터 적용됩니다.
{% endhint %}

{% hint style="warning" %}
알림 목적이 광고성일 경우, 메시지에 (광고) 문구가 필수로 표기되어야 합니다.

알림 목적이 광고성일 경우 수신 거부 방법을 필수로 표기해야 합니다.

광고 문구 표기 위치의 기본 값과 고정된 수신 거부 표기는 설정 > 푸시 알림 설정에서 설정할 수 있습니다.
{% endhint %}

{% hint style="info" %}
미리보기는 실제 푸시 알림과 차이가 있을 수 있습니다.
{% endhint %}

{% hint style="success" %}
메시지 내용은 125자 이하로 간결하게 작성하는 것을 권장합니다.\
글자 수가 125자가 넘어가는 경우 모바일 기기의 해상도에 따라 일부 텍스트가 표시되지 않을 수 있습니다.
{% endhint %}

#### **ⓓ 기본 이미지**

* 설정 > 푸시 알림 설정 화면 Android 기본 이미지에 업로드한 이미지를 불러옵니다.
* 해당 이미지는 Android 기기에만 표시되며, 설정 > 푸시 알림 설정 화면에 업로드된 이미지가 없을 시 사용할 수 없습니다.

#### **ⓔ 본문 이미지**

* 본문에 파일을 업로드하여 내용과 함께 이미지를 발송할 수 있습니다. 권장 이미지 사이즈는 1024 x 512px 입니다.
* 업로드한 이미지는 푸시 알림 제목 옆에는 1:1 비율로 크롭되고 푸시 알림 내용 하단에는 전체 크기의 이미지가 전송됩니다.

#### **ⓕ 클릭 액션**

* 사용자가 푸시를 터치했을 때 실행되는 액션을 선택합니다.
  * 앱 실행 : 사용자가 푸시 알림을 터치할 때 앱을 실행합니다.
  * 딥 링크 : 사용자가 푸시 알림을 터치할 때 앱 내의 특정 화면으로 랜딩합니다.
    * 딥 링크 형식으로 입력해 주세요.
    * 해당 입력창에는 최대 1,000자 까지만 입력 가능합니다.
  * 웹 브라우저 실행 : 사용자가 푸시 알림을 클릭할 때 웹 브라우저를 실행해 특정 페이지로 이동합니다.
    * http\:// 나 https\:// 형식의 올바른 URL을 입력해 주세요.
    * 해당 입력창에는 최대 1,000자 까지만 입력 가능합니다.

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

#### **ⓖ 고급 옵션**

* 푸시 알림 메시지에 추가적인 데이터 전달이 가능합니다.
* 데이터에 담고 싶은 추가적인 정보를 입력하고, 해당 데이터를 활용하여 앱 내에서 따로 푸시 알림에 대한 처리를 할 수 있습니다.
* 앱 푸시에 대한 특정한 처리를 하고자 할 때 활용할 수 있습니다.
* 추가 데이터를 사용하면 허용 용량 범위 내에서 추가적인 데이터를 전달할 수 있습니다. 최대 500자 이내의 값을 입력해 주세요.
* 최대 10개의 key, value를 추가할 수 있습니다.

{% hint style="info" %}
커스텀 Key-Value 쌍으로 적절한 키를 설정하여 클라이언트 앱으로 데이터 페이로드를 보내는 기능입니다.\
고급 옵션 기능은 앱 개발 담당자와 상의 후 사용하는 것을 권장합니다. [참고 문서](https://firebase.google.com/docs/cloud-messaging/concept-options?authuser=0\&hl=ko&_gl=1*13z49rc*_up*MQ..*_ga*MTk5NjQyMzk1MS4xNzIxMDMxMDQ0*_ga_CW55HF8NVT*MTcyMTAzMTA0NC4xLjEuMTcyMTAzMTg1My4wLjAuMA..#data_messages)를 확인해 주세요.
{% endhint %}

#### **ⓗ 미리보기**

|                                                                   | iOS                                                               |
| ----------------------------------------------------------------- | ----------------------------------------------------------------- |
| <p><img src="/files/6G0sCZqeSBtI1nmAikAt" alt="" width="375"></p> | <p><img src="/files/jP12c4aG9fRzKZXRzjJ6" alt="" width="375"></p> |

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 발송 OS별로 미리보기를 확인할 수 있습니다.

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

#### **ⓘ 발송 테스트**

<img src="/files/UUlbtuds1XTwkpD0zNzE" alt="" width="188">

* 메시지 설정을 마친 후, 캠페인 진행 전 테스트 메시지를 발송할 수 있습니다.
* 발송 테스트 대상은 한 번에 5명까지 발송 테스트를 할 수 있습니다.
* 입력한 회원 ID로 로그인한 기기에 유효한 토큰이 있는 경우 푸시 알림 메시지를 받을 수 있습니다.

***

## **3단계 : 옵션 설정** <a href="#step3" id="step3"></a>

<figure><img src="/files/DkVpl9v6wXcmlxD8OI9U" alt=""><figcaption></figcaption></figure>

### **1. 스케줄**

<img src="/files/vvL2V1atFWe4qwFefqhk" alt="" width="563">

* 캠페인의 진행 스케줄을 설정할 수 있습니다.
  * 수동 종료 전까지 : 설정한 시작 일시부터 직접 완료 처리하기 전까지 캠페인이 진행됩니다.
  * 기간 지정 : 설정한 시작 일시 \~ 종료 일시동안 캠페인이 진행됩니다.

{% hint style="warning" %}
정보통신망법에 의거하여 심야 시간(21:00\~08:00)에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다.
{% endhint %}

{% hint style="warning" %}
캠페인 진행 스케줄을 설정하여 저장 후 캠페인 진행을 해야 설정한 시간에 맞춰 캠페인이 시작됩니다.
{% endhint %}

### **2. 메시지 발송 제어**

메시지 발송 제어에서는 재발송 허용 여부를 선택합니다.

<figure><img src="/files/eRNH3M41FtJodFo3lxB0" alt=""><figcaption></figcaption></figure>

* **재발송 허용 안 함(체크 해제):** 한 번 발송된 대상은 이벤트 조건을 다시 만족하더라도 메시지를 다시 발송하지 않습니다.
* **재발송 허용(체크):** 이미 메시지가 발송된 대상이 같은 이벤트 트리거 조건을 다시 만족하면 메시지를 재발송합니다.

{% hint style="warning" %}
재발송을 허용하면 동일 회원이 같은 트리거에 다시 걸릴 때마다 메시지가 다시 발송됩니다. 과도한 발송을 막기 위해 아래 **발송 간격 제한**을 함께 사용하는 것을 권장합니다.
{% endhint %}

{% hint style="info" %}
재발송 허용과 발송 간격 제한은 서로 다른 기능입니다.\
두 설정을 함께 사용하면 재발송은 허용하되, 설정한 간격 안에서는 중복 발송을 막을 수 있습니다.

* **재발송 허용:** 같은 트리거 조건을 다시 만족했을 때 메시지를 또 보낼지 여부를 결정합니다.
* **발송 간격 제한:** 재발송이 허용되더라도, 마지막 발송일로부터 설정한 기간 안에는 다시 발송되지 않도록 막습니다.
  {% endhint %}

### **3. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

<figure><img src="/files/Wmos6m4jv3pjlWjfcYku" alt=""><figcaption></figcaption></figure>

#### **3-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **3-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다.
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
재발송을 허용한 경우, '이 캠페인만 적용'을 설정하면 이 캠페인에서 마지막으로 발송된 시점을 기준으로 재발송 간격을 제한할 수 있습니다.
{% endhint %}

#### **3-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **3-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **기기 또는 회원 기준:** 같은 기기 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 로그인 회원이 여러 기기를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **기기 기준:** 같은 기기로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **3-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groobee.ai/new-admin/push/push-create/event-trigger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.