@capgo/capacitor-알림

Capgo-캠페인, 배지, 사용자 조회, 전달 통계 및 침묵 라이브 업데이트 확인을 위한 네이티브 알림 관리

개요

@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.

The feature is designed to avoid a high-cardinality notification device table in Capgo Postgres. Postgres stores only low-cardinality control plane data such as app settings, platform credential metadata, campaign drafts, schedules, and aggregate campaign records. Active device state and notification events are append-only Analytics Engine rows.

What Capgo Stores

데이터	위치	이유
플랫폼 인증서 메타데이터	Capgo Postgres	앱 설정과 권한 관리를 위해 필요합니다.
개인 플랫폼 비밀	워커 환경	고객 접면 표에 개인 인증 정보를 저장하지 않도록 합니다.
캠페인草案 및 설정	Capgo Postgres	저 카디널리티 제어 평면 데이터.
활성 장치 등록 상태	Cloudflare Analytics Engine	활성 장치 레지스트리에 cheap append-only.
通知 이벤트	Cloudflare Analytics Engine	대기 중인, 전송된, 수신된, 열린, 실패한 및 배경 이벤트에 대한 cheap stats.

식별 모델

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.

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

장치 등록
앱 시작 또는 토큰 변경 시 태그, 속성, 동의, 토큰 상태를 갱신합니다.
JavaScript에서 전면 알림을 받습니다.
알림 수신 및 열람 이벤트를 추적합니다.
데이터 알림을 백그라운드에서 처리합니다.
앱 아이콘을 설정, 초기화, 또는 증가시킵니다.
Android 알림 채널을 생성합니다.
일회 알림, 캠페인 알림, 아이콘 업데이트, 무음 업데이트 확인을 보냅니다.
silent notification에서 트리거합니다. @capgo/capacitor-updater stat

__CAPGO_KEEP_0는 CAPGO_KEEP_1__ Analytics Engine으로 알림 이벤트를 기록하여 대시보드 stat이 저렴합니다.

Capgo writes notification events to Cloudflare Analytics Engine so dashboard stats stay cheap:

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')`	자바스크립트가 활성화된 상태에서 알림이 수신될 때 발생합니다.
`addListener('notificationOpened')`	사용자가 알림을 열었을 때 발생합니다.
`addListener('backgroundNotification')`	배경 데이터 알림에 대해 발생하며 배경 작업을 노출합니다. `finish()`.
`addListener('registrationChanged')`	자연스러운 푸시 토큰 변경 시 발생합니다.

배달 보장

자연스러운 푸시는 최소 한 번 이상입니다. 캠페인은 다시 시도할 수 있으며 플랫폼이 반복된 메시지를 수락할 경우 장치가 중복을 받을 수 있습니다. 업데이트 확인을 위해 콜라프스 ID를 사용하고 배경 작업을 무시도 가능하도록 하세요.

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