이 페이지에서 설명하는 기능을 사용하려면 푸시 알림이 포함된 요금제가 필요해요.
앱의 개별 사용자에게 푸시 알림을 보내는 기본적인 방식은 다음과 같아요.
이 가이드에서 '사용자'는 항상 웹사이트에 사용자 계정이 있는 사람을 의미해요.
- 사용자 존이 앱을 열어요.
- 웹사이트가 JavaScript 함수
getNotificationToken을 호출하면 앱 인스턴스의 푸시 알림 토큰이 반환돼요. - 웹사이트가 토큰을 저장해요(예: 사용자 데이터베이스의 존 항목에 저장).
- 존에게 알림을 보내려면 토큰을 사용해 app-control-panel.com API를 호출하세요. 그러면 저희가 알림을 전달해 드려요.
JavaScript 함수 사용하기
다음의
executeWhenAppReady() 함수를 확인해 보세요. 앱 도우미 스크립트예요.. 이 함수는 앱이 준비되기 전이나 웹사이트가 일반 브라우저에서 로드되었을 때 웹사이트에서 앱과 상호작용을 시도하지 않도록 해줘요(ReferenceError, 함수가 정의되지 않음). 이는 2021년 8월 이전에 생성되거나 업데이트된 앱에서 사용된 이전 구현 방식이에요.
앱에서 호출할 수 있도록 웹사이트에 receivePushNotificationToken 함수를 정의해야 해요. 다음과 같이 정의할 수 있어요.
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
유의할 사항:
- 앱은 페이지를 불러올 때마다 JavaScript 함수를 호출해요. 사용자가 로그인하지 않아 사용자 데이터베이스에 토큰을 저장할 수 없는 경우처럼, 토큰으로 아무 작업도 하지 않는 경우가 있는 것은 정상이에요.
- 어떤 이유로 앱이 푸시 알림 토큰을 확인하지 못하면 JavaScript 함수를 호출하지 않아요(가능성은 매우 낮지만 이론적으로는 발생할 수 있어요).
- 물론 웹사이트의 모든 방문자가 앱을 사용하는 것은 아니므로 페이지를 불러올 때마다 함수가 호출되지는 않아요.
앱 인스턴스의 푸시 알림 토큰을 가져오려면 getNotificationToken 함수를 호출하기만 하면 돼요.
<script>
try {
var token = (await getNotificationToken())["token"];
}
catch (e) {
// Can occur if:
// - the app couldn't connect to the native code. Should be very unlikely.
// - the app couldn't get the push notification token, maybe because of connection issues. Should be very unlikely.
// - push notifications are not included in your current plan
console.log(e);
}
</script>
유의할 사항:
- 토큰은 다음과 같은 긴 문자열이에요.
- 사용자의 토큰은 다음과 같은 경우 변경될 수 있어요.
- 동일한 사용자가 다른 기기에서 앱을 사용하는 경우
- 앱을 제거한 후 다시 설치한 경우
- 앱 데이터가 삭제된 경우
- 푸시 알림 토큰은 비밀로 유지하세요.
API 엔드포인트 참고 자료
다음에서 앱 전용 API 키를 받으세요. 앱 대시보드예요.
API 키를 URL의 쿼리와 JSON 형식의 요청 본문으로 전송하세요.