@capgo/capacitor 알림

개요

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

Capgo 알림 장치 테이블의 고카디널리티를 피하기 위해 Capgo Postgres를 설계했습니다. Postgres는 앱 설정, 플랫폼 자격 증명 메타데이터, 캠페인草案, 스케줄 및 집계 캠페인 기록과 같은 낮은 카디널리티 제어 평면 데이터만 저장합니다. 활성 기기 상태 및 알림 이벤트는 __CAPGO_KEEP_4__ Analytics Engine 행에만 추가됩니다.

Capgo에서 저장하는 데이터

위치	__CAPGO_KEEP_0__	왜
플랫폼 인증서 메타데이터	Capgo PostgreSQL	__CAPGO_KEEP_0__ 앱 설정 및 권한 관리를 위해 필요합니다.
개인 플랫폼 비밀	워커 환경	개인 인증서를 고객 표면 테이블에 저장하지 않도록 합니다.
캠페인 초안 및 설정	Capgo PostgreSQL	low-cardinality 제어 평면 데이터
활성 장치 등록 상태	Cloudflare 분석 엔진	저렴한 append-only active-device 레지스트리.
通知 이벤트	Cloudflare 분석 엔진	대기 중인, 전송된, 수신된, 열린, 실패한, 및 배경 이벤트에 대한 저렴한 통계.

식별 모델

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

• 백엔드가 실제 고객 사용자 ID를 알고 있습니다.
• 백엔드가 Capgo에게 짧은 수명 identityProof.
• 앱은 externalId 그리고 그 증명이 사용자 인증이 성공한 후에 백엔드가 요청합니다.
• Capgo은 수신자 및 네이티브 설치에 대한 결정론적 내부 키를 도출합니다.
• 같은 대상으로 전송 externalId 사용자의 활성 기기들을 다시 찾습니다.

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

기본 기능

• 인증된 외부 사용자 ID와 기기를 등록합니다.
• 앱 시작 또는 토큰 변경 시 태그, 속성, 동의, 토큰 상태를 갱신합니다.
• JavaScript에서 전면 알림을 받습니다.
• 알림 수신 및 열람 이벤트를 추적합니다.
• 데이터 알림을 처리합니다.
• 앱 배지를 설정, 지우고 증가시킵니다.
• Android 알림 채널을 생성합니다.
• 알림을 보낼 수 있는 오프닝 알림, 캠페인 알림, 배지 업데이트 및 무음 업데이트 확인을 지원합니다.
• Trigger @capgo/capacitor-updater 무음 알림에서

Stats

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

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

통계는 작동 신호이며, 수신자별 영구 기록이 아닙니다. 분석 엔진의 보존 기간은 장치가 등록을 갱신할 필요가 있습니다.

공개 API

설명	Description
configure	Sets the Capgo app ID, API host, and updater integration behavior.
register	현재 설치를 외부 고객 사용자 ID로 등록합니다.
setExternalId	로그인 또는 계정 Switch 후 외부 고객 사용자 ID를 변경합니다.
setTags	대상 타겟팅을 위한 태그를 사용하는 것을 바꿉니다.
setBadge	원시 앱 배지 값을 설정합니다.
clearBadge	원시 앱 배지를 지웁니다.
incrementBadge	원시 앱 배지를 증가시킵니다.
enableUpdaterIntegration	silent update-check 처리를 활성화합니다. @capgo/capacitor-updater.
runUpdateCheck	업데이터 통합을 수동으로 실행합니다.
trackReceived	수신한 이벤트를 수동으로 기록합니다.
trackOpened	열린 이벤트를 수동으로 기록합니다.
addListener('notificationReceived')	JavaScript가 활성화된 상태에서 알림을 받을 때 발생합니다.
addListener('notificationOpened')	사용자가 알림을 열었을 때 발생합니다.
addListener('backgroundNotification')	배경 데이터 알림을 위한 이벤트가 발생하고 노출합니다. finish().
addListener('registrationChanged')	네이티브 푸시 토큰이 변경될 때 발생합니다.

배달 보장

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

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

이미지에서 @capgo/capacitor-notifications로 계속 진행하세요.

이미 사용 중인 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications를 사용하여 푸시 메시징을 계획하고 있습니다. @capgo/capacitor-notifications를 사용하여 푸시 메시징을 계획하고 있습니다. push 메시징을 계획하려면 연결하세요 시작하기 설정에 대해 디버깅 문제 해결에 대해 @capgo/capacitor-업데이터 설정에 대해 Capgo 플러그인 디렉토리 __CAPGO_KEEP_0__ 플러그인 디렉토리