要件
- OneSignal SDK v5 以降
セットアップ
シナリオ例:アプリの最新バージョンは1.0.1 です。バージョン 1.0.0 以前のユーザーをターゲットにして、更新を促すアプリ内メッセージを表示したいと考えています。
1. 最新のアプリバージョンを取得する
OneSignal は以下に基づいてApp Version を検出します:
iOS:Xcode のメインアプリ Target > General > Identity にある Version

build.gradle ファイルにある versionCode

Xcode や Android Studio にアクセスできない場合は、開発者にこれらの値を尋ねてください。
2. セグメントをセットアップする
iOS と Android 用に 2 つのセグメントを作成する必要があります。 iOS:- セグメント名:
iOS App version less than 1.0.1 - フィルター:
App Versionがless than(未満)1.0.1ANDDevice TypeがiOS。

- セグメント名:
Android App version less than 10001 - フィルター:
App Versionがless than(未満)10001ANDDevice TypeがAndroid。

3. アプリ内メッセージをセットアップする
Messages > In-App > New Message > New In-App に移動します。 事前構築されたデザイン New Feature Announcement から開始するか、ゼロから独自に作成します。
オーディエンスを追加する
特定のセグメント iOS App version less than 1.0.1 を選択します。メッセージを更新する
メッセージの内容を必要に応じて更新します。ユーザーをアプリストアのリストに誘導するには、ボタンまたは他の要素に URL クリックアクション を追加します。
- iOS:
https://apps.apple.com/app/idYOUR_APP_STORE_ID— Requesting App Store Reviews を参照 - Android:
https://play.google.com/store/apps/details?id=YOUR_PACKAGE_NAME— Linking to Google Play を参照
4. トリガー
ユーザーがアプリを開いたときにメッセージが表示されるようにするため、On app open トリガーの使用をお勧めします。5. スケジュールと頻度
アプリの更新を将来の日時にスケジュールしている場合は、その時点でメッセージが表示され始めるようにスケジュールできます。 更新プロンプトをどの程度積極的に表示したいかに応じて、「このメッセージをどのくらいの頻度で表示しますか?」の頻度を設定できます:- Every time trigger conditions are satisfied — この例ではアプリを開くたびに表示されることを意味します。
- Multiple times — メッセージを表示する合計回数と間隔を設定します。例えば、3 日間隔で 100 回。メッセージは最大 100 回、3 日ごとに表示されます。
6. 下書きとして保存し、Android 用に複製する
Save as Draft ボタンをクリックしてメッセージを保存します。 In-App Messages ページで、保存したメッセージの横にある Options > Duplicate をクリックします。 Android ユーザー向けに以下を更新します:- IAM 名を Android ユーザー向けであることを反映するように変更
- セグメントを Android App version less than 10001 に設定
- URL を Android ストアリンクに更新
- Android ユーザー向けにメッセージを独自にするための追加の変更を加える
テスト
メッセージを公開する前に、以下の手順でテストすることをお勧めします:テストデバイスを見つけてTest Subscriptionに設定する
- テストデバイスを見つけて、Test Subscription として設定します。
- テストデバイスがアプリの古いバージョンになっていることを確認します。
Test Usersを含めるようにセグメントを更新する
- テストしたいアプリ内メッセージを開きます。
- セグメントをクリックし、Test Users の And フィルターを追加します。
- これにより、メッセージがテストデバイスにのみ表示されるようになります
- 例えば、テストデバイスが iOS の場合、セグメントは次のようになります:

- Update Segment をクリックして変更を保存します。
公開チェックリスト
公開する準備ができたら:- セグメントを更新して
Test Usersフィルターを削除します。 - スケジュールを確認して、正しい日時に設定されていることを確認します。
- Update Message をクリックしてアプリ内メッセージを更新します。
完了です!古いバージョンでアプリを開いたユーザーは、アプリの更新について通知を受け取ります。しばらくしてからアプリ内メッセージに戻って進捗を確認してください。Event Streams またはサードパーティの Integrations でアプリ内メッセージの分析を取得することもできます。
よくある質問
OneSignal はアプリバージョンを自動的に検出しますか?
はい。OneSignal SDK はアプリバージョンを自動的に OneSignal に報告します。iOS では Xcode のVersion フィールド、Android では build.gradle ファイルの versionCode が使用されます。
iOS と Android で別々のメッセージが必要な理由は何ですか?
iOS と Android はバージョン形式が異なり(例:1.0.1 と 10001)、各プラットフォームのストアリンクも異なります。別々のセグメントとメッセージを使用することで、各プラットフォームに適切なバージョンフィルターとストアリンクが使用されます。
アプリ内トリガーの代わりに Journeys を使用できますか?
はい。同じバージョンベースのセグメントをターゲットにし、ステップとしてアプリ内メッセージを送信する Journey を作成できます。これにより、タイミングとフォローアップアクションをより細かく制御できます。サポートが必要ですか?サポートチームとチャットするか、
support@onesignal.comにメールしてください以下を含めてください:- 発生している問題の詳細と再現手順(利用可能な場合)
- OneSignal App ID
- 該当する場合は、External IDまたはSubscription ID
- 該当する場合は、OneSignalダッシュボードでテストしたメッセージのURL
- 関連するログまたはエラーメッセージ