Skip to content
Capgo - Capacitor 앱에 대한 실시간 업데이트 Capgo

@capgo/capacitor-notifications

Capgo-관리형 native 알림 서비스: 캠페인, 배지, 사용자 조회, 전달 통계, 무음 실시간 업데이트 확인
시작하기 Debug 설정

개요

Capgo 앱을 Cloudflare의 native 알림 pipe line과 연결합니다. Capgo 앱은 Cloudflare에 signed customer user ID를 등록하고, Cloudflare는 __CAPGO_KEEP_3__가 Analytics Engine에 최신 활성 기기 상태를 저장하고, 알림을 전송하고, 배지를 설정하고, 전달 통계를 확인하고, 무음 실시간 업데이트 확인을 트리거할 수 있습니다.

@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의 저장소란 무엇인가?
데이터어디에 저장되어 있는가왜
플랫폼 인증서 메타데이터Capgo Postgres__CAPGO_KEEP_0__를 사용하여 앱 설정 및 권한 관리를 관리하기 위해 필요하다.
개인 플랫폼 비밀워커 환경고객 접근 가능한 테이블에 개인 인증서를 저장하지 않도록 한다.
캠페인草案 및 설정Capgo PostgresLow-cardinality control plane 데이터.
활성 장치 등록 상태Cloudflare 분석 엔진장치 등록 비용이 저렴한 append-only 활성 장치 레지스트리.
通知 이벤트Cloudflare 분석 엔진대기 중인, 전송된, 수신된, 열린, 실패한, 및 배경 이벤트에 대한 저렴한 통계.

식별 모델

식별 모델

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

  • 백엔드가 실제 고객 사용자 ID를 알고 있습니다.
  • 백엔드가 Capgo 에서 임시로 사용하는 ID를 요청합니다. identityProof.
  • The app registers with externalId 그리고 사용자 인증이 성공하면 그 증명서를 받습니다.
  • Capgo은 수신자와 네이티브 설치에 대한 결정론적 내부 키를 생성합니다.
  • 같은 externalId 사용자의 활성 기기를 다시 찾습니다.

이것은 사용자의 기기를 찾기, 배지 설정, 알림 캠페인 목표 설정을 위해 Capgo Postgres에 저장할 필요가 없는 알림 행을 저장하지 않습니다.

핵심 기능

제목이 '핵심 기능'인 섹션
  • 인증된 외부 사용자 ID와 함께 기기를 등록합니다.
  • 앱 시작 또는 토큰 변경 시 태그, 속성, 동의, 토큰 상태를 갱신합니다.
  • JavaScript에서 전면 알림을 받습니다.
  • 알림 수신 및 열기 이벤트를 추적합니다.
  • 배경 데이터 알림을 처리합니다.
  • 앱 아이콘을 설정, 초기화 및 증가시킵니다.
  • Android 알림 채널을 생성합니다.
  • 일회 알림, 캠페인 알림, 배지 업데이트 및 무음 업데이트 확인을 보냅니다.
  • Trigger @capgo/capacitor-updater __CAPGO_KEEP_0__에서 무음 알림으로부터

Stats

“Stats”라는 제목의 섹션

Capgo의 Cloudflare 분석 엔진으로 알림 이벤트를 기록하므로 대시보드 통계가 저렴합니다:

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

통계는 활성 장치가 등록을 주기적으로 갱신해야 하는 운영 신호이므로 영구적인 수신자별 기록이 아닙니다. 분석 엔진 보존은 장치가 등록을 갱신하지 않으면 통계가 오래된 것으로 표시됩니다.

공개 API

“API”라는 제목의 섹션
메소드설명
configureCapgo 앱 ID, API 호스트, 및 업데이터 통합 동작을 설정합니다.
register현재 설치를 외부 고객 사용자 ID에 등록합니다.
setExternalId로그인 또는 계정 Switch 후 외부 고객 사용자 ID를 변경합니다.
setTags대상 타겟팅을 위한 태그를 교체합니다.
setBadge네이티브 앱 배지 설정합니다.
clearBadge네이티브 앱 배지를 지웁니다.
incrementBadge네이티브 앱 배지를 증가시킵니다.
enableUpdaterIntegration__CAPGO_KEEP_2__를 통해静음 업데이트 체크 처리를 활성화합니다. @capgo/capacitor-updater.
runUpdateCheck업데이터 통합을 수동으로 테스트하기 위해 실행합니다.
trackReceived수동으로 받은 이벤트를 기록합니다.
trackOpened__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-알림을 수신합니다.
addListener('notificationReceived')__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-알림을 받았을 때.
addListener('notificationOpened')__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-알림을 열 때.
addListener('backgroundNotification')배경 데이터 알림을 발생시키고 finish().
addListener('registrationChanged')__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-토큰이 변경될 때.

배달 보장

배달 보장

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-알림은 최소 한 번 이상 전달됩니다. 캠페인은 다시 시도되고, 장치가 중복된 알림을 받을 수 있습니다. 플랫폼이 중복된 메시지를 수락할 경우. 업데이트 확인을 위해 콜라프스 ID를 사용하고, 배경 작업을 무결성 있는 것으로 만들세요.

iOS 배경 알림은 최선을 다합니다. OS는 배터리, 사용자 행동, 강제 종료 상태, 시스템 정책에 따라 배경 실행을 억제하거나 건너뛸 수 있습니다. silent 알림에 의존하지 마세요.硬기한 deadline에 대해.

capgo/capacitor-알림에서 계속 진행하세요.

capgo/capacitor-알림에서 계속 진행하세요.

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-알림을 사용 중입니다. @capgo/capacitor-notifications __CAPGO_KEEP_0__을 위한 푸시 알림 설정 Getting Started 설치를 위해 Debugging 문제 해결을 위해 @capgo/capacitor-updater __CAPGO_KEEP_0__의 무음 업데이트 확인을 위해 Capgo 플러그인 디렉토리 기타 네이티브 플러그인에 대해