アプリプッシュ
ネイティブ アプリを SocialHub 送信チャネルに変えます。メンバーはアプリ内メンバー センター内からデバイス トークンを登録します。 Push は、フェールオープン チャネル ウォーターフォールと 1 つの共有フリークエンシー キャップを使用して、メールを送信するのとまったく同じ自動化およびキャンペーン エンジンに参加します。
トークンの登録と送信スタックのシームは現在コード内で実行されています。実際のプッシュ配信は、チームごとに制御された有効化フラグの背後で展開されます。FCM/APNs 認証情報が構成されたら、SocialHub チームにスイッチをオンにするよう依頼してください。
仕組み
デバイストークンを登録するライブ
サインインしているメンバーのアプリは、FCM/APNs トークンを POST します。冪等 UPSERT — すべての起動時および OS トークンのローテーション時に安全に呼び出すことができます。
プッシュは送信スタックに参加しますライブ
プッシュは、電子メールと同じ自動化/キャンペーン エンジン内のチャネルであり、別個の API ではありません。メンバーごとに選択される 1 つの旅、チャンネル。
チャンネルの滝 + キャップ 1 つライブ
単一の共有フリークエンシー キャップを備えたフェールオープン ウォーターフォール (プッシュ → メール → …) により、チャネル間でメンバーに二重メッセージが送信されることはありません。
配信の有効化展開中
現在、登録と送信シームはコード内に組み込まれています。実際のプッシュ配信は、チームごとに制御されたフラグの後ろでロールアウトされます。 SocialHub チームに有効にするよう依頼してください。
デバイストークンを登録する ライブ
サインインしているメンバーの WebView 内からこれを呼び出します (コンシューマー セッション Cookie が ID を伝えます)。そのセッションを確立する WebView SSO フローについては、「メンバー ポータルの埋め込み」ガイドを参照してください。
// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json
{
"platform": "ios", // "ios" | "android"
"provider": "fcm", // "fcm" (default) | "apns" — optional
"token": "<device push token>",
"appBundleId": "com.yourbrand.app" // optional
}
// → 200 { "ok": true }
// Idempotent UPSERT keyed on (team, token): re-registering the same device
// simply re-points it at the current member. Call it on every app launch and
// whenever the OS rotates the token.送信中: プッシュはチャネルであり、API 呼び出しではありません
// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
// 1. SocialHub resolves the member's channels in a waterfall (fail-open):
// push (if a token + consent exist) → email → …
// 2. One SHARED frequency cap applies across channels, so a member is never
// double-messaged on push AND email for the same step.
// 3. No token / no consent / push disabled → silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.マーケティング担当者はコードを使用せずにプッシュを作成します。ビジュアル キャンペーン キャンバス (電子メールの横) の プッシュ ステップ では、AI によって生成されたコピー、電子メールと同じ差し込みタグ、および再利用可能な プッシュ テンプレート が使用されます。作成したものはすべてキャンペーンのプッシュ コンテンツとなり、上記の送信パスによって配信されます。アプリはデバイス トークンを登録するだけです。
ライブに行く前に
FCM (Firebase 経由の Android + iOS)
Firebase サービス アカウントの認証情報を SocialHub チームに提供します。送信は、デフォルトのプロバイダーである FCM HTTP v1 (サービス アカウント経由の OAuth) 経由で行われます。
APN (オプション、直接)
APN 経由で iOS に直接送信する場合は、APN 認証キー (.p8)、キー ID、およびチーム ID を指定します。これらのデバイスをプロバイダー「apns」に登録します。
同意
プッシュは、明示的なメンバーの同意とグローバル プライバシー コントロール信号 (フェールクローズ) によってゲートされます。アクティブなプッシュ同意を持たないメンバーはスキップされ、ウォーターフォールは電子メールに戻ります。
受け入れチェックリスト
同じデバイスを 2 回登録しても重複は作成されません。UPSERT はそのデバイスを現在のメンバーに再ポイントします。
有効なトークンを持つオプトインされたメンバーはプッシュを受け取ります。トークンや同意を持たないメンバーは、代わりにメール フォールバックを受信します。何も受信しないことも、両方を受信することもありません。
プッシュ同意 (またはグローバル プライバシー コントロール シグナル) を取り消すと、メンバーは直ちに電子メール チャネルに参加しなくなります。