푸시 작업 채널 설정

최근 업데이트 2026. 10. 05.

1. 기능 개요

운영 모듈은 현재 Webhook 채널, 메시지 푸시, 클라이언트 채널, 서드파티 플랫폼 채널(위챗, KakaoTalk, Douyin) 등 네 가지 도달 방식을 지원합니다. Webhook 채널로 기업이 자체 구축한 채널 플랫폼과 연동할 수도 있고, AE 운영 모듈에 사전 설정된 메시지 푸시 채널을 바로 사용하여 일반적인 App 푸시 플랫폼 기능을 연동할 수도 있습니다. 또한 AE SDK와 연동하는 방식으로 클라이언트 채널을 연동하여 앱 내 실시간 도달을 구현할 수 있습니다. 서드파티 플랫폼으로는 위챗 미니 프로그램 구독 메시지, KakaoTalk Brand Message, Douyin 추천 페이지 게임 카드 연동을 지원하여, 이러한 플랫폼에서 메시지 푸시를 더욱 편리하고 빠르게 할 수 있습니다.

2. 채널 생성

2.1 Webhook 채널

채널 설정 페이지(운영 설정 > 채널 설정)에서 채널 생성과 기존 채널 관리를 할 수 있으며, 관리 작업으로는 테스트 발송, 채널 활성화/비활성화, 편집/삭제 등을 지원합니다.

2.1.1 채널 생성

오른쪽 상단의 +채널 생성을 클릭하면 Webhook 채널 생성 페이지로 들어갑니다.

• 채널 이름: Webhook 채널의 이름
• URL: 메시지 푸시를 받는 인터페이스 주소입니다. 같은 URL 주소로 여러 채널을 설정할 수 있습니다.
• 사용자 지정 헤더: 활성화하면 해당 URL로 보내는 요청에 사용자 지정 요청 헤더를 추가할 수 있습니다.
• 전송 ID: 메시지 푸시 대상 유저의 주체 ID이며, 유저 속성 중 숫자형과 문자열형 속성을 선택할 수 있습니다. 타겟 유저 인원 예측 시 전송 ID가 비어 있는 유저는 제외됩니다(예: 게임 내 우편 시스템에서 메시지를 받는 대상 유저 ID는 캐릭터 ID이고, SMS 시스템에서 메시지를 받는 대상 유저 ID는 휴대폰 번호 등).
• 채널 검증: 채널 검증을 활성화하고 키를 입력하면 불법 호출을 방지하여 채널의 보안을 높일 수 있습니다.
• 도달 퍼널 설정: 도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다.
• 컨텐츠 템플릿: 해당 채널이 유저에게 보내는 구체적인 내용의 템플릿을 직접 정의할 수 있습니다. 텍스트, 동적 텍스트, 숫자, 단일 선택 드롭다운, 날짜, 시간, 객체 그룹 등의 필드 타입을 지원합니다. 예를 들어 우편 발송 채널에서는 객체 그룹 타입으로 아이템 내용(예: 아이템 ID와 아이템 수량)을 설정할 수 있습니다.
• 커스텀 파라미터: 채널 요구 사항에 따라 선택적으로 추가하며, 이 파라미터는 그대로 전달(패스스루)됩니다.

Webhook 채널 연동에 관한 자세한 기술 내용은 Webhook 채널 연동 문서를 참고하십시오.

2.1.2 기존 채널 관리

• 테스트 발송

채널을 생성하면 기본적으로 비활성화 상태입니다. 먼저 테스트 발송을 해 보고, 발송이 성공하는 것을 확인한 후 채널을 활성화할 수 있습니다.

작업에서 종이비행기 버튼을 클릭하여 테스트 발송 팝업으로 들어간 후, 선택한 채널의 설정에 따라 관련 정보를 입력합니다.

그런 다음 요청 보기를 클릭하여 시스템이 생성한 요청 구조체가 이번 테스트 발송 요구 사항에 맞는지 미리 보고, 이상이 없으면 발송 확인을 클릭하여 테스트 발송을 진행합니다.

작업이 성공하면 시스템이 이번 테스트 발송의 성공 여부도 반환하므로, 상태를 확인하거나 문제를 해결하는 데 활용할 수 있습니다.

