要件
- 管理されたExpoアプリ。ベアReact Nativeアプリについては、React Native SDKセットアップを参照してください。
- Expo 開発ビルド
- Expo SDK 53+(React Native 0.79+)、新アーキテクチャを有効にする必要があります
- EAS CLI(EAS Buildドキュメント)
- 構成されたOneSignalアプリとプラットフォーム
- Xcode 14+を搭載したmacOS(セットアップ手順ではXcode 16.2を使用)
- iOS 12+、iPadOS 12+を搭載したデバイス、またはiOS 16.2+を実行しているXcodeシミュレーター
- CocoaPods 1.16.2+
- Android 7.0+デバイスまたはGoogle Play Store(Services)がインストールされたエミュレーター
OneSignalアプリとプラットフォームを設定
サポートするプラットフォーム(Apple(APNs)、Google(FCM)、Huawei(HMS)、Amazon(ADM))でOneSignalアプリを設定します。セットアップのステップバイステップ手順
セットアップのステップバイステップ手順
アプリを作成または選択

最初のOneSignalアプリ、組織、チャネルのセットアップ。
プラットフォーム認証情報を設定
- Android:Firebase認証情報をセットアップ
- iOS:p8トークン(推奨)またはp12証明書
- Amazon:APIキーを生成
- Huawei:OneSignalを承認
App IDを保存してSDKをインストール

App IDを保存して追加のチームメンバーを招待します。
SDKセットアップ
1. SDKを追加する
Expo CLIを使用してOneSignal Expoプラグインをインストールします。react-native-onesignalパッケージを追加します。
2. プラグインを構成する
app.json(またはapp.config.js / app.config.ts)を開きます。次の設定を含める必要があります。
必須設定
UIBackgroundModesキーを["remote-notification"]に設定して含める必要があります。aps-environmentをテスト用に"development"に、TestFlightおよびApp Storeビルド用に"production"に設定します。
追加のプラグインプロパティ。
追加のプラグインプロパティ。
オプション: 位置情報モジュールを無効にする
アプリがOneSignal.Location を使用しない場合は、OneSignal Expo プラグイン props で disableLocation を true に設定します。このオプションには react-native-onesignal 5.5.1 以降が必要です。プラグインはネイティブ依存関係の解決を構成し、react-native-onesignal が位置情報モジュールを除外するようにします。iOS では、プラグインが CocoaPods 解決時に使用される Podfile の環境設定を書き込みます。Android では、プラグインが生成された Gradle properties に onesignal.disableLocation=true を書き込みます。
Podfile で Notification Service Extension または Live Activity widget ターゲットに明示的に OneSignalXCFramework が宣言されている場合は、OneSignalXCFramework/OneSignal や OneSignalXCFramework/OneSignalLiveActivities などのモジュラーサブスペックを使用してください。集約 pod 'OneSignalXCFramework' は OneSignalComplete に解決され、位置情報が含まれます。クリーンな prebuild の後、ios/Podfile.lock に OneSignalComplete も OneSignalLocation も表示されないことを確認してください。
- app.config.ts
- app.json
onesignal-expo-plugin 2.6.0 以降では、プラグインの props に対する完全な TypeScript サポートと自動補完のために withOneSignal をインポートできます。3. SDKを初期化する
Expo構造(従来のアプリエントリまたはExpo Router)に応じて、これらのオプションに従ってOneSignalを初期化します。- 従来のアプリエントリ
- Expo Router
useCallback で再利用可能なリスナー
リスナーが props や state にアクセスする必要がある場合は、useEffect の外で useCallback を使って定義し、追加と削除に同じ参照を使えるようにします。addEventListener と removeEventListener に異なる関数参照を渡しても何も起こりません。リスナーは削除されず、コンポーネントがアンマウントされた後も発火する可能性があります。
Androidセットアップ
Firebase認証情報を使用して、OneSignalアプリがAndroidプラットフォーム用に設定されていることを確認してください。 アプリのブランディングに合わせて通知アイコンをセットアップします。小さいアイコンは必須です。スキップすると、通知にはデフォルトのベルアイコンが表示されます。 Androidでビルド この時点で、物理Androidデバイスまたはエミュレーターでアプリをビルドして実行できるはずです。- 該当する場合は、iOSセットアップに進みます。
- または、OneSignal SDK統合のテストに進みます。
iOSセットアップ
p8トークン(推奨)またはp12証明書のいずれかを使用して、OneSignalアプリがiOSプラットフォーム用に構成されていることを確認してください。iOSでビルドする
これで、実際のiOSデバイスまたはiOSシミュレーター(16.2+)でアプリをビルドして実行できるはずです。iOSビルドの一般的なエラー
Cycle Inside... building could produce unreliable results.
Cycle Inside... building could produce unreliable results.
- Xcodeで
.xcworkspaceフォルダーを開き、アプリターゲット > Build Phasesに移動します。 - **「Embed Foundation Extensions」または「Embed App Extensions」**というフェーズが必要です。
- このビルドフェーズを**「Run Script」**の_上_にドラッグして移動します。
- アプリをビルドして実行します。エラーが解決されるはずです。

