開発者ドキュメント

PUSH API · v1a

基本概念

同じアプリでも、環境が違えばキー・端末・プッシュサービス接続・送信対象は別になります。操作の前に、選択中の範囲を確認しましょう。

概念意味
組織一緒に運営するアカウントとプロジェクトをまとめる単位です。
プロジェクト関連するアプリをまとめる単位です。プロジェクト環境ごとに、共有するユーザーデータや定義の範囲を分けます。
アプリAndroidやiOSなどのクライアントアプリです。
アプリ環境キー・プッシュサービス接続・インストール・メッセージを分ける範囲です。1つのキーは1つのアプリ環境に属します。
アプリユーザーサービス上のユーザー識別情報です。登録時に匿名ユーザーが作られます。管理型ログインは端末認証に加え、BASICではexternal ID、VERIFIEDでは信頼できる顧客バックエンドのJWTを使用します。BASICはIDの所有権を検証しません。
アプリのインストール端末にインストールされたアプリ1つを指します。1人のユーザーに複数のインストールが紐付くことがあります。
プッシュ通知の購読とアドレスインストール先に通知を届ける経路です。FCM/APNsのアドレスが変わったら、新しい値をSDKに伝えてください。
メッセージと配信メッセージは送信リクエスト、配信は各購読先に対する処理結果です。

区別して扱う3つの設定

  • OSの通知権限：OSがアプリの通知表示を許可しているかどうかです。
  • アプリ内の受信設定：ユーザーがアプリ内でプッシュ通知を受け取ると選択しているかどうかです。
  • マーケティング同意：マーケティング通知のための別の同意記録です。OSの権限やアプリ内の受信設定で代用することはできません。