OneSignal

OneSignal は、プッシュ通知・メール・SMS・アプリ内メッセージングを提供する主要なカスタマーエンゲージメントプラットフォームです。Adapty と OneSignal を連携することで、すべてのサブスクリプションイベントを一か所で確認でき、それらのイベントをトリガーとした自動コミュニケーションを設定できます。

Adapty を使えば、複数のストアにわたるサブスクリプションイベントを追跡し、ユーザー行動を分析して、よりターゲットを絞ったコミュニケーションに活用できます。この連携により、OneSignal ダッシュボード内でサブスクリプションイベントを監視し、獲得キャンペーンにマッピングすることが可能です。

Adapty はサブスクリプションイベントに基づいて OneSignal のタグを更新するため、最小限の設定でパーソナライズされたプッシュ通知を配信できます。

連携の特性

連携の特性説明
スケジュールリアルタイム更新
データの方向一方向:Adapty から OneSignal サーバーへ
Adapty の連携ポイント
  • モバイルアプリのコード内の OneSignal と Adapty SDK
  • Adapty サーバー

OneSignal 連携の設定

連携を設定するには:

  1. Adapty ダッシュボードの Integrations → OneSignal を開きます。

    onesignal-on.webp
  2. 連携トグルを有効にします。

  3. OneSignal App ID を入力します。

OneSignal との連携を設定するには、Adapty ダッシュボードの Integrations -> OneSignal に移動し、トグルをオンにして連携の認証情報を設定してください。

OneSignal App ID の取得

OneSignal App IDOneSignal ダッシュボードで確認できます:

  1. SettingsKeys & IDs に移動します。

    onesignal-dashboard.webp
  2. OneSignal App ID をコピーして、Adapty ダッシュボードの App ID フィールドに貼り付けます。

    onesignal-id.webp

OneSignal ID の詳細については、こちらのドキュメントをご覧ください。

イベントの設定

Adapty では、3 つのグループのイベントを OneSignal に送信できます。Adapty ダッシュボードで必要なものをトグルでオンにしてください。利用可能なイベントの完全なリストと詳細な説明はこちらで確認できます。

onesignal.webp

Adapty はサーバー間連携を使用してサブスクリプションイベントを OneSignal に送信するため、OneSignal ですべてのサブスクリプション関連のアクティビティを追跡できます。

2023 年 4 月 17 日より、OneSignal の無料プランではこの連携がサポートされなくなりました。GrowthProfessional、およびそれ以上のプランでのみ利用可能です。詳細は OneSignal Pricing をご覧ください。

カスタムタグ

この連携では、Adapty ユーザーのさまざまなプロパティをタグとして更新・付与し、OneSignal に送信します。以下のタグ一覧から、ニーズに合ったものをご確認ください。

OneSignal にはタグの上限があります。これには Adapty が生成するタグと OneSignal に既存するタグの両方が含まれます。上限を超えると、イベント送信時にエラーが発生する可能性があります。

タグ説明
adapty_customer_user_idStringアプリ内でのユーザーの一意の識別子。システム、Adapty、OneSignal 全体で一貫している必要があります。
adapty_profile_idStringAdapty のユーザープロファイル ID。Adapty ダッシュボードで確認できます。
environmentStringユーザーの現在の環境を示す Sandbox または Production
storeStringプロダクトが購入されたストア。選択肢:app_storeplay_storestripe、またはカスタムストアの名前。
vendor_product_idStringアプリストアにおけるプロダクト ID(例:org.locals.12345)。
subscription_expires_atString最新のサブスクリプションの有効期限(YYYY-MM-DDTHH:MM:SS+0000、例:2023-02-10T17:22:03.000000+0000)。
last_event_typeStringAdapty イベントリストにおける最新のイベントタイプ。
注意点:
- Subscription expired イベントの場合、Adapty は last_event_type プロパティを subscription_cancelled として送信します。
- Trial renew canceled の場合は auto_renew_off として送信します。
- Subscription renew canceled の場合は auto_renew_off_subscription として送信します。
purchase_dateString最後のトランザクション日時(YYYY-MM-DDTHH:MM:SS+0000、例:2023-02-10T17:22:03.000000+0000)。
active_subscriptionStringユーザーがアクティブなサブスクリプションを持つ場合は true、サブスクリプションが終了している場合は false
period_typeString購入または更新における最新の期間タイプを示します。使用可能な値:試用期間の場合は trial、それ以外のすべての場合は normal

すべての float 値は整数に丸められます。文字列はそのまま変更されません。

事前定義されたタグに加えて、カスタム属性をタグとして送信することで、含めるデータの柔軟性を高めることができます。これは、プロダクトやサービスに関連する特定の詳細を追跡するのに役立ちます。

カスタムユーザー属性は、連携ページSend user attributes チェックボックスが有効になっている場合、自動的に OneSignal に送信されます。チェックを外した場合、Adapty はちょうど 10 個のタグを送信します。チェックを入れると 10 個を超えるタグを送信でき、より多くのデータをキャプチャできます。

SDK の設定

OneSignal と Adapty を連携する方法は 2 つあります:

  1. レガシー(v5 以前): playerId を使用します(OneSignal SDK v5 では非推奨)。
  2. 現行(v5 以降): subscriptionId を使用します。

Adapty に playerId(OneSignal SDK v5 以前の場合)または subscriptionId(OneSignal SDK v5 以降の場合)を必ず送信してください。これを行わないと、OneSignal のタグが更新されず、連携が正しく機能しません。

OneSignal ドキュメントの詳細はこちらをご覧ください:

複数デバイスへの対応

ユーザーが複数のデバイスを持っている場合、購入イベントやサブスクリプションの追跡が難しくなることがあります。OneSignal では、external user ID を使ってこの問題に対処できます。

デバイス間でユーザーデータを一貫させるには:

  1. サーバーサイドで異なるデバイスを照合し、そのデータを OneSignal に送信します。
  2. Adapty の customer_user_id を OneSignal の externalUserId として使用します。アプリに登録システムがない場合は、ユーザーのデバイス間で一貫性を保つ別の一意の識別子の使用を検討してください。

すべてのデバイスでユーザー識別子の一貫性を維持し、ユーザーの ID が変わるたびに OneSignal を更新することが重要です。これにより、ユーザーのアクティビティとサブスクリプションの追跡が簡素化され、一貫したメッセージングが確保されるとともに、より正確な分析とより良いユーザー体験が実現できます。詳細については、OneSignal の external user ID ドキュメントをご覧ください。