[[신규기능]] 테스트 메시지 발송

푸시 메시지 테스트 하기 

Growth actions > Push Message > 우측 상단 +Create Push Message를 선택 > what부분에서 선택 가능합니다.
푸시 메시지를 생성할 때, 오디언스 타입을 선택합니다.
이 때 선택한 오디언스 타입에 따라 테스트 메시지를 시행하는 방식이 결정됩니다.

• 오디언스 타입
  • Device : 테스트 기기 선택 / 테스트 대상 입력
  • User : 테스트 유저 선택 / 테스트 대상 입력(유저 ID 조회, 직접 입력)

 

푸시 메시지 > 오디언스 타입 : Device 

테스트 메시지 전송은 푸시 설정 단계 마지막인 When 부분에서 가능합니다.

오디언스 타입이 Device 인 경우, 푸시 메시지 캠페인을 생성할 수 있는 채널은 App/Web 채널뿐입니다.
따라서 테스트 기기 선택 및 테스트 대상 입력 시에는 기등록한 테스트 기기를 선택하거나
각 플랫폼의 식별값을 직접 입력하여 테스트 메시지를 발송할 수 있습니다.

 

1. 테스트 기기 선택

Growth Action > Settings > Test Message Setting 탭에서 미리 등록한 테스트 기기를 최대 5개까지 선택할 수 있습니다.
>> 테스트 기기 등록방법 알아보기 

메시지 발송 전 플랫폼 및 언어 선택을 확인하고, 테스트를 진행해 주세요.

 

2. 테스트 대상 입력

테스트 기기를 미리 등록하지 못한 경우 식별값을 직접 입력하여 테스트 할 수 있습니다.
테스트를 성공적으로 수행한 경우, 해당 식별값으로 테스트 기기를 저장할 수 있습니다.

성공 시 토스트 알람 내 [해당 기기 저장하기] 버튼을 클릭해 주세요. 기기명만 입력하면 테스트 기기가 생성됩니다.

 

푸시 메시지 > 오디언스 타입 : User

테스트 메시지 전송은 푸시 설정 단계 마지막인 When 부분에서 가능합니다.

오디언스 타입이 User인 경우, 모든 채널에서 푸시 메시지 캠페인을 생성할 수 있습니다.
테스트 방식은 크게 기존에 등록했던 테스트 유저를 선택하거나, 테스트 대상을 입력하는 방식으로 나뉩니다.
테스트 대상 입력 방식은 다시 2가지로 나뉩니다.

1. 유저 아이디를 알고 있는 경우 해당 아이디를 조회하여 선택할 수 있습니다.
2. 식별값 및 카카오 ID, 번호를 알고 있는 경우 값을 직접 입력하여 테스트를 수행할 수 있습니다.

 

1. 테스트 유저 선택

Growth Action > Settings > Test Message Setting 탭에서 미리 등록한 유저를 최대 5개 선택할 수 있습니다.

>> 테스트 유저 등록하는 방법

유저의 선택 시 테스트 가능한 유저를 확인할 수 있습니다.
조회일을 기준으로 테스트 메시지 발송 가능 여부를 확인해 보세요.

[[인용:경고:보통]] 유의 사항
테스트 유저 목록에서 '테스트 가능'이었으나 조회 후 해당 테스트 유저의 기기가 확인되지 않는 경우,
새로고침 버튼을 클릭해 주세요.

 

2. 테스트 대상 입력

오디언스 타입이 User인 경우, 오디언스 타입이 Device인 경우와 다른 점이 있습니다.

먼저, 식별값을 입력해서 테스트에 성공하더라도 해당 식별값으로 테스트 유저를 저장할 수 없습니다. 마찬가지로 번호나 카카오 아이디를 입력하여 테스트를 성공하더라도 해당 번호나 카카오 아이디로 테스트 유저로 저장하는 것은 불가능합니다.
테스트 유저는 유저 아이디 조회의 방식으로만 저장이 가능하기 때문에 유저 아이디를 조회했을 경우에만 해당 유저 아이디로 테스트 유저를 저장할 수 있습니다.

 

2-1. 유저 아이디 조회

App/Web 채널

abx:user_id를 사용하여 수집된 아이디를 조회하면 해당 아이디로 로그인 된 기기 중에서 푸시 토큰 연동이 완료된 기기를 확인할 수 있습니다.

이때, 로그인 된 기기는 메시지 발송을 위해 선택한 플랫폼(Android, iOS, Web)을 기준으로 조회됩니다. 예를 들어, 특정 아이디가 iOS 플랫폼에 로그인되어 있고 Android 플랫폼은 로그인되어 있지 않은 경우, Android 플랫폼 선택 후 해당 아이디를 조회하면 연결된 기기가 없다는 결과가 표시됩니다.

아이디 조회 후, 기기 상세 정보에서 푸시 토큰 연동이 완료된 기기 리스트가 나오면, 최대 5개까지 기기를 선택하여 메시지를 발송할 수 있습니다.

[[인용:경고:보통]] 기기 상세 정보에서 노출되는 기기는 푸시 토큰 연동이 완료된 기기만 노출됩니다.
🧐 왜 푸시 토큰 연동이 완료된 기기만 선택할 수 있나요?

 

Kakao와 SMS 채널

Kakao와 SMS 채널은 App/Web 채널과 달리 유저 아이디별로 Kakao ID 및 번호가 1:1로 매칭되어 있기 때문에 아이디 조회 후 기기를 선택하지 않아도 됩니다. 따라서 아이디를 조회하면 테스트 가능/불가능 여부만 확인할 수 있습니다.
이 때 가능/불가능 여부의 기준은 아래와 같습니다.

- Kakao: 핸드폰 번호 또는 Kakao ID 유무

[[인용:경고:보통]] 주의사항
Kakao 채널의 경우 핸드폰 번호 또는 카카오 ID로 메시지가 발송되며,
실제 메시지 발송 성공 시 번호 또는 Kakao ID 중 어떤 요인으로 성공했는지를 판별할 수 없습니다.

- SMS: 핸드폰 번호 유무

 

유저 아이디 조회 시 조회 결과에서 [+테스트 유저 저장] 버튼을 클릭하여 조회된 아이디로 테스트 유저를 저장할 수 있습니다.

 

2-2. 직접 입력

선택한 채널에 따라 식별값, Kakao ID, 번호를 직접 입력하여 메시지를 발송할 수 있습니다. 그러나 User 타입의 경우 직접 입력 시 테스트에 성공하더라도 해당 식별값, Kakao ID, 번호로 테스트 기기 및 테스트 유저는 저장할 수 없습니다.

 

App/Web 채널

App/Web 채널의 경우, 오디언스 타입이 Device인 경우와 동일하게 각 플랫폼 별 식별값을 직접 입력하여 테스트를 수행할 수 있습니다.

>> 각 플랫폼 별 식별값 안내 바로가기

 

Kakao와 SMS 채널

Kakao는 Kakao ID 또는 번호를 직접 입력하여 테스트를 수행할 수 있으며, SMS는 번호를 직접 입력하여 테스트를 수행할 수 있습니다.

 

푸시 메시지 테스트 결과 실패 시 대응방법

푸시 메시지 실패 시 에러 코드에 따른 대응 방법을 안내드립니다.

 

App/Web 채널 시 에러 

에러코드	에러 메시지	설명	해결책
40001	MessageTooBig	FCM / 메시지 길이 오류	메시지 길이 제한 확인 후 다시 시도해 주세요.
40002	MismatchSenderId	FCM / 앱의 Sender ID와 FCM 서버에 등록된 앱의 Sender ID가 일치하지 않을 때 발생	FCM 설정에서 앱의 Sender ID를 확인하고 메시지를 보낸 앱의 Sender ID와 일치하도록 업데이트 해 주세요.
40003	NotRegistered	FCM / 기기 토큰이 주제에서 비활성화된 경우. 앱을 삭제한 경우 주로 발생	기기가 삭제되었거나 유효하지 않은 토큰입니다. 앱을 다시 설치 후 시도해주세요.
40004	Canonical RegistrationId	FCM / 같은 기기에 여러 개의 등록 ID가 있을 때 발생하며, 더 이상 사용하지 않는 등록 ID를 대체로 업데이트 권유 에러	새로운 등록 ID를 사용하도록 클라이언트 앱을 업데이트하고 등록 ID를 최신으로 유지해 주세요.
40005	InvalidRegistration	FCM / FCM에 등록되지 않은 디바이스로 메시지를 보내려고 할 때 발생	메시지를 보내기 전에 FCM에 등록되었는지 확인해 주세요. 등록되지 않은 디바이스는 등록 후에 메시지를 받을 수 있습니다
40006	Unavailable	FCM / FCM 서비스가 일시적으로 사용 불가능할 때 발생하는 에러	일시적인 서비스 장애일 경우, 잠시 후에 다시 시도해 주세요.
40041	InvalidTopicException	APNS / 이 주제를 푸시하는 것이 허용되지 않음. DFN에 등록한 bundle_id 와 주제의 bundle_id 가 일치하지 않을때 발생	DFN에 등록한 bundle_id 와 APNS 혹은 앱 빌드 시 등록한 bundle_id 가 일치하는지 확인 후 시도해 주세요.
40042	BadDeviceToken	APNS / 요청에 명시된 토큰이 유효하지 않음. 인증 환경이 달라졌을때 주로 발생	토큰이 유효한지, 토큰이 환경과 일치하는지 확인해야 합니다. (개발환경으로 빌드된 앱에서 발급된 토큰은 프로덕션 APNS 서버에서 처리될 수 없습니다.)
40043	BadCertificate	APNS / APNS 인증서가 유효하지 않거나, 인증서가 잘못 설정되었을 때 발생	올바른 인증서를 생성하고 서버에 적용하세요. 인증서를 재설정하고 APNS 설정을 다시 확인해야 합니다
40044	InvalidProviderToken	APNS / 잘못된 디바이스 토큰이나 인증 문제로 인해 APNS가 푸시를 처리하지 못할 때 발생	올바른 디바이스 토큰을 사용하고, 인증 문제를 해결해야 합니다. 인증서나 인증 정보를 다시 확인해 주세요.
40045	ExpiredProviderToken	APNS / 디바이스 토큰이 만료된 경우.	푸시 토큰이 만료되었습니다. 토큰을 재발급 받은 후 시도해 주세요.
40081	PayloadTooLarge	Web / 푸시 메시지의 페이로드가 제한 크기를 초과했을 때 발생	더 작은 크기의 페이로드를 사용하거나, 필요한 정보를 최소한으로 포함하도록 페이로드를 최적화하세요. (최대 크기 제한 문의)
40082	TooManyRequest	Web / 단기간 내에 너무 많은 푸시 요청을 보낸 경우에 발생할 수 있습니다.	한 기기(쿠키)에 너무 많은 푸시 요청이 나가지 않도록 캠페인 설정을 확인해 주세요.
40083	ExpiredSubscription	Web / 구독이 만료되었거나 더 이상 유효하지 않은 경우에 발생	만료된 구독을 확인하고, 만료된 구독을 갱신하거나 삭제하세요.
50001	UnHandledException	예기치 못한 오류	재시도 시에도 문제가 발생한다면 고객센터를 통해 문의해 주세요.

 

Kakao 채널 시 에러

에러코드	에러 메시지	설명	해결책
40001	InvalidSenderKey Exception	발신 프로필 키가 유효하지 않음	세팅된 발신 프로필 상태를 확인해 주세요.
40002	TalkUserIdNotFonud	유효하지 않은 앱 유저 ID 요청	카카오 앱의 user id 를 확인 후 시도해 주세요.
40003	Invalid UserKeyException	잘못된 형식의 유저키 요청	등록된 전화번호, 앱의 user id 를 다시 한번 확인해 주세요.
40004	FailedToSendMessage ByNoFriendship Exception	채널 추가가 되어 있지 않아 친구톡 발송 실패	채널을 추가한 후 다시 시도해 주세요.
40005	InvalidPhone NumberException	전화번호 오류	잘못된 전화번호입니다. 다시 한번 확인해 주세요.
40006	MessageLength OverLimitException	메시지 길이 오류	메시지 길이 제한 확인 후 다시 시도해 주세요.
40007	TemplateNot FoundException	템플릿을 찾을 수 없음	알림톡 템플릿을 찾을 수 없습니다. 중지, 삭제된 경우가 있을 수 있어 Growth Action > Assets > 알림톡 Template 을 확인해 주세요.
40008	NoSendAvailable Exception	메시지를 전송할 수 없음	지원 중단 대상 버전 사용자이거나 해당 시점에 통신사 네트워크 혹은 단말기에 이상이 있는 경우입니다. 다시 한번 시도해 주세요.
40009	NoMatched TemplateException	메시지 내용이 템플릿과 일치하지 않음	템플릿과 메시지 내용을 확인 후 다시 한번 시도해 주세요.
40011	NoSendAvailable TimeException	메시지 발송 가능한 시간이 아님 (친구톡 / 마케팅 메시지는 08시부터 20시 50분까지 발송 가능)	발송 가능한 시간에 시도해 주세요.
50001	UnHandledException	예기치 못한 오류	재시도 시에도 문제가 발생한다면 고객센터를 통해 문의해 주세요.

 

 

SMS 채널 시 에러

[[인용:경고:작게]] SMS 테스트 시 주의사항
SMS는 메시지의 발송 여부만 확인할 수 있습니다. 발송 성공 이후 메시지가 노출되지 않는다면, 아래 오류 상황을 참고하여 테스트를 다시 진행해 보세요.

에러코드	에러 메시지	해결책
40000	BadRequest	고객센터를 통해 문의해 주세요.

 

내부 Validation 에러

에러코드	에러 메시지	설명	해결책
40001	PushToken NotFoundException	푸시 토큰 미수신	푸시 토큰 연동이 잘 되어있는지 확인해주시고, 안된다면 앱을 삭제하고 다시 설치 후 실행하여 시도해 주세요.
40002	InvalidPushToken Exception	잘못된 형식의 푸시 토큰	푸시 토큰 연동이 잘 되어있는지 확인해주시고, 안된다면 앱을 삭제하고 다시 설치 후 실행하여 시도해 주세요.
40003	InvalidWebLinkUrl Exception	잘못된 형식의 웹링크 URL (웹푸시)	웹푸시 세팅에 연동된 웹링크 URL 을 다시 확인해주세요.
40004	DisabledPush NotificationException	푸시 수신동의여부 Off	푸시 수신동의여부 설정이 Off 되어 있습니다. 해당 기기의 수신동의여부 설정을 확인해 주세요.
40005	InvalidOSException	인식할 수 없는 OS (지원 OS: Android, IOS, Web, Etc)	대상 기기의 플랫폼이 Android, IOS, Web 환경인지 확인 후 시도해 주세요.
40006	AvailableChanne lNotFoundException	알림 채널 세팅 이슈	대상 기기의 플랫폼과 관련된 푸시 세팅에 이상이 있습니다. Growth Action > Settings 에 플랫폼별 환경 세팅을 확인해 주세요.
40007	DeviceProfile NotFoundException	광고 추적 제한 혹은 SDK 연동이 되지 않은 경우	1. 광고 추적 제한이 켜져 있는지 확인해 주세요. 2. 디파이너리에 등록되어 있지 않은 기기입니다. SDK 연동을 확인해 주세요.
40008	InvalidDeviceFormat	잘못된 디바이스 형식	디바이스 형식을 다시 한번 확인해 주세요.
40009	NotSupported DevicePlatform	캠페인 대상 플랫폼에 테스트 디바이스의 플랫폼이 없는 경우	캠페인 대상 플랫폼에 포함된 테스트 디바이스를 선택해 주세요.
40010	AbortMessage Exception	개인화 메시지 문법에서 Abort 된 경우	개인화 메시지 문법에 의해 중단되었습니다. 의도된 Abort 인지 개인화문법을 확인해 주세요.
50001	UnHandled Exception	예기치 못한 오류	재시도 시에도 문제가 발생한다면 고객센터를 통해 문의해 주세요.

 

팝업 메시지 테스트 하기 

팝업 메시지는 생성할 때 푸시 메시지와 같이 오디언스 타입을 선택할 수 있으며, 선택 옵션으로는 Device, User, 또는 두 타입을 모두 아우르는 전체 오디언스를 선택할 수 있습니다.

팝업 메시지 테스트

• 오디언스 타입 Device 시 : 테스트 기기만 선택 가능
• 오디언스 타입 User 시 : 테스트 유저만 선택 가능
• 오디언스 타입 전체 시 : 테스트 기기 혹은 테스트 유저 중 하나의 타입 선택 가능

[[인용:경고:보통]] 팝업 메시지는 푸시 메시지와 달리 테스트 가능 여부가 아니라 연결된 모든 기기에서 캠페인이 노출됩니다. 테스트 유저 목록에서 해당 유저와 연결된 기기 정보를 확인할 수 있습니다.

 

팝업 메시지 주의사항

팝업 메시지는 1회성 발송인 푸시 메시지 테스트와 달리, 캠페인을 저장하면 해당 테스트 기기 또는 테스트 유저에 연결된 모든 기기에서 캠페인을 확인할 수 있습니다. 다만, 캠페인이 종료되거나 삭제된 경우 해당 캠페인은 더 이상 노출되지 않으며, 기기 설정 언어에 따라 캠페인이 표시됩니다.
설정한 언어가 없는 경우 기본 언어가 표시됩니다.