• 채널 활성화/비활성화

  • Webhook 채널을 활성화하면 새 작업을 생성할 때 해당 채널을 선택할 수 있습니다.
  • Webhook 채널을 비활성화하면 새 작업을 생성할 때 선택할 수 없고(드롭다운에 표시되지 않음), 실행 중인 작업은 자동으로 종료되며, 승인 중인 작업은 자동으로 취소됩니다.

• 편집/삭제

채널을 비활성화한 후에만 편집하거나 삭제할 수 있습니다.

2.2 메시지 푸시

현재 사전 설정된 메시지 푸시 플랫폼은 FCM, JPush 푸시, APNs이며, 필요에 따라 해당 앱을 연동할 수 있습니다.

2.2.1 FCM

• 채널 이름: FCM 채널의 이름이며, 중복된 이름은 사용할 수 없습니다.
• 전송 ID: 푸시 대상 유저의 FCM registration token 필드입니다. 먼저 FCM registration token을 유저 속성으로 전송해야 합니다.
• 서버 개인 키: 해당 프로젝트의 FCM 서버 개인 키 파일을 업로드해야 합니다. 키를 가져오는 방법은 FCM 서버 키 가져오기 가이드를 참고하십시오.
• 도달 퍼널 설정: 도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다.
• 패스스루 파라미터: 필요에 따라 패스스루 파라미터를 추가할 수 있습니다. 패스스루 파라미터는 주로 업무 측 앱의 내부 비즈니스 로직 처리나 특수한 표시 요구 사항에 사용됩니다.

FCM registration token 필드 전송과 도달 퍼널 설정은 메시지 푸시 기술 연동 문서에서 FCM 푸시 관련 기술 연동 내용을 참고하십시오.

2.2.2 JPush

• 채널 이름: 직접 정하는 채널 이름이며, 중복된 이름은 사용할 수 없습니다.
• 전송 ID: 푸시 대상 유저의 JPush ID 필드입니다. 먼저 JPush ID를 유저 속성으로 전송해야 합니다.
• AppKey & MasterSecret: JPush 푸시 플랫폼에 등록한 앱의 AppKey와 MasterSecret입니다. JPush 앱 파라미터를 가져오는 방법은 JPush 앱 연동 파라미터 가져오기 가이드를 참고하십시오.
• 도달 퍼널 설정: 도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다.
• 패스스루 파라미터: 필요에 따라 패스스루 파라미터를 추가할 수 있습니다. 패스스루 파라미터는 주로 업무 측 앱의 내부 비즈니스 로직 처리나 특수한 표시 요구 사항에 사용됩니다.

JPush ID 필드 전송과 도달 퍼널 설정은 메시지 푸시 기술 연동 문서에서 JPush 푸시 관련 기술 연동 내용을 참고하십시오.

2.2.3 APNs

• 채널 이름: 직접 정하는 채널 이름이며, 중복된 이름은 사용할 수 없습니다.
• 전송 ID: 푸시 대상 유저의 APNs Token 필드입니다. 먼저 APNs Token을 유저 속성으로 전송해야 합니다.
• 인증서 타입: P12 또는 P8 인증서를 선택하여 설정할 수 있으며, 운영 환경 또는 개발 환경도 선택할 수 있습니다. APNs 인증서를 가져오는 방법은 APNs 푸시 인증서 설정 가이드를 참고하십시오.
• 도달 퍼널 설정: 도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다.
• 패스스루 파라미터: 필요에 따라 패스스루 파라미터를 추가할 수 있습니다. 패스스루 파라미터는 주로 업무 측 앱의 내부 비즈니스 로직 처리나 특수한 표시 요구 사항에 사용됩니다.

APNs Token 필드 전송과 도달 퍼널 설정은 메시지 푸시 기술 연동 문서에서 APNs 푸시 관련 기술 연동 내용을 참고하십시오.

2.2.4 테스트 발송

채널 설정을 완료한 후 채널 설정에서 바로 채널의 효과를 테스트할 수 있습니다. 해당 채널의 작업 열에 있는 테스트 발송 버튼(아래 그림 참고)을 클릭하면 채널 테스트로 들어갑니다.

테스트 발송 시에는 효과를 검수할 테스트 계정의 전송 ID(AE의 유저 상세 검색 기능으로 테스트 계정의 전송 ID를 조회할 수 있음)와 메시지 알림의 제목, 내용 등의 정보를 입력해야 합니다. 채널마다 팝업이 조금씩 다릅니다. 모든 채널에서 이동 방식(앱 열기 / 웹페이지 열기 / 지정 페이지 열기)과 썸네일 이미지 URL을 설정할 수 있습니다. APNs와 JPush 채널에서는 발송 환경에서 운영 환경 또는 개발 환경도 선택해야 하며, JPush 채널에는 오른쪽 아이콘 주소가 추가로 있습니다. FCM과 APNs 채널의 팝업에는 채널에 설정한 패스스루 파라미터도 표시됩니다. 발송 확인을 클릭하면 휴대폰에서 결과를 확인할 수 있습니다.

2.3 클라이언트 채널

클라이언트 채널은 프로젝트 단위의 클라이언트 채널 기능을 활성화하고 AE SDK와 연동한 후에 사용할 수 있습니다. 이 기능을 체험하려면 담당 고객 매니저에게 문의하십시오.

2.3.1 채널 생성

오른쪽 상단의 +채널 생성을 클릭하면 클라이언트 채널 생성 페이지로 들어갑니다.

• 채널 이름: 클라이언트 채널의 이름
• 메시지 타입: 클라이언트는 푸시 메시지를 받은 후 메시지 타입으로 앱 내의 서로 다른 트리거 시나리오를 구분합니다. 예를 들어 "팝업"의 메시지 타입을 popup으로 정의할 수 있습니다.
• 전송 ID: 메시지를 받을 대상 유저의 ID 타입이며, 유저 속성(숫자형과 문자열형 속성) 또는 클라이언트 파라미터를 선택할 수 있습니다. 타겟 유저 인원 예측 시 전송 ID가 비어 있는 유저는 제외됩니다(예: 게임 내 우편 시스템에서 메시지를 받는 대상 유저 ID는 캐릭터 ID이고, SMS 시스템에서 메시지를 받는 대상 유저 ID는 휴대폰 번호 등).
• 도달 퍼널 설정: 도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다. 도달 퍼널 이벤트에는 운영 작업이 전달한 패스스루 파라미터가 포함되어야 합니다. 자세한 내용은 클라이언트 트리거 SDK 연동 문서의 도달 퍼널 설정을 참고하십시오.
• 컨텐츠 템플릿: 해당 채널이 유저에게 보내는 구체적인 내용의 템플릿을 직접 정의할 수 있습니다. 텍스트, 동적 텍스트, 숫자, 단일 선택 드롭다운, 날짜, 시간, 객체 그룹 등의 필드 타입을 지원합니다. 예를 들어 우편 발송 채널에서는 객체 그룹 타입으로 아이템 내용(예: 아이템 ID와 아이템 수량)을 설정할 수 있습니다.
• 커스텀 파라미터: 채널 요구 사항에 따라 선택적으로 추가하며, 이 파라미터는 그대로 전달(패스스루)됩니다.

2.3.2 테스트 발송

채널을 생성하면 기본적으로 비활성화 상태입니다. 먼저 테스트 발송을 해 보고, 채널이 정상적으로 연결되는 것을 확인한 후 활성화하여 사용할 수 있습니다. 작업 열의 종이비행기 버튼을 클릭하면 테스트 발송 절차로 들어갑니다.

클라이언트 트리거 방식의 테스트 발송에는 테스트 디바이스가 필요합니다. 테스트 디바이스 목록에서 테스트 디바이스를 선택하거나 추가하고 디버그 모드를 활성화하십시오. 디버그 모드를 활성화하는 방법은 클라이언트 트리거 연동 문서를 참고하십시오.

푸시 콘텐츠를 확인한 후 보내기를 클릭하여 테스트를 시작하고, 진행률 표시줄로 진행 상황을 확인합니다. 진행률 표시줄에 작업 가져오기가 성공으로 표시되면 디바이스에서 푸시 콘텐츠를 받았는지 확인할 수 있습니다. 시스템이 이번 테스트 발송 결과를 반환하므로, 상태를 확인하거나 문제를 해결하는 데 활용할 수 있습니다.

2.3.3 채널 관리

• 채널 활성화/비활성화

  • 클라이언트 채널을 활성화하면 새 작업을 생성할 때 해당 채널을 선택할 수 있습니다.
  • 클라이언트 채널을 비활성화하면 새 작업을 생성할 때 선택할 수 없고(드롭다운에 표시되지 않음), 실행 중인 작업은 자동으로 종료되며, 승인 중인 작업은 자동으로 취소됩니다.

• 채널 편집/삭제

채널을 비활성화한 후에만 편집하거나 삭제할 수 있습니다.

클라이언트 채널 연동에 관한 자세한 내용은 클라이언트 채널 연동 문서를 참고하십시오.

2.4 서드파티 플랫폼(위챗/KakaoTalk/Douyin)

서드파티 플랫폼 탭에는 현재 위챗 - 구독 메시지, KakaoTalk - Brand Message, Douyin - 추천 페이지 게임 카드 세 가지 채널이 있습니다. 프로젝트에서 필요한 채널이 보이지 않거나 다른 서드파티 채널과 연동해야 하는 경우 담당 고객 매니저에게 문의하십시오.

모범 사례는 위챗 미니 게임 메시지 연동 모범 사례를 참고하십시오.

2.4.1 앱 권한 부여

앱 권한 부여 입구에서 위챗 미니 프로그램 템플릿 정보의 호출 권한을 부여할 수 있습니다.

같은 미니 프로그램은 같은 APP ID와 APP Secret을 공유하므로 한 번만 권한을 부여하면 됩니다.

서드파티 플랫폼 채널 오른쪽 위의 앱 권한 부여를 클릭하여 그림과 같은 화면으로 들어갑니다. 앱 이름을 직접 정하고, 미니 프로그램의 APP ID와 APP Secret을 입력합니다.

입력한 정보가 올바르면 연결 및 저장을 클릭한 후 시스템에 연결 성공이 표시됩니다.

AppID와 AppSecret이 유효한 것으로 확인되면 access_token이 2시간마다 자동으로 갱신되어 앱의 정상적인 연결 상태가 유지됩니다.

2.4.2 채널 생성

서드파티 플랫폼 - 위챗 구독 메시지 오른쪽 상단의 +채널 생성을 클릭하면 구독 메시지 채널 생성 페이지로 들어갑니다.

• 채널 이름: 위챗 구독 메시지 채널의 이름

• 인증 앱 선택: 채널을 생성할 때 연결 상태가 정상인 앱을 선택할 수 있으며, 채널은 해당 앱의 위챗 백엔드에서 사용할 수 있는 모든 구독 메시지 템플릿을 자동으로 가져옵니다. 앱의 연결 상태가 비정상이면 먼저 앱 권한 부여에서 확인하십시오.

• 유저 OpenID: 메시지를 받을 타겟 유저의 ID 타입으로, 유저 속성(숫자 및 문자열 타입 속성)을 선택할 수 있습니다. 타겟 유저 인원을 예측할 때 전송 ID가 비어 있는 유저는 제외됩니다. OpenID의 전송 방법은 기술 문서를 참조하십시오.

• 미니 프로그램 설정: 구독 메시지 카드를 클릭했을 때 이동할 미니 프로그램 화면에 대한 설정입니다. 채널 수준의 파라미터 설정이며, 작업 수준에서 덮어쓸 수 있습니다.

  • 미니 프로그램 타입: formal(정식 버전), developer(개발 버전), trial(체험 버전)이 있으며, 입력하지 않으면 기본값은 정식 버전입니다
  • 미니 프로그램 언어: zh_CN(중국어 간체), en_US(영어), zh_HK(중국어 번체), zh_TW(중국어 번체)가 있으며, 입력하지 않으면 기본값은 zh_CN(중국어 간체)입니다
  • 이동 주소: 템플릿 카드를 클릭한 후 이동할 페이지로, 이 미니 프로그램 내의 페이지만 가능합니다. 파라미터를 포함할 수 있습니다(예: index?foo=bar). 이 필드를 입력하지 않으면 템플릿에 이동 기능이 없습니다.

• 컨텐츠 템플릿:

위챗 미니 게임의 푸시 메시지는 유저가 구독에 성공한 후에만 유저의 위챗 메시지로 발송될 수 있습니다.

앱의 권한 부여와 연결이 완료되면 채널은 token으로 위챗 백엔드에서 유저가 생성한 모든 구독 메시지 템플릿을 한 번에 가져올 수 있습니다. 필요한 템플릿을 채널에 저장해 두고 운영 작업에서 선택하여 사용할 수 있습니다.

템플릿 목록 새로고침 버튼을 클릭하면 인터페이스를 다시 호출하여 채널의 새 템플릿 목록을 가져올 수 있습니다.

• 컨텐츠 템플릿 파라미터가 지원하는 전체 타입

템플릿 파라미터의 데이터 타입은 위챗 메시지 템플릿에서 정의되며, 가져온 파라미터 타입을 기준으로 합니다.

위챗 데이터 타입	타입 설명	Mapping 운영 입력 방식	설명	파라미터 규격 제한
thing.DATA	사물	동적 텍스트	한자, 숫자, 알파벳, 기호 조합 가능	20
number.DATA	숫자	숫자	숫자만 가능, 소수 포함 가능	32
letter.DATA	알파벳	텍스트	알파벳만 가능	32
time.DATA	시간	시간	24시간제 시간 형식(연월일 추가 지원), 기간 입력 지원. 두 시점은 "~" 기호로 연결
date.DATA	날짜	날짜	연월일 형식(24시간제 시간 추가 지원), 기간 입력 지원. 두 시점은 "~" 기호로 연결
symbol.DATA	기호	동적 텍스트	기호만 가능	5
amount.DATA	금액	텍스트	통화 기호 1개 + 10자리 이내 숫자, 소수 포함 가능, 끝에 "元" 추가 가능	11
phone_number.DATA	전화	텍스트	숫자, 기호	17
car_number.DATA	차량 번호	텍스트	8자리 이내, 첫 자리와 마지막 자리는 한자 가능, 나머지는 알파벳 또는 숫자	8
name.DATA	이름	텍스트	한자만 10자 이내 또는 알파벳이나 기호만 20자 이내	한자 10 알파벳 20
phrase.DATA	한자	텍스트	한자 5자 이내	5

2.4.3 채널 관리

• 채널 활성화/비활성화

  • 채널 스위치를 켠 후 앱 연결에 성공하면 채널은 연결 정상 상태가 되고, 그렇지 않으면 연결 오류 상태가 됩니다.
  • 채널을 활성화하면 새 작업을 생성할 때 해당 채널을 선택할 수 있습니다;
  • 채널을 비활성화하면 새 작업을 생성할 때 선택할 수 없고(드롭다운에 표시되지 않음), 실행 중인 작업은 자동으로 종료되며, 승인 처리 중인 작업은 자동으로 철회됩니다.

• 채널 편집/삭제

채널을 비활성화한 후에만 편집하거나 삭제할 수 있습니다.

위챗 구독 메시지 채널 연동에 관한 기술 문서는 위챗 구독 메시지 채널 연동 문서를 참고하십시오.

3. 피로도 제어

피로도 제어는 여러 운영 작업이 같은 도달 채널을 사용할 때, 한 유저가 일정 기간 동안 같은 유형의 채널에서 받을 수 있는 최대 푸시 횟수를 제한하는 기능입니다. 도달 방식별로 피로도 제어 규칙을 설정하고, 운영 작업을 생성할 때 피로도 제어를 활성화하여 유저에게 과도한 방해를 줄일 수 있습니다.

운영 설정 > 피로도 제어로 들어가 채널의 스위치를 켜면 편집 상태가 됩니다. 필요에 따라 해당 채널의 피로도 제어 규칙을 편집할 수 있으며(Webhook 채널은 채널별로 설정), 여러 조건은 AND 관계입니다. 편집을 마치면 오른쪽 상단의 저장을 클릭합니다. 현재 지원하는 주기 단위는 분, 시간, 일, 주입니다.