@capgo/capacitor-알림

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

개요

@capgo/capacitor-notifications Capacitor 앱을 Capgo의 네이티브 알림 PIPELINE과 연결합니다. 앱은 Capgo에 서명된 고객 사용자 ID를 등록하고, Capgo은 Cloudflare Analytics Engine에 최신 활성 기기 상태를 유지하고, 알림을 전송하고, 배지 설정, 전달 통계 검사 및 Capgo silent live-update 체크를 트리거할 수 있습니다. Capgo 대시보드 또는 API에서.

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

Capgo은 무엇을 저장합니까?

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

식별 모델

Capgo은 사용자 목록을 업로드하거나 장치 테이블을 유지할 필요가 없습니다.

백엔드에서는 실제 고객 사용자 ID를 알고 있습니다.
Capgo에 대해 백엔드가 짧은 시간 동안 유효한 identityProof.
앱은 인증된 외부 사용자 ID와 함께 장치에 등록합니다. externalId 인증이 성공하면 __CAPGO_KEEP_0__은 수신자와 네이티브 설치에 대한 결정론적 내부 키를 계산합니다.
Capgo derives deterministic internal keys for the recipient and the native install.
이것은 __CAPGO_KEEP_0__ Postgres에 저장할 필요가 없는 사용자 장치의 활성 장치를 다시 찾을 수 있도록 해줍니다. externalId __CAPGO_KEEP_0__의 Core 기능

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

인증된 외부 사용자 ID와 함께 장치에 등록합니다.

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

Statistics

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 update-check 처리를 위해 무음으로 업데이트 확인을 처리합니다. `@capgo/capacitor-updater`.
`runUpdateCheck`	테스트를 위해 업데이터 통합을 수동으로 실행합니다.
`trackReceived`	수신한 이벤트를 수동으로 기록합니다.
`trackOpened`	열린 이벤트를 수동으로 기록합니다.
`addListener('notificationReceived')`	자바스크립트가 활성화된 상태에서 알림이 수신될 때 발생합니다.
`addListener('notificationOpened')`	사용자가 알림을 열었을 때 발생합니다.
`addListener('backgroundNotification')`	배경 데이터 알림이 발생하고 배경 데이터 알림을 노출합니다. `finish()`.
`addListener('registrationChanged')`	배경 데이터 알림이 발생했을 때 발생합니다.

배달 보장

자연스럽게 알림을 받습니다. 캠페인은 다시 시도할 수 있고, 플랫폼이 반복된 메시지를 수락할 경우 장치가 중복된 알림을 받을 수 있습니다. 업데이트 확인을 위해 콜라프스 ID를 사용하고 배경 작업을 무한히 반복하도록 하세요.

iOS 배경 알림은 최선을 다합니다. OS는 배터리, 사용자 행동, 강제 종료 상태, 시스템 정책에 따라 배경 실행을 억제하거나 생략할 수 있습니다. 무음 알림에 의존하여 중요한 일정에 대한 의존성을 피하세요.

capgo/capacitor 알림

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ 알림을 사용하고 있다면 capgo/capacitor 알림 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__ 알림을 사용하여 푸시 메시징을 계획하고 설치 시작 디버깅 문제 해결 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__ 업데이터 capgo/capacitor 업데이터를 사용하여 무음 업데이트를 확인하고 __CAPGO_KEEP_0__ 플러그인 디렉토리 Capgo/__CAPGO_KEEP_1__ 알림 {"targetLanguage":"Korean","pagePath":"/ko/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"다른 원생 플러그인에 대해."},{"text":"페이지 편집"}]}