> 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/schedule.md).

# 스케줄 발송 캠페인 만들기

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

새로운 푸시 알림 캠페인 만들기 기본 설정에서는 캠페인명, 캠페인의 상세설명, 태그 등의 캠페인 기본 정보와 캠페인 타겟을 설정할 수 있습니다.

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FMxMYBdCLMyri9VmniB0S%2F0.png?alt=media" alt="" width="563">

### **단계 이동**

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

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

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FSB60fwHgBhyOKOQbsFu6%2F1.png?alt=media" alt="" width="563">

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

<table data-header-hidden><thead><tr><th width="338.3984375"></th><th></th></tr></thead><tbody><tr><td><p><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FBlSSTAQd3z838brxSNx9%2F2.png?alt=media" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

![](https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FQCyueN0mhAeCkJVqziCT%2F3.png?alt=media)

캠페인을 진행할 대상 타겟을 설정합니다.

* 타겟팅 유형 : 세그먼트 / 수신 동의자 전체 / 직접 업로드
  * 세그먼트 : 만들어진 세그먼트를 불러와서 타겟팅 합니다.
  * 수신 동의자 전체 : 푸시 알림 수신 동의를 한 모든 대상을 타겟팅 합니다.
  * 직접 업로드 > 회원 정보 : 푸시 알림을 발송할 회원 ID 리스트를 업로드하여 타겟팅 합니다.
  * 직접 업로드 > 개인화 정보 : 회원 ID와 회원별 개인화 정보(최대 10개 속성)를 함께 업로드합니다. 업로드한 값은 2단계에서 개인화 변수로 메시지에 넣을 수 있습니다. **개인화 정보 템플릿**을 내려받아 작성해 주세요.
    * 템플릿의 첫 행은 회원 번호(ID)와 속성명 01 \~ 속성명 10입니다. 속성명은 고객명, 쿠폰명처럼 직접 정한 이름으로 바꿔 쓸 수 있으며, 그 이름이 2단계 변수 항목으로 표시됩니다.
    * 업로드하면 파일명과 업로드 성공 인원, 업로드 일시가 표시됩니다.
  * 직접 업로드(회원 정보, 개인화 정보)를 선택했다면 파일을 올려야 캠페인을 저장할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FHvAWJ1fZURO1wGCW8LZv%2F04_%ED%91%B8%EC%8B%9C%EA%B0%9C%EC%9D%B8%ED%99%94%EC%A0%95%EB%B3%B4_hd.png?alt=media&amp;token=a291842b-4339-4052-aaf8-c1d2d142e655" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
푸시 수신 동의자 전체는 그루비에 유효한 푸시 토큰, 수신 동의가 된 전체 대상에게 발송됩니다.
{% endhint %}

{% hint style="warning" %}
회원 정보 업로드의 파일은 완료된 캠페인의 경우 완료 일자부터 +31일까지만 파일이 보관됩니다. 그 이후의 캠페인 복사 시에는 기존 파일을 사용할 수 없습니다.
{% endhint %}

{% hint style="warning" %}
파일명이 한글 기준 50자(164바이트) 이하인 파일만 업로드해 주세요.
{% endhint %}

{% hint style="warning" %}
개인화 정보 파일은 아래 내용을 지켜 업로드해 주세요.

* UTF-8로 저장한 CSV 파일 1개, 100만 건 미만만 업로드할 수 있습니다. 100만 건 이상은 캠페인을 복사해 나눠서 업로드해 주세요.

* 속성명이 빈 칸이면 개인화 설정을 할 수 없고, 속성명에 쉼표가 들어가면 값이 제대로 올라가지 않습니다.

* 새 파일을 다시 올리면 이전 데이터가 지워지고, 2단계에서 입력한 대체 발송 값도 초기화되므로 다시 입력해야 합니다.

* 업로드 전에 귀사의 개인정보 처리방침에 개인정보 처리 위탁 내용을 반영해 주세요.
  {% endhint %}

