Skip to content
AppDues
Log in
Contact salesSign up

OneSignalとサブスク状態を連携:タグで配信セグメントを作る

サブスクリプションアプリでは、『今トライアル中か』『今週で期限が切れるか』『すでに解約したか』を配信側が知っているかどうかで、プッシュ通知の精度が大きく変わります。このページでは、App Store・Google Play・Stripeから取得した最新のサブスクリプション状態をOneSignalのユーザータグに反映する仕組みと、そのタグを使ってどんな配信セグメントを組めるかを整理します。

タグ一覧と読み方

自動更新型サブスクリプションのイベントが発生するたびに、以下のタグが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 は配信条件として使いやすい一方、切り替わりのタイミングを誤解すると『期限切れなのに配信される』『更新済みなのに配信されない』といった事故につながります。次の順序で確認してください。

  1. 購入または更新のイベントが発生したとき、Active Subscription が true になっているか。
  2. 期限切れ(EXPIRATION)のイベントが発生したとき、Active Subscription が false になっているか。
  3. Expiration のエポック秒と、配信したいタイミング(例:期限の数日前)の差分が意図どおりか。
  4. 猶予期間が発生しうる課金状態のとき、Grace Period Expiration を別条件として扱っているか。
  5. テスト中は 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 の値は配信条件に直結するため、変更時の影響範囲を把握しておく。

これらはアプリの規模や課金モデルによって正解が変わります。自社の運用に合わせて、上記のチェックリストをたたき台にしてください。

ConfigureTargetTest
OneSignalに追加・更新されるタグ一覧
タグ値の内容更新タイミング配信での使いどころ
User IDイベントをトリガーしたサブスクリプション管理ツールのアプリユーザーID各イベント発生時OneSignalユーザーとの突き合わせ
Period TypeTRIAL / INTRO / NORMAL のいずれか購入または更新時トライアル・初回価格・通常の区別
Purchased At最新の購入または更新のエポック時間(秒)購入または更新時購入直後のフォロー配信
Expiration最新の有効期限のエポック時間(秒)購入または更新時期限が近いユーザーの抽出
StoreAPP_STORE / PLAY_STORE / STRIPE のいずれか各イベント発生時ストア別の配信分け
EnvironmentSANDBOX / PRODUCTION のいずれか各イベント発生時テストと本番の分離
Last event typeINITIAL_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を含めておくと、テストユーザーへの誤配信を避けやすくなります。