푸시 캠페인 등록

'푸시 캠페인 등록'은 프로젝트별 푸시 캠페인을 생성하는 기능입니다. 캠페인 이름, 푸시 타입, 발송 시간, 발송 대상, 다국어 메시지와 플랫폼별 옵션을 설정하여 예약 발송 또는 반복 발송 캠페인을 등록합니다.

➡️ 콘솔 경로: 푸시 알림 > 푸시 캠페인 등록

메뉴 권한이 있으면 접근과 검색을 수행합니다. 새 푸시 캠페인을 등록하려면 수정 퍼미션이 필요합니다.

기본 정보 설정

캠페인의 이름과 푸시 타입을 설정합니다. 캠페인을 새로 등록할 때 캠페인 이름은 필수이며 최대 50자까지 입력합니다.

항목	설명
캠페인 이름	캠페인 이름을 입력합니다.
푸시 타입	기본값은 `정보성`입니다. 광고성 푸시 캠페인은 `광고성`을 선택합니다.

스케쥴 설정

캠페인을 한 번만 발송할지, 기간과 주기에 따라 반복 발송할지 설정합니다. 타임존, 발송일, 발송 시간, 반복 여부는 필수 항목입니다.

반복 여부 > 반복 안함

반복 안함은 기본 선택값입니다. 지정한 발송일, 발송 시간, 타임존을 기준으로 캠페인이 1회 발송됩니다.

반복 여부 > 반복

반복을 선택하면 반복 기간과 반복 주기를 설정합니다. 반복 기간의 시작일과 종료일은 직접 설정하며 기본 입력값은 없습니다.

반복 주기는 매일 또는 매주 중에서 선택합니다. 매주를 선택하면 월요일부터 일요일까지의 요일 중 하나 이상을 선택합니다.

제외 날짜

반복 발송에서 제외할 날짜를 여러 개 선택합니다. 제외 날짜는 반복 설정보다 우선 적용됩니다.

대상 설정

캠페인을 발송할 국가와 App ID를 선택합니다. 국가와 App ID는 필수 항목이며 모두 다중 선택을 지원합니다.

발송 국가

국가는 드롭다운에서 선택합니다. 전체를 선택하면 모든 국가가 선택됩니다. 선택한 국가는 선택 영역에 표시되며, 처음 5개를 초과하는 항목은 +N개 더보기로 펼쳐 확인합니다.

App ID

App ID는 드롭다운에서 선택합니다. 전체를 선택하면 드롭다운의 모든 App ID가 선택됩니다. 검색어로 App ID를 검색하고 선택한 항목을 개별로 제거합니다.

메시지 설정

앱 메타 정보에 설정된 언어별로 푸시 메시지를 작성합니다. 제목과 본문은 필수 항목이며, 이미지 URL은 선택 항목입니다.

언어별 메시지

항목	설명
언어 선택 탭	앱 메타 정보 메뉴에서 설정된 언어만 표시됩니다.
기본 언어로 설정	한 번에 하나의 언어만 기본 언어로 설정합니다.
제목	최대 240자까지 입력합니다.
본문	최대 420자까지 입력합니다.
이미지 URL	최대 512자까지 선택적으로 입력합니다.

기본 언어 메시지는 반드시 입력합니다. 입력하지 않은 언어는 기본 언어 메시지로 대체 발송됩니다.

AI 자동 번역

AI 자동 번역은 현재 입력한 언어의 메시지를 기준으로 다른 언어의 메시지를 자동 입력합니다.

플랫폼별 옵션 설정

Android, iOS, macOS App ID별로 해당 OS에서 지원하는 옵션 항목이 표시됩니다. 미설정 옵션은 기본값으로 발송됩니다.

구분	항목
공통 옵션	-
FCM 옵션	사운드, 아이콘, 우선순위, 덮어쓰기, 클릭 액션, 채널 ID, 커스텀 데이터
APNs 옵션	사운드, 뱃지, 카테고리

FCM 옵션의 커스텀 데이터는 Key와 Value를 문자열로 입력하며, Key는 중복할 수 없습니다.

설정 방법

푸시 캠페인 등록으로 이동합니다.
프로젝트를 선택하고 검색을 클릭합니다.
새 푸시 캠페인을 클릭합니다.
기본 정보, 발송 시간, 발송 대상, 메시지와 플랫폼별 옵션을 입력하거나 선택합니다.
저장을 클릭합니다.

캠페인 조회

프로젝트를 선택하면 캠페인 목록을 조회합니다. 캠페인 목록은 최신 수정일 기준 내림차순으로 정렬됩니다.

상태 필터와 검색

항목	설명
상태	`전체`, `예정`, `진행`, `완료`, `취소` 중 하나 이상을 상태 필터에 적용합니다. 기본 적용값은 `전체`입니다.
검색 조건	캠페인 ID 또는 캠페인 이름을 선택합니다.
검색어	선택한 검색 조건에 맞는 검색어를 입력합니다.

캠페인 상태

상태	설명
`예정`	발송 시간이 현재보다 미래인 상태입니다.
`진행`	현재 발송 중인 상태입니다.
`완료`	모든 발송이 완료된 상태입니다.
`취소`	발송이 중단된 상태입니다.

설정 방법

푸시 캠페인 등록으로 이동합니다.
프로젝트를 선택하고 검색을 클릭합니다.
상태를 상태 필터에 적용하고, 검색 조건을 선택한 뒤 검색어를 입력해 캠페인을 조회합니다.
캠페인 목록에서 상태, 발송일, 타임존, 최종 수정자와 최종 수정일을 확인합니다.

캠페인 수정

예정 상태의 캠페인만 수정합니다. 캠페인 목록에서 캠페인 이름을 클릭하면 캠페인 상세로 이동합니다.

(이미지 추가: 캠페인 상세 화면)

설정 방법

캠페인 목록에서 수정할 캠페인의 캠페인 이름을 클릭합니다.
캠페인 상세에서 수정할 값을 변경합니다.
수정을 클릭합니다.

캠페인 복사

캠페인을 복사하면 해당 캠페인의 설정값이 입력된 새 푸시 캠페인으로 이동합니다. 날짜값은 복사되지 않으므로 새로 입력합니다.

설정 방법

캠페인 목록에서 복사할 캠페인의 복사를 클릭합니다.
새 푸시 캠페인에서 복사된 설정값을 확인합니다.
날짜값을 새로 입력합니다.
필요한 값을 수정한 뒤 저장을 클릭합니다.

캠페인 취소

예정 또는 진행 상태의 캠페인은 발송을 취소합니다. 진행 상태의 캠페인을 취소하면 이후 발송만 중단되고 이미 발송된 건은 유지됩니다.

설정 방법

캠페인 목록에서 취소할 캠페인의 취소를 클릭합니다.
"캠페인 발송을 취소하시겠습니까?" 확인 창에서 확인을 클릭합니다.
취소가 완료되면 "푸시 캠페인 발송이 취소되었습니다." 메시지가 표시됩니다.

다음 단계

테스트 발송이 필요하면 토큰 조회를 참조하세요.