* 세그먼트 설정 : 타겟팅 유형이 세그먼트일 때 표시되며, 저장된 세그먼트를 불러올 수 있습니다. 상세보기를 클릭하여 해당 세그먼트의 상세 정보를 확인합니다.<br>

  <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/56ueklf39n/1758678893025/.png" alt=""><figcaption></figcaption></figure>

  * 세그먼트 불러오기 : ‘세그먼트 불러오기' 버튼을 클릭하여 원하는 세그먼트를 최대 3개까지 불러올 수 있습니다. 상세보기를 클릭하여 각 세그먼트의 상세 정보를 확인할 수 있습니다.
    * AI 세그먼트 : 저장된 AI 세그먼트를 선택할 수 있습니다.
    * 세그먼트 : 활용 범위가 '오프사이트'인 세그먼트만 선택 가능합니다.
  * 조건 설정 (AND, OR, NOT) : 각 세그먼트 사이에 적용할 조건을 선택합니다.
    * AND : 앞선 조건과 현재 세그먼트의 교집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이면서 최근 30일 내 구매 고객)
    * OR : 앞선 조건과 현재 세그먼트의 합집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이거나 최근 30일 내 구매 고객)
    * NOT : 앞선 조건에서 현재 세그먼트에 해당하는 타겟을 제외합니다. (예: VIP 고객 중 최근 30일 내 구매 고객은 제외)
  * 순서 조정 : 세그먼트는 위에서 아래 순서대로 조건이 조합됩니다. 세그먼트 좌측의 화살표 버튼을 통해 자유롭게 순서를 변경하고, 타겟 조합의 우선순위를 조정할 수 있습니다.<br>

    <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/56ueklf39n/1758678831214/.png" alt=""><figcaption></figcaption></figure>
  * 세그먼트 조합 결과 요약 : 위에서 조합한 세그먼트의 타겟팅 정보를 알기 쉽게 제공합니다.
    * 세그먼트 조합이 어떻게 이루어지는지 궁금하신가요? ‘조합 결과 보기' 팝업을 통해 현재 설정된 세그먼트와 조건이 어떤 논리로 결합되어 타겟이 추출되는지 직관적으로 확인할 수 있습니다.

* 발송 OS : 전체 / Android / iOS
  * 전체 : Android, iOS 모든 발송 OS에 푸시 알림 메시지를 발송합니다.
  * Android : Android 기기의 푸시 알림 수신 동의자에게 푸시 알림 메시지를 발송합니다.
  * iOS : iOS 기기의 푸시 알림 수신 동의자에게 푸시 알림 메시지를 발송합니다.
  * 타겟팅 유형이 직접 업로드 > 개인화 정보이면 발송 OS는 전체만 선택할 수 있습니다.

***

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

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

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FS34hSAusJocNRTjyEDLY%2F4.png?alt=media" alt="" width="563">

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

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FVS6xE6amTgkWLtFOUTtK%2F5.png?alt=media" alt="" width="563">

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

### **예상 타겟 수**

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FQV9doqYexXRjygLfeI5m%2F6.png?alt=media" alt="" width="563">

* 타겟팅 유형 및 알림 목적, 발송 OS 등의 선택한 타겟팅 조건에 맞는 대상의 예상 수치를 확인할 수 있습니다.

{% hint style="info" %}
예상 타겟 수 조회 시점의 예상 타겟 수와 실제 발송 시점의 발송 타겟 수에는 차이가 있을 수 있습니다.

자세한 내용은 [예상 타겟 수](/new-admin/push/push-create/schedule/target.md) 문서를 확인해 주세요.
{% endhint %}

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

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FmD5ZJhK4LLCuvxy04W2Q%2F7.png?alt=media" alt="" width="563">

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

#### **ⓐ 제목**

* 푸시 알림 메시지의 제목을 작성합니다.
* 제목은 최대 36자까지 작성할 수 있습니다. 광고 문구가 제목에 붙는 경우 최대 31자까지 작성할 수 있습니다.

#### **ⓑ 내용**

* 푸시 알림 메시지 내용을 설정합니다.
* 내용은 발송 OS가 Android이면 최대 50자, 전체나 iOS이면 최대 250자까지 작성할 수 있습니다. 발송 OS를 Android로 바꾸면 50자를 넘는 부분은 안내 후 잘립니다.

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

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

{% 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 비율로 크롭되고 푸시 알림 내용 하단에는 전체 크기의 이미지가 전송됩니다.

#### **ⓕ 클릭 동작**

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

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

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

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

{% hint style="warning" %}
커스텀 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 %}

#### **발송 OS별 입력 항목**

1단계에서 선택한 발송 OS에 따라 메시지 작성 항목이 달라집니다.

* **전체 :** Android와 iOS에 같은 내용으로 발송합니다. 메시지 본문에 기본 이미지, 부가 설정에 본문 이미지와 클릭 동작, 고급 옵션이 있습니다.
* **Android :** 메시지 본문에 기본 이미지와 이미지 항목이 있습니다.
  * 기본 이미지에서 설정 값 사용을 선택하면 설정 > 푸시 알림 설정에 올린 Android 기본 이미지를 사용하고, 선택하지 않으면 이미지에 직접 파일을 올립니다. (권장 이미지 사이즈 100 x 100px, 1:1 비율)
  * 부가 설정의 펼친 메시지를 켜면 펼친 제목, 펼친 내용, 큰 이미지를 입력할 수 있습니다. 펼친 메시지는 사용자가 알림을 펼쳤을 때 보이는 메시지입니다. 펼친 제목은 제목과 같은 한도, 펼친 내용은 최대 250자이며, 큰 이미지의 권장 사이즈는 1024 x 512px입니다.
* **iOS :** 부가 설정에서 큰 이미지를 올릴 수 있습니다. (권장 이미지 사이즈 1024 x 512px)

<div><figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FplJWoTkZ9wF64JZJeCN0%2F05_%EB%B0%9C%EC%86%A1OS%EB%B3%84%EC%9E%85%EB%A0%A5_Android%ED%8E%BC%EC%B9%9C%EB%A9%94%EC%8B%9C%EC%A7%80_hd.png?alt=media&amp;token=0988f734-7039-44b8-9c1d-9f7eacb89a68" alt=""><figcaption></figcaption></figure> <figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FmnmmbVVd6EYTiD0VqzNi%2F05b_%EB%B0%9C%EC%86%A1OS%EB%B3%84%EC%9E%85%EB%A0%A5_iOS%ED%81%B0%EC%9D%B4%EB%AF%B8%EC%A7%80_hd.png?alt=media&amp;token=d342fd4c-b46f-4766-a49d-c2e34019f6a6" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
발송 OS를 바꾸면 이미 넣은 이미지와 펼친 메시지 설정이 지워집니다. 발송 OS를 먼저 정한 뒤 메시지를 작성해 주세요.
{% endhint %}

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

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 발송 OS가 전체이면 Android와 iOS 미리보기를 탭으로 나눠 볼 수 있고, Android나 iOS를 선택하면 해당 OS 미리보기만 표시됩니다.

| Android                                                                                                                                                                                              | iOS                                                                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FkkKVhn9v2sqpqDyZ4anB%2F8.png?alt=media" alt="" width="375"></p> | <p><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FY5tIbFYXFzzwUh7hgZc0%2F9.png?alt=media" alt="" width="375"></p> |

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

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

* 메시지 설정을 마친 후, 캠페인 진행 전 테스트 메시지를 발송할 수 있습니다.
* 발송 테스트 대상은 한 번에 5명까지 발송 테스트를 할 수 있습니다.
* 입력한 회원 ID로 로그인한 기기에 유효한 토큰이 있는 경우 푸시 알림 메시지를 받을 수 있습니다.
* 발송 테스트는 1단계에서 선택한 발송 OS의 기기로만 발송됩니다. 전체이면 Android와 iOS 기기 모두에 발송됩니다.
* 개인화 정보를 업로드한 캠페인은 업로드한 파일의 첫 번째 행 값으로 바뀌어 발송됩니다.

{% hint style="warning" %}
선택한 발송 OS의 기기에서 테스트 회원 ID로 로그인되어 있지 않으면, 화면에는 발송 성공으로 표시되지만 실제로는 받지 못합니다.
{% endhint %}

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FP7guoORfiN0hkbdHzMWX%2F10.png?alt=media" alt="" width="188">

### **개인화 변수**

1단계에서 직접 업로드 > 개인화 정보를 선택하고 파일을 올린 경우에 사용할 수 있습니다.

* 제목과 내용 입력칸 위의 **\[텍스트 변수 추가]** 버튼을 클릭하면 변수 항목 추가 창이 나타납니다.
  * 변수 항목 : 1단계에서 업로드한 파일의 속성명 중 하나를 선택합니다. 메시지 발송 시 회원별 데이터로 치환되어 발송됩니다.
  * 대체 발송 값 : 회원의 값이 비어 있을 때 대신 들어갈 값입니다. 최대 10자까지 이모지 없이 입력해 주세요. (예: 고객님, 상품)
* 확인을 클릭하면 커서 위치에 #{속성명} 형태로 변수가 들어갑니다. 글자 수는 직접 입력한 글자 수와 치환되는 값을 나눠 표시합니다.
* A/B/N 테스트를 함께 사용하면 안마다 따로 작성할 수 있습니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FsG3dCMSalMg6kUMLVbYd%2F06_%ED%85%8D%EC%8A%A4%ED%8A%B8%EB%B3%80%EC%88%98%EC%B6%94%EA%B0%80%EC%B0%BD_hd.png?alt=media&amp;token=88f5e981-0575-47bc-9564-5dcb56dc8486" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}

* 대체 발송 값을 입력하지 않으면 값이 없는 회원에게는 빈 값으로 발송됩니다.
* 미리보기에는 회원별 값이 아니라 #{속성명}이 그대로 표시됩니다. 실제로 바뀐 문구는 발송 테스트로 확인해 주세요. 발송 테스트는 업로드한 파일의 첫 번째 행 값으로 치환됩니다.
  {% endhint %}

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FwCny8rAsNjbglNqGLTtg%2F06b_%EB%B3%80%EC%88%98%EC%9E%85%EB%A0%A5%EA%B3%BC%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0_hd.png?alt=media&amp;token=3471dc57-e556-4d07-bfcb-ec12d6499dd6" alt=""><figcaption></figcaption></figure>

### **A/B/N 테스트 설정**

메시지 안을 여러 개 만들어 어떤 안의 성과가 좋은지 비교할 수 있습니다. 메시지 안은 A안부터 J안까지 최대 10개 만들 수 있으며, 테스트 방식은 **수동 설정**과 **최적화** 두 가지입니다.

#### **수동 설정**

* 안별 발송 비율을 직접 정합니다. 미발송(대조군) 비율을 포함한 합이 100%가 되어야 합니다.
* 비율대로 나누고 남는 인원은 A안에 더해집니다.
* 3단계에서 단일 발송과 반복 발송을 모두 선택할 수 있습니다. 반복 발송이면 회차마다 그 시점의 대상자를 새로 뽑아 안별 비율로 나눠 발송하므로, 같은 고객이 매 회차 같은 안을 받는 것은 아닙니다.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FmoZrhloqV3nwQNAJGQX0%2F07_ABN%EC%88%98%EB%8F%99%EC%84%A4%EC%A0%95_hd.png?alt=media&amp;token=10788564-5f90-413b-af6c-2d845a016199" alt=""><figcaption></figcaption></figure>

#### **최적화**

일부 고객에게 먼저 모든 안을 발송해 성과를 비교한 뒤, 가장 성과가 좋은 안을 나머지 고객에게 자동으로 발송합니다. 예를 들어 10,000명에게 발송할 때 테스트 비율을 20%로 정하면 2,000명에게 먼저 테스트하고, 가장 성과가 좋은 안을 나머지 8,000명에게 보냅니다.

* **최적화 목표 :** 안을 비교할 기준으로 오픈, 회원가입, 주문 중 하나를 선택합니다. 오픈은 푸시를 눌러 앱을 연 수와 누르지 않고 수신 후 30분 안에 앱을 연 수, 회원가입과 주문은 푸시를 눌러 앱을 연 뒤 같은 세션 안에서 일어난 건과 누르지 않고 수신 후 30분 안에 앱을 열어 일어난 건입니다.
* **테스트 비율 :** 전체 대상 중 테스트에 참여할 비율입니다. 10%, 20%, 30%, 40%, 50% 중에서 선택하며, 어떤 고객이 테스트 그룹에 들어갈지는 무작위로 정해집니다.
* **선정 방식 :** 성과 측정 기간 동안 쌓인 최적화 목표 건수가 가장 많은 안이 선정됩니다. 테스트 그룹은 안별로 같은 수로 나뉘며, 건수가 같으면(모든 안이 0건인 경우 포함) 앞 순서의 안(A안부터)이 선정됩니다. 발송이 끝나면 메시지 안 탭에서 선정된 안에 \[선정] 표시가 붙습니다.
* 최적화는 3단계에서 테스트 일시와 성과 측정 기간을 정하는 방식이라 반복 발송을 사용할 수 없습니다.

**\[예상 타겟 수 확인]** 버튼을 클릭하면 설정한 비율에 따른 안별 예상 타겟 수를 확인할 수 있습니다. 최적화는 테스트 발송 예상 타겟 수와 테스트 종료 후 최적화 발송 예상 타겟 수를 함께 보여 줍니다.

조건을 채우지 않은 상태에서 최적화를 선택하면 아래 안내창이 나타납니다. 테스트 방식을 수동 설정으로 두거나, 예상 타겟 수와 메시지 안 개수를 맞춘 뒤 다시 선택해 주세요.

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FMNzukHZn9WJln66GVr1p%2F07b_%EC%B5%9C%EC%A0%81%ED%99%94%EC%A1%B0%EA%B1%B4%EC%95%88%EB%82%B4%EC%B0%BD_hd.png?alt=media&amp;token=a0c464bb-0be7-4deb-a960-97abf6f2b8e1" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
최적화는 예상 타겟 수가 1,000명 이상이고 메시지 안을 2개 이상 만들었을 때 사용할 수 있습니다.
{% endhint %}

***

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

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fxbxmuv00E09MBBuKcXyt%2Fimage.png?alt=media&amp;token=25f73ceb-8400-4548-9d7e-8510b4a6bf66" alt=""><figcaption></figcaption></figure>

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

#### **1-1. 단일 발송**

설정한 발송 일시에 맞춰 한 번만 발송됩니다.

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FiWvBJgyV7kKV6dVR8gtI%2F12.png?alt=media" alt="" width="563">

* 발송 유형 : 단일 발송 또는 반복 발송의 발송 유형을 선택합니다.
* 발송 일시 : 메시지가 발송될 발송 일자와 시간을 선택합니다.

#### **1-2. 반복 발송**

반복 주기 및 발송 시간을 선택하여 해당 캠페인을 반복하여 실행합니다.

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2FyRuO7OanSph8v2TsHGNG%2F13.png?alt=media" alt="" width="563">

* 발송 유형 : 단일 발송 또는 반복 발송의 발송 유형을 선택합니다.
* 발송 기간
  * 수동 종료 전까지 : 캠페인 진행 시점부터 수동으로 캠페인을 종료할 때까지 캠페인을 진행합니다.
  * 기간 지정 : 캠페인을 설정한 특정 기간 동안에만 진행합니다.
* 반복 설정
  * 일별 반복 : 발송 기간동안 캠페인을 반복할 일 간격을 설정할 수 있습니다.
  * 주별 반복 : 발송 기간동안 캠페인을 반복할 주 간격과 해당 주에 반복할 특정 요일을 설정할 수 있습니다. (요일 복수 선택 가능)
* 월별 반복 : 발송 기간동안 캠페인을 반복할 월 간격과 해당 월에 반복할 특정 날짜(일)를 설정할 수 있습니다.\
  \* 말일을 선택할 시 해당 월의 마지막 날에 발송됩니다.

<img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fwc8cnGgYnArWcLOFZUy3%2F14.png?alt=media" alt="" width="563">

* 발송 시간 : 반복 주기에 맞춰 메시지가 발송될 시간을 설정합니다.

{% hint style="warning" %}
발송 시간이 심야 시간(21:00\~08:00)일 경우 야간 광고 전송 수신 동의자에게만 발송되므로 예상 타겟 수를 다시 확인해야 합니다.\
정보통신망법에 의거하여 심야 시간에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다.
{% endhint %}

#### **1-3. A/B/N 테스트 최적화를 선택한 경우**

2단계에서 A/B/N 테스트 방식을 최적화로 선택하면 스케줄 항목이 아래와 같이 바뀝니다.

* 테스트 일시 : 테스트 그룹에 모든 안을 같은 비율로 발송할 일시를 정합니다.
* 성과 측정 기간 : 테스트 발송 후 성과를 집계할 기간입니다. 분(10\~60분)이나 시간(1\~24시간) 단위로 정하며, 기간이 끝나면 가장 성과가 좋은 안을 나머지 고객에게 발송합니다.

{% hint style="warning" %}
광고성 메시지는 심야(21:00\~08:00)에 야간 광고 수신 동의자에게만 발송됩니다. 테스트 일시만 심야로 정하면 최적화 발송을 할 수 없으니, 성과 측정이 끝나는 시점이 주간이 되도록 정해 주세요. (예: 테스트 07:00, 성과 측정 4시간이면 최적화 발송은 11:00)
{% endhint %}

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

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

발송 유형(단일 발송 / 반복 발송)에 따라 **적용 범위** 영역이 다르게 표시됩니다.

{% tabs %}
{% tab title="단일 발송" %}

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fn8HeHrSXDHrQ7XeyabFY%2Fimage.png?alt=media&amp;token=3be608b4-9c0c-403b-98bf-f0bd0f5ea1d9" alt=""><figcaption></figcaption></figure>

적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다.
{% endtab %}

{% tab title="반복 발송" %}

<figure><img src="https://2520521119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJv1HnfRtpjN2iazNfYpo%2Fuploads%2Fv0aCTyMCopsIcRRTbW0w%2Fimage.png?alt=media&amp;token=425b0e6f-e931-457e-8d10-96ffe83863fe" alt=""><figcaption></figcaption></figure>

적용 범위를 '이 캠페인만 적용' 또는 '같은 그룹 캠페인 포함' 중 선택할 수 있습니다.
{% endtab %}
{% endtabs %}

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

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

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

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

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

{% hint style="info" %}
단일 발송은 이 캠페인 자체가 반복 발송되지 않으므로, 적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다. 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 제한이 적용됩니다.

e.g. 푸시와 SMS 캠페인을 같은 그룹으로 묶으면, 푸시 발송 대상을 SMS 발송에서 제외할 수 있습니다.
{% endhint %}

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

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

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

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

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

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

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

#### **2-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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.groobee.ai/new-admin/push/push-create/schedule.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.