@capgo/capacitor-알림

개요

@capgo/capacitor-notifications connects a Capacitor app to Capgo’s native notification pipeline. Your app registers a signed customer user ID with Capgo, Capgo keeps the latest active device state in Cloudflare Analytics Engine, and you can send notifications, set badges, inspect delivery stats, and trigger silent Capgo live-update checks from the Capgo dashboard or API.

이 기능은 Capgo Postgres의 고카디널리티 알림 기기 테이블을 피하기 위해 설계되었습니다. Postgres는 앱 설정, 플랫폼 인증서 메타데이터, 캠페인草案, 스케줄, 집계 캠페인 기록과 같은 낮은 카디널리티 제어 평면 데이터만 저장합니다. 활성 기기 상태와 알림 이벤트는 Analytics Engine의 append-only 행입니다.

Capgo가 저장하는 데이터는 무엇입니까?

데이터	위치	이유
플랫폼 인증서 메타데이터	Capgo Postgres	앱 설정과 권한 관리를 위해 필요합니다.
개인 플랫폼 비밀	워커 환경	고객 대면 테이블에 개인 정보 인증서를 저장하지 않도록 합니다.
캠페인 초안 및 설정	Capgo Postgres	저 카디널리티 제어 평면 데이터.
활성 장치 등록 상태	Cloudflare 분석 엔진	활성 장치 레지스트리에 대한 저렴한 추가 전용 레지스트리.
通知 이벤트	Cloudflare 분석 엔진	활성 장치 레지스트리에 대한 저렴한 통계. 큐드, 전송, 수신, 열기, 실패, 배경 이벤트에 대한 통계.

식별 모델

Capgo은 사용자 목록을 업로드하거나 장치 테이블을 유지하도록 요구하지 않습니다.

• 백엔드에서는 실제 고객 사용자 ID를 알고 있습니다.
• Capgo에 대해 백엔드가 짧은 시간 동안 사용자 ID를 요청합니다. identityProof.
• 앱은 사용자 인증이 성공한 후에 externalId __CAPGO_KEEP_0__은 수신자와 네이티브 설치에 대한 결정론적 내부 키를 생성합니다.
• Capgo derives deterministic internal keys for the recipient and the native install.
• 이것은 사용자의 활성 장치를 다시 찾을 수 있도록 해줍니다. externalId 이것은 __CAPGO_KEEP_0__ Postgres에 저장할 필요가 없는 사용자 장치의 알림 행을 저장하지 않고도 사용자 장치의 알림을 설정하고 알림 캠페인을 목표로 하는 것을 찾을 수 있도록 해줍니다.

This lets you look up a user’s devices, set badges, and target notification campaigns without storing per-device notification rows in Capgo Postgres.

제목이 "핵심 기능"인 섹션

• __CAPGO_KEEP_0__
• 앱 시작 또는 토큰 변경 시 태그, 속성, 동의, 토큰 상태를 갱신합니다.
• JavaScript에서 전면 알림을 받을 수 있습니다.
• 알림 수신 및 열람 이벤트를 추적합니다.
• 데이터 알림을 처리합니다.
• 앱 아이콘을 설정, 지우거나 증가시킵니다.
• Android 알림 채널을 생성합니다.
• 일회 알림, 캠페인 알림, 아이콘 업데이트, 무음 업데이트 확인을 보냅니다.
• 무음 알림에서 트리거합니다. @capgo/capacitor-updater __CAPGO_KEEP_0__은 __CAPGO_KEEP_1__ Analytics Engine으로 알림 이벤트를 기록하여 대시보드 통계가 저렴합니다.

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__

Capgo Cloudflare

• queued
• sent
• provider_accepted
• received
• opened
• failed
• permission_changed
• background_started
• background_finished

통계는 영구적인 수신자 기록이 아닌 작동 신호입니다. 분석 엔진 보존 기간은 활성 장치가 등록을 주기적으로 갱신해야 함을 의미합니다.

공개 API

메서드	설명
configure	Capgo 앱 ID, API 호스트 및 업데이터 통합 동작을 설정합니다.
register	현재 설치를 외부 고객 사용자 ID에 등록합니다.
setExternalId	로그인 또는 계정switch 후 외부 고객 사용자 ID를 변경합니다.
setTags	대상 타겟팅을 위한 태그를 교체합니다.
setBadge	네이티브 앱 배지 설정합니다.
clearBadge	네이티브 앱 배지를 초기화합니다.
incrementBadge	네이티브 앱 배지를 증가시킵니다.
enableUpdaterIntegration	silent 업데이트 확인을 처리하기 위해 사용합니다. @capgo/capacitor-updater.
runUpdateCheck	업데이트 통합을 수동으로 테스트하기 위해 실행합니다.
trackReceived	수신한 이벤트를 수동으로 기록합니다.
trackOpened	수신한 이벤트를 수동으로 기록합니다.
addListener('notificationReceived')	JavaScript가 활성화된 상태에서 알림이 수신될 때 발생합니다.
addListener('notificationOpened')	사용자가 알림을 열 때 발생합니다.
addListener('backgroundNotification')	배경 데이터 알림에 대해 발생하며, 배경 데이터 알림을 노출합니다. finish().
addListener('registrationChanged')	네이티브 푸시 토큰이 변경될 때 발생합니다.

배달 보장

네이티브 푸시는 최소한 한번 이상 발생합니다. 캠페인은 다시 시도되고, 플랫폼이 반복된 메시지를 수락할 경우 기기에서 중복 알림을 받을 수 있습니다. 업데이트 확인을 위해 콜라프스 ID를 사용하고 배경 작업을 무시할 수 있도록 하세요.

iOS 배경 알림은 최선의 시도입니다. OS는 배터리, 사용자 행동, 강제 종료 상태 및 시스템 정책에 따라 배경 실행을 억제하거나 생략할 수 있습니다. silent 알림에 의존하여 중요한 마감일을 지키지 마세요.

Capgo에서 계속하기 @capgo/capacitor-notifications

Capgo를 사용 중이라면 Capgo @capgo/capacitor-notifications 푸시 메시징을 계획하기 위해 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications을 사용 중이라면 Capgo 시작하기 설정을 위해 디버깅 문제 해결을 위해 Capgo @capgo/capacitor-updater 무음 업데이트 확인을 위해, Capgo Plugin Directory {"targetLanguage":"Korean","pagePath":"/ko/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"다른 원생 플러그인에 대해."},{"text":"페이지 편집"}]}