OneSignalとサブスク状態を連携:タグで配信セグメントを作る
サブスクリプションアプリでは、『今トライアル中か』『今週で期限が切れるか』『すでに解約したか』を配信側が知っているかどうかで、プッシュ通知の精度が大きく変わります。このページでは、App Store・Google Play・Stripeから取得した最新のサブスクリプション状態をOneSignalのユーザータグに反映する仕組みと、そのタグを使ってどんな配信セグメントを組めるかを整理します。
この連携でできること
サブスクリプションの状態変化(購入・更新・トライアル開始・解約など)が起きるたびに、OneSignal側のユーザーにタグが追加または更新されます。配信側はユーザーごとの最新状態をタグとして参照できるため、購読者全体への一斉配信ではなく、状態に応じたセグメント配信が可能になります。
代表的な使い方は次の3つです。
- 解約防止:解約のリスクがあるユーザーを特定し、再獲得キャンペーンを開始する。
- エンゲージメント向上:特定の機能を使っていないサブスクライバーにプッシュ通知を送る。
- ウィンバック:最近キャンセルしたユーザーに割引コードを送る。
いずれも『誰に送るか』をタグで絞り込む発想です。配信文面やオファー内容はアプリ側の設計に依存します。
タグ一覧と読み方
自動更新型サブスクリプションのイベントが発生するたびに、以下のタグがOneSignal内のユーザーに追加・更新されます。フィールドごとに『いつ更新されるか』『どんな値が入るか』『何に使えるか』を意識すると、配信セグメントを設計しやすくなります。
- User ID:イベントをトリガーしたサブスクリプション管理ツールのアプリユーザーID。OneSignal側のユーザーと突き合わせる際の基準になります。
- Period Type:購入または更新の最新のピリオドタイプ。
TRIAL(無料トライアル)、INTRO(初回価格)、NORMAL(標準サブスクリプション)のいずれかです。 - Purchased At:最新のサブスクリプション購入または更新のエポック時間(秒単位)。
- Expiration:最新のサブスクリプション有効期限のエポック時間(秒単位)。期限が近いユーザーの抽出に使えます。
- Store:
APP_STORE、PLAY_STORE、STRIPEのいずれか。ストア別に配信を分けたいときに使います。 - Environment:
SANDBOXまたはPRODUCTIONのいずれか。テスト配信と本番配信の切り分けに使えます。 - Last event type:ユーザーからの最新のイベントタイプ。
INITIAL_PURCHASE、TRIAL_STARTED、TRIAL_CONVERTED、TRIAL_CANCELLED、RENEWAL、CANCELLATIONのいずれかです。 - Product ID:ユーザーが購入または更新した最新のサブスクリプション製品識別子。
- Entitlement ID:ユーザーがアンロックしたサブスクリプション管理ツールエンタイトルメント識別子のカンマ区切り文字列。複数エンタイトルメントを持つユーザーはここで区別できます。
- Active Subscription:購入・更新イベントでは
true、期限切れ(EXPIRATION)ではfalseに設定されます。 - Grace Period Expiration:請求問題が発生した場合、猶予期間の有効期限の日付が送信されます。
値の表記(大文字・アンダースコア)はそのまま扱うのが安全です。配信条件を組むときも、表示名ではなくこの表記で指定します。
Active Subscriptionの切り替わりを確認するチェックリスト
Active Subscription は配信条件として使いやすい一方、切り替わりのタイミングを誤解すると『期限切れなのに配信される』『更新済みなのに配信されない』といった事故につながります。次の順序で確認してください。
- 購入または更新のイベントが発生したとき、
Active Subscriptionがtrueになっているか。 - 期限切れ(EXPIRATION)のイベントが発生したとき、
Active Subscriptionがfalseになっているか。 Expirationのエポック秒と、配信したいタイミング(例:期限の数日前)の差分が意図どおりか。- 猶予期間が発生しうる課金状態のとき、
Grace Period Expirationを別条件として扱っているか。 - テスト中は
EnvironmentがSANDBOXのユーザーに本番配信していないか。
特に3と4は、『期限切れ=即座に配信停止』とは限らない点に注意が必要です。猶予期間中は請求問題が起きていてもサブスクリプションが有効な扱いになることがあるため、Active Subscription だけで判断せず、Grace Period Expiration も併用してセグメントを分けると安全です。
シナリオ別:どのタグで絞り込むか
配信したい内容から逆算して、使うタグを決めると設計がぶれません。
- トライアル終了前の後押し:
Period TypeがTRIAL、かつExpirationが近いユーザー。Last event typeがTRIAL_STARTEDのユーザーを起点にすると、トライアル開始直後のフォローにも使えます。 - 解約予備軍への再獲得:
Last event typeがTRIAL_CANCELLEDまたはCANCELLATIONのユーザー。Active Subscriptionがfalseになった直後が狙い目です。 - 機能未利用の購読者への案内:
Active Subscriptionがtrueで、Entitlement IDに特定のエンタイトルメントが含まれるユーザー。 - ストア別の配信分け:
StoreがAPP_STORE/PLAY_STORE/STRIPEのどれかで絞り込み、決済手段ごとに文面を変える。 - 本番とテストの分離:
EnvironmentがPRODUCTIONのユーザーのみを配信対象にする。
たとえば『無料トライアルの期限が近い人にだけ、有料プランの案内を送る』なら、Period Type = TRIAL と Expiration の日付条件、そして Environment = PRODUCTION の3つを組み合わせる、という具合です。
導入前に決めておきたいこと
タグの仕組み自体はシンプルですが、配信設計と運用のルールを先に決めておくと、後戻りが少なくなります。
- ユーザーIDの突き合わせ方法:サブスクリプション管理ツールのアプリユーザーIDとOneSignal側のユーザーをどう紐づけるかを決める。
- 配信トリガーの粒度:イベント発生のたびに即時配信するのか、日次でまとめて配信するのか。
- 除外条件:
EnvironmentがSANDBOXのユーザー、社内テストユーザー、返金済みユーザーなどを除外するルール。 - オプトアウトの扱い:プッシュ通知の配信停止設定を尊重する運用。
- タグの命名・値の変更履歴:
Period TypeやLast event typeの値は配信条件に直結するため、変更時の影響範囲を把握しておく。
これらはアプリの規模や課金モデルによって正解が変わります。自社の運用に合わせて、上記のチェックリストをたたき台にしてください。
関連リソース
連携の設定手順や、実際の活用事例・解説動画は次のリンクから確認できます。
- 設定ドキュメント(OneSignal連携)
- Rapchatの事例紹介(ライフサイクルイベントを活用したパーソナライズ配信)
- OneSignalとサブスクリプション管理ツールの選択に関する解説動画
あわせて、他のインテグレーション一覧も参照できます。
| タグ | 値の内容 | 更新タイミング | 配信での使いどころ |
|---|---|---|---|
| User ID | イベントをトリガーしたサブスクリプション管理ツールのアプリユーザーID | 各イベント発生時 | OneSignalユーザーとの突き合わせ |
| Period Type | TRIAL / INTRO / NORMAL のいずれか | 購入または更新時 | トライアル・初回価格・通常の区別 |
| Purchased At | 最新の購入または更新のエポック時間(秒) | 購入または更新時 | 購入直後のフォロー配信 |
| Expiration | 最新の有効期限のエポック時間(秒) | 購入または更新時 | 期限が近いユーザーの抽出 |
| Store | APP_STORE / PLAY_STORE / STRIPE のいずれか | 各イベント発生時 | ストア別の配信分け |
| Environment | SANDBOX / PRODUCTION のいずれか | 各イベント発生時 | テストと本番の分離 |
| Last event type | INITIAL_PURCHASE / TRIAL_STARTED / TRIAL_CONVERTED / TRIAL_CANCELLED / RENEWAL / CANCELLATION のいずれか | 各イベント発生時 | 直近の状態に応じたセグメント |
| Product ID | 最新のサブスクリプション製品識別子 | 購入または更新時 | 製品別の配信 |
| Entitlement ID | アンロックしたエンタイトルメント識別子のカンマ区切り文字列 | 各イベント発生時 | 特典別の配信 |
| Active Subscription | 購入・更新で true、期限切れで false | 購入・更新・期限切れ時 | 有効/無効の基本条件 |
| Grace Period Expiration | 猶予期間の有効期限の日付 | 請求問題発生時 | 猶予期間中のユーザーの別扱い |
値の表記はソースのまま(大文字・アンダースコア)。仕様は変更される可能性があるため、実装前に最新の公式ドキュメントで確認してください。
Frequently asked questions
OneSignal側でタグはいつ更新されますか?
自動更新型サブスクリプションのイベントが発生するたびに、対応するタグがOneSignal内のユーザーに追加または更新されます。購入・更新・期限切れなど、イベントの種類によって更新されるタグが異なります。
Active Subscriptionがfalseになるのはどんなときですか?
期限切れ(EXPIRATION)のイベントが発生したときにfalseへ設定されます。購入や更新のイベントではtrueになります。
猶予期間中のユーザーにはどう配信すればよいですか?
Grace Period Expirationタグを参照し、通常の期限切れとは別のセグメントとして扱うのが安全です。請求問題が発生しているユーザーに、支払い方法の更新を促す案内を送る、といった使い方が考えられます。
テスト環境のユーザーに本番配信してしまわないか心配です。
EnvironmentタグがSANDBOXかPRODUCTIONかを示すため、配信条件にEnvironment = PRODUCTIONを含めておくと、テストユーザーへの誤配信を避けやすくなります。