Xcodeのビルドフェーズの正しい順序。

「Copy only when installing」のチェックを外します。
PBXGroupエラー
PBXGroupエラー
PBXGroupが不明なISA PBXFileSystemSynchronizedRootGroupの属性からオブジェクトを初期化しようとしました:{"isa"=>"...", "exceptions"=>["//", "..."], "explicitFileTypes"=>{}, "explicitFolders"=>[], "path"=>"OneSignalNotificationServiceExtension", "sourceTree"=>"<group>"}- エラーの「path」の下にリストされているフォルダーを見つけます
- Xcodeプロジェクトサイドバーで、フォルダーを右クリックします
- **「Convert to Group」**を選択します

PBXGroupのパスエラー。

フォルダーをグループに変換します。
OneSignal SDK統合のテスト
このガイドでは、プッシュ通知、サブスクリプション登録、アプリ内メッセージをテストして、OneSignal SDK統合が正しく機能していることを確認する方法を説明します。モバイルサブスクリプションを確認
テストデバイスでアプリを起動します。
requestPermissionメソッドを追加した場合、ネイティブのプッシュ許可プロンプトが自動的に表示されます。
iOSとAndroidのプッシュ許可プロンプト
OneSignalダッシュボードを確認
- Audience > Subscriptionsに移動します。
- ステータスが「Never Subscribed」の新しいエントリが表示されるはずです。

「Never Subscribed」ステータスのサブスクリプションを表示するダッシュボード
アプリに戻り、プロンプトで「許可」をタップします。
OneSignalダッシュボードのSubscriptionsページを更新します。

「Subscribed」ステータスのサブスクリプションを表示するダッシュボード
テストサブスクリプションをセットアップ
テストサブスクリプションは、メッセージを送信する前にプッシュ通知をテストするのに役立ちます。Test Usersに追加します。

デバイスをtest usersに追加
サブスクリプションに名前を付けます。
テストユーザーセグメントを作成します。
セグメントに名前を付けます。
Test Usersという名前を付けます(この名前は後で使用されるため重要です)。Test Usersフィルターを追加し、Create Segmentをクリックします。

Test Usersフィルターを使用して「Test Users」セグメントを作成
API経由でテストプッシュを送信
App API KeyとApp IDを取得します。
提供されたコードを更新します。
YOUR_APP_API_KEYとYOUR_APP_IDを実際のキーに置き換えます。このコードは、先ほど作成したTest Usersセグメントを使用します。コードを実行します。
画像とconfirmed receiptを確認します。

iOSとAndroidで画像付きプッシュ通知
confirmed receiptを確認します。
アプリ内メッセージを送信
アプリ内メッセージを使用すると、ユーザーがアプリを使用している間にユーザーとコミュニケーションできます。デバイスでアプリを閉じるか、バックグラウンドにします。
アプリ内メッセージを作成します。
- OneSignalダッシュボードで、Messages > In-App > New In-Appに移動します。
- Welcomeメッセージを見つけて選択します。
- Audienceを、以前使用したTest Usersセグメントに設定します。

「Test Users」セグメントをアプリ内メッセージでターゲティング
必要に応じてメッセージコンテンツをカスタマイズします。

アプリ内Welcomeメッセージのカスタマイズ例
トリガーを「On app open」に設定します。
頻度をスケジュールします。

アプリ内メッセージのスケジュールオプション
メッセージをライブにします。
アプリを開いてメッセージを確認します。

デバイスに表示されたWelcomeアプリ内メッセージ
- サブスクリプションの収集、テストサブスクリプションの設定、セグメントの作成。
- セグメントとCreate message APIを使用した画像付きプッシュとConfirmed receiptの送信。
- アプリ内メッセージの送信。
ユーザー識別
以前、モバイルサブスクリプションの作成方法を説明しました。次に、OneSignal SDKを使用して、すべてのサブスクリプション(プッシュ、メール、SMSを含む)にわたるユーザーの識別に拡張します。プラットフォーム間でユーザーを統合し、エンゲージメントするために、External ID、タグ、マルチチャネルサブスクリプション、プライバシー、イベントトラッキングについて説明します。External IDを割り当て
External IDを使用して、バックエンドのユーザー識別子を使用して、デバイス、メールアドレス、電話番号間でユーザーを一貫して識別します。これにより、チャネルとサードパーティシステム間でメッセージングが統一されたままになります(特に統合に重要)。 アプリによって識別されるたびに、SDKのloginメソッドを使用してExternal IDを設定します。
データタグを追加
タグは、ユーザープロパティ(username、role、設定など)とイベント(purchase_date、game_level、ユーザーインタラクションなど)を保存するために使用できる文字列データのキーと値のペアです。タグは、高度なメッセージパーソナライゼーションとセグメンテーションを強化し、より高度なユースケースを可能にします。
アプリでイベントが発生したときに、SDKのaddTagおよびaddTagsメソッドを使用してタグを設定します。
この例では、ユーザーはレベル6に到達し、current_levelというタグで識別され、値は6に設定されます。

"current_level"というタグが"6"に設定されたOneSignalのユーザープロファイル

current_level値が4より大きく10より小さいユーザーをターゲットとするセグメントを示すセグメントエディター

パーソナライズされたメッセージでLevel 5-10セグメントをターゲットとするプッシュ通知を示すスクリーンショット

パーソナライズされたコンテンツを含むプッシュ通知がiOSおよびAndroidデバイスで受信されます
メールおよび/またはSMSサブスクリプションを追加
以前、SDKがプッシュとアプリ内メッセージを送信するためにモバイルサブスクリプションを作成する方法を見ました。対応するサブスクリプションを作成することで、メールとSMSチャネルを通じてユーザーにリーチすることもできます。addEmailメソッドを使用してメールサブスクリプションを作成します。addSmsメソッドを使用してSMSサブスクリプションを作成します。

External IDによって統合されたプッシュ、メール、SMSサブスクリプションを持つユーザープロファイル
- メールまたはSMSサブスクリプションを追加する前に、明示的な同意を得てください。
- 各コミュニケーションチャネルの利点をユーザーに説明してください。
- ユーザーが好むチャネルを選択できるように、チャネルの設定を提供してください。
プライバシーとユーザー同意
OneSignalがユーザーデータを収集するタイミングを制御するには、SDKの同意ゲーティングメソッドを使用します:setConsentRequired(true):同意が与えられるまでデータ収集を防ぎます。setConsentGiven(true):同意が付与されるとデータ収集を有効にします。
プッシュ許可のプロンプト
アプリを開いたときにすぐにrequestPermission()を呼び出すのではなく、より戦略的なアプローチを取ります。許可をリクエストする前に、アプリ内メッセージを使用してプッシュ通知の価値を説明します。
ベストプラクティスと実装の詳細については、プッシュ許可のプロンプトガイドを参照してください。
プッシュ、ユーザー、アプリ内イベントをリッスン
SDKリスナーを使用して、ユーザーのアクションと状態の変化に反応します。 SDKは、フックできるいくつかのイベントリスナーを提供します。詳細については、SDKリファレンスガイドを参照してください。プッシュ通知イベント
addClickListener():通知がタップされたときを検出します。ディープリンクに役立ちます。addForegroundLifecycleListener():フォアグラウンドでの通知の動作を制御します。
ユーザー状態の変更
- ユーザー状態用の
addObserver():External IDが設定されたときを検出します。 addPermissionObserver():ネイティブのプッシュ許可プロンプトとのユーザーの特定のインタラクションを追跡します。- プッシュサブスクリプション用の
addObserver():プッシュサブスクリプションのステータスが変更されたときを追跡します。
アプリ内メッセージイベント
addClickListener():アプリ内クリックアクションを処理します。ディープリンクやイベントの追跡に最適です。addLifecycleListener():アプリ内メッセージの完全なライフサイクル(表示、クリック、閉じるなど)を追跡します。
高度なセットアップと機能
統合を強化するための追加機能を探索します:- 🔁 別のサービスからOneSignalへの移行
- 🌍 位置情報トラッキング
- 🔗 ディープリンク
- 🔌 統合
- 🧩 Mobile Service Extensions
- 🛎️ アクションボタン
- 🌐 多言語メッセージング
- 🛡️ Identity Verification
- 📊 カスタムアウトカム
- 📲 Live Activities
Mobile SDKのセットアップとリファレンス
モバイルプッシュセットアップガイドを確認して、すべての主要機能が有効になっていることを確認してください。 利用可能なメソッドと設定オプションの詳細については、Mobile SDKリファレンスにアクセスしてください。プライバシーとユーザー同意
アプリがデータ収集の前にユーザーの同意を必要とする場合(GDPRコンプライアンスなど)、同意が付与されるまでOneSignalのデータ収集を遅らせることができます。initializeの前にsetConsentRequiredを呼び出します。
setConsentGiven(true)を呼び出してください。詳細については、個人データの取り扱いを参照してください。トラブルシューティング
support@onesignal.comにメールしてください以下を含めてください:- 発生している問題の詳細と再現手順(利用可能な場合)
- OneSignal App ID
- 該当する場合は、External IDまたはSubscription ID
- 該当する場合は、OneSignalダッシュボードでテストしたメッセージのURL
- 関連するログまたはエラーメッセージ