> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# .NET MAUI SDKセットアップ
> iOS、Android、デスクトップ向けのクロスプラットフォームMAUIアプリにOneSignal .NET SDKを追加する手順。
export const SdkReleasesIframe = ({sdkFilter = undefined, viewMode = undefined, height, ...frameProps}) => {
const baseUrl = 'https://onesignal.github.io/sdk-releases';
const buildUrl = (theme, sdkFilter, viewMode) => {
const url = new URL(baseUrl);
const params = new URLSearchParams();
if (theme) {
params.set('theme', theme);
}
if (sdkFilter) {
params.set('sdk', sdkFilter);
}
if (viewMode) {
params.set('viewMode', viewMode);
}
if (params.toString()) {
url.search = params.toString();
}
return url.toString();
};
const detectTheme = () => {
if (document.documentElement.classList.contains('dark')) {
return 'dark';
}
return 'light';
};
const [theme, setTheme] = useState('light');
const [iframeSrc, setIframeSrc] = useState(() => {
const initialTheme = detectTheme();
return buildUrl(initialTheme, sdkFilter, viewMode);
});
useEffect(() => {
const currentTheme = detectTheme();
setTheme(currentTheme);
setIframeSrc(buildUrl(currentTheme, sdkFilter, viewMode));
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
const handleThemeChange = () => {
const newTheme = detectTheme();
setTheme(newTheme);
setIframeSrc(buildUrl(newTheme, sdkFilter, viewMode));
};
if (mediaQuery.addEventListener) {
mediaQuery.addEventListener('change', handleThemeChange);
} else {
mediaQuery.addListener(handleThemeChange);
}
window.addEventListener('storage', handleThemeChange);
const observer = new MutationObserver(handleThemeChange);
observer.observe(document.documentElement, {
attributes: true,
attributeFilter: ['class', 'data-theme']
});
return () => {
if (mediaQuery.removeEventListener) {
mediaQuery.removeEventListener('change', handleThemeChange);
} else {
mediaQuery.removeListener(handleThemeChange);
}
window.removeEventListener('storage', handleThemeChange);
observer.disconnect();
};
}, [sdkFilter, viewMode]);
const getIframeHeight = () => {
if (viewMode === 'table') {
return '450';
}
if (viewMode === 'mini') {
return '170';
}
return '800';
};
const iframeHeight = height || getIframeHeight();
return
;
};
## 概要
このガイドでは、OneSignalプッシュ通知を.NET MAUIアプリケーションに統合する方法を説明します。インストールから構成、サービスワーカー管理まで、すべてをカバーします。
***
## 要件
* .NET 7.0以上
* Visual Studio 2019以降
* 構成されたOneSignalアプリとプラットフォーム
**iOS要件**
* Xcode 14以上を搭載したmacOS（セットアップ手順はXcode 16.2を使用）
* iOS 12以上、iPadOS 12以上、またはiOS 16.2以上を実行するXcodeシミュレーターを搭載したデバイス
* CocoaPods 1.16.2以上
**Android要件**
* Google Playストア（サービス）がインストールされたAndroid 7.0以上のデバイスまたはエミュレーター
### OneSignalアプリとプラットフォームを設定
サポートするプラットフォーム（Apple（APNs）、Google（FCM）、Huawei（HMS）、Amazon（ADM））でOneSignalアプリを設定します。
組織がすでにOneSignalアカウントを持っている場合は、組織への[招待をリクエスト](/docs/ja/manage-team-members)してください。それ以外の場合は、[無料アカウントにサインアップ](https://onesignal.com)して開始してください。
**New App/Website** をクリックして新しいアプリを作成するか、**Settings > Push & In-App** で既存のアプリにプラットフォームを追加します。設定するプラットフォームを選択し、**Next: Configure Your Platform** をクリックします。
プラットフォームの認証情報を入力します：
* **Android**：[Firebase認証情報をセットアップ](/docs/ja/android-firebase-credentials)
* **iOS**：[p8トークン（推奨）](/docs/ja/ios-p8-token-based-connection-to-apns)または[p12証明書](/docs/ja/ios-p12-generate-certificates)
* **Amazon**：[APIキーを生成](/docs/ja/generate-an-amazon-api-key)
* **Huawei**：[OneSignalを承認](/docs/ja/authorize-onesignal-to-send-huawei-push)
認証情報を入力した後、**Save & Continue** をクリックします。
**App ID** は最終画面に表示されます。コピーして保存してください — SDKを初期化するときに必要です。SDKプラットフォームを選択し、セットアップガイドに従います。
***
## SDKセットアップ
### 1. SDKを追加する
.NET CLIを使用：
```http bash theme={null}
dotnet add package OneSignalSDK.DotNet
```
### オプション: 位置情報モジュールを無効にする
`OneSignalSDK.DotNet` 6.2.0 以降では、アプリが位置情報機能を使用しない場合、iOS と Android のビルドから OneSignal のネイティブ位置情報モジュールを除外できます。デフォルトでは、`OneSignalSDK.DotNet` にネイティブ位置情報モジュールが含まれているため、追加設定なしで `OneSignal.Location` が動作します。
アプリプロジェクトに `OneSignalDisableLocation` MSBuild プロパティを追加します。
```xml .csproj theme={null}
true
```
無効にすると、位置情報モジュールのないネイティブビルドでは `OneSignal.Location.RequestPermission()` と `OneSignal.Location.IsShared = value` は no-op になります。`OneSignal.Location.IsShared` は `false` を返します。
通常の開発では、SDK を使用するアプリビルドにこのプロパティが設定されていることを確認してください。プロジェクト参照やスクリプトを使ってソースからビルドする場合は、参照される SDK プロジェクトにも適用されるように、このプロパティを `dotnet build` に渡してください。
```shell theme={null}
dotnet build -f net10.0-ios -p:OneSignalDisableLocation=true
dotnet build -f net10.0-android -p:OneSignalDisableLocation=true
```
CI では、ビルドキャッシュキーに `OneSignalDisableLocation` の値を含めるか、この値を切り替えるときにビルド出力をクリーンしてください。これにより、位置情報モジュールが有効な状態で生成された古い iOS アプリバンドル、Android 中間ファイル、または `bin/obj` 出力が復元されるのを防げます。
`OneSignalDisableLocation` は MSBuild 専用の設定です。.NET SDK の位置情報モジュールを無効にするための Gradle properties はサポートされていません。
### 2. SDKを初期化する
`App.xaml.cs`ファイルでOneSignalを初期化します。
`YOUR_APP_ID`をOneSignalダッシュボードの\*\*Settings > [Keys & IDs](./keys-and-ids)\*\*にあるOneSignalアプリIDに置き換えます。
OneSignalアプリにアクセスできない場合は、[チームメンバー](./manage-team-members)に招待を依頼してください。
```csharp C# theme={null}
using OneSignalSDK.DotNet;
using OneSignalSDK.DotNet.Core;
using OneSignalSDK.DotNet.Core.Debug;
public App() {
InitializeComponent();
// Enable verbose OneSignal logging to debug issues if needed.
OneSignal.Debug.LogLevel = LogLevel.VERBOSE;
// OneSignal Initialization
OneSignal.Initialize("YOUR_APP_ID");
// RequestPermissionAsync will show the notification permission prompt.
// We recommend removing the following code and instead using an In-App Message to prompt for notification permission (See step 5)
OneSignal.Notifications.RequestPermissionAsync(true);
MainPage = new AppShell();
}
```
### 3. iOSサービスエクステンションの追加
Microsoftは、Visual StudioとVisual Studio for Macを使用した通知サービスエクステンションの生成に関するガイドを[ここ](https://learn.microsoft.com/en-us/xamarin/ios/platform/user-notifications/enhanced-user-notifications?tabs=windows#implementing-a-service-extension)で提供していますが、現時点ではVSCode用の作成方法に関するガイダンスはありません。
上記のガイドに従ってサービスエクステンションを生成する場合は、[Githubにある](https://github.com/OneSignal/OneSignal-DotNet-SDK/blob/d8c41c4ddd2f605f6bb2efbceabc7a6f6a2df1c3/OneSignalSDK.dotnet.iOS/NotificationServiceExtension.cs#L13)サンプルプロジェクトのコードに従うことができます
```csharp C# theme={null}
using System;
using Foundation;
using OneSignalSDK.DotNet;
using OneSignalSDK.DotNet.iOS;
using UIKit;
using UserNotifications;
namespace OneSignalNotificationServiceExtension
{
[Register("NotificationService")]
public class NotificationService : UNNotificationServiceExtension
{
Action ContentHandler { get; set; }
UNMutableNotificationContent BestAttemptContent { get; set; }
UNNotificationRequest ReceivedRequest { get; set; }
protected NotificationService(IntPtr handle) : base(handle)
{
// Note: this .ctor should not contain any initialization logic.
}
public override void DidReceiveNotificationRequest(UNNotificationRequest request, Action contentHandler)
{
ReceivedRequest = request;
ContentHandler = contentHandler;
BestAttemptContent = (UNMutableNotificationContent)request.Content.MutableCopy();
NotificationServiceExtension.DidReceiveNotificationExtensionRequest(request, BestAttemptContent, contentHandler);
}
public override void TimeWillExpire()
{
// Called just before the extension will be terminated by the system.
// Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
NotificationServiceExtension.ServiceExtensionTimeWillExpireRequest(ReceivedRequest, BestAttemptContent);
ContentHandler(BestAttemptContent);
}
}
}
```
***
## Androidセットアップ
[Firebase認証情報](/docs/ja/android-firebase-credentials)を使用して、OneSignalアプリがAndroidプラットフォーム用に設定されていることを確認してください。
アプリのブランディングに合わせて[通知アイコン](/docs/ja/notification-icons)をセットアップします。このステップをスキップすると、プッシュ通知にデフォルトのベルアイコンが表示されます。
**Androidでビルド**
この時点で、物理Androidデバイスまたはエミュレーターでアプリをビルドして実行できるはずです。
Androidビルドが機能することを確認した後：
* 該当する場合は、[iOSセットアップ](#ios-setup)に進みます。
* または、[OneSignal SDK統合のテスト](#testing-the-onesignal-sdk-integration)に進みます。
***
## iOSセットアップ
[p8トークン（推奨）](/docs/ja/ios-p8-token-based-connection-to-apns)または[p12証明書](/docs/ja/ios-p12-generate-certificates)を使用して、OneSignalアプリがiOSプラットフォーム用に設定されていることを確認してください。
以下の手順に従って、[バッジ](/docs/ja/badges)、[Confirmed receipt](/docs/ja/confirmed-delivery)、画像のサポートを含む、iOSアプリにプッシュ通知を追加します。
### 1. アプリターゲットにPush Notifications機能を追加
[Push Notifications機能](https://developer.apple.com/documentation/UserNotifications/registering-your-app-with-apns#Enable-the-push-notifications-capability)により、アプリはプッシュトークンを登録して通知を受信できます。
1. Xcodeでアプリの`.xcworkspace`ファイルを開きます。
2. **アプリターゲット > Signing & Capabilities**を選択
3. **+ Capability**をクリックして**Push Notifications**機能を追加
### 2. アプリターゲットにBackground Modes機能を追加
これにより、プッシュ通知が到着したときにアプリがバックグラウンドで起動できるようになります。
1. [Background Modes](https://developer.apple.com/documentation/usernotifications/pushing-background-updates-to-your-app)機能を追加
2. **Remote notifications**を有効化
### 3. アプリターゲットをApp Groupに追加
[App Groups](https://developer.apple.com/documentation/xcode/configuring-app-groups/#Create-App-Groups-for-all-other-platforms)により、アプリとNotification Service Extension間でデータを共有できます。confirmed receiptとBadgesに必要です。
1. **App Groups**機能を追加
2. App Groups機能で\*\*+\*\*をクリック
3. 次の形式で新しいコンテナIDを追加：`group.your_bundle_id.onesignal`
* **group.**と**.onesignal**のプレフィックスとサフィックスを保持します。\*\*`your_bundle_id`\*\*をアプリのバンドル識別子に置き換えます。
* 例えば、バンドル識別子`com.onesignal.MyApp`の場合、コンテナ名は`group.com.onesignal.MyApp.onesignal`になります。
App Group名は、すべてのターゲットでバンドルIDのスペルと大文字小文字と正確に一致する必要があります。
1. **App Target**と**OneSignalNotificationServiceExtension Targetの**`Info.plist`を開く
2. 両方のターゲットの`Info.plist`に新しいプロパティを追加：
* **Key:** `OneSignal_app_groups_key`
* **Value:** 既存のApp Group名（例：`group.your-custom-group-id`）
```xml XML theme={null}
OneSignal_app_groups_key
group.your-custom-group-id
```
App Target**と**OneSignalNotificationServiceExtension Targetの**両方**の`Info.plist`で`OneSignal_app_groups_key`を更新してください！
### 4. Notification Service Extensionを追加
[Notification Service Extension（NSE）](https://developer.apple.com/documentation/usernotifications/modifying-content-in-newly-delivered-notifications)により、リッチ通知とconfirmed receipt分析が有効になります。
1. Xcodeで：**File > New > Target...**
2. **Notification Service Extension**を選択し、**Next**をクリック
3. 製品名を`OneSignalNotificationServiceExtension`に設定して**Finish**を押す
4. Activate schemeプロンプトで**Don't Activate**を押す
OneSignalNotificationServiceExtensionの**Minimum Deployment Target**をメインアプリと一致するように設定します（iOS 15+推奨）。
CocoaPodsを使用している場合は、Podfileでデプロイメントバージョンも設定してください。
### 5. NSEターゲットをApp Groupに追加
ステップ3で追加したものと同じApp Group IDを使用します。
1. **OneSignalNotificationServiceExtension > Signing & Capabilities**に移動
2. **App Groups**を追加
3. 完全に同じグループIDを追加
カスタムApp Group名を使用していて`group.your_bundle_id.onesignal`を使用していない場合は、App TargetとOneSignalNotificationServiceExtension Targetの両方の`Info.plist`にApp Group IDを追加してください！詳細については、[ステップ3](#3-add-app-target-to-app-group)を参照してください。
### 6. NSEコードを更新
1. **OneSignalNotificationServiceExtension**フォルダーに移動
2. `NotificationService.swift`または`NotificationService.m`ファイルの内容を次のコードに置き換えます：
```swift Swift theme={null}
import UserNotifications
import OneSignalExtension
class NotificationService: UNNotificationServiceExtension {
var contentHandler: ((UNNotificationContent) -> Void)?
var receivedRequest: UNNotificationRequest!
var bestAttemptContent: UNMutableNotificationContent?
// Note this extension only runs when `mutable_content` is set
// Setting an attachment or action buttons automatically sets the property to true
override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
self.receivedRequest = request
self.contentHandler = contentHandler
self.bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
if let bestAttemptContent = bestAttemptContent {
// DEBUGGING: Uncomment the 2 lines below to check this extension is executing
// print("Running NotificationServiceExtension")
// bestAttemptContent.body = "[Modified] " + bestAttemptContent.body
OneSignalExtension.didReceiveNotificationExtensionRequest(self.receivedRequest, with: bestAttemptContent, withContentHandler: self.contentHandler)
}
}
override func serviceExtensionTimeWillExpire() {
// Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
OneSignalExtension.serviceExtensionTimeWillExpireRequest(self.receivedRequest, with: self.bestAttemptContent)
contentHandler(bestAttemptContent)
}
}
}
```
```objectivec Objective-C theme={null}
#import
#import "NotificationService.h"
@interface NotificationService ()
@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);
@property (nonatomic, strong) UNNotificationRequest *receivedRequest;
@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;
@end
@implementation NotificationService
// Note, this extension only runs when mutable-content is set
// Setting an attachment or action buttons automatically adds this
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
self.receivedRequest = request;
self.contentHandler = contentHandler;
self.bestAttemptContent = [request.content mutableCopy];
// DEBUGGING: Uncomment the 2 lines below and comment out the one above to ensure this extension is executing
// NSLog(@"Running NotificationServiceExtension");
// self.bestAttemptContent.body = [@"[Modified] " stringByAppendingString:self.bestAttemptContent.body];
[OneSignalExtension didReceiveNotificationExtensionRequest:self.receivedRequest
withMutableNotificationContent:self.bestAttemptContent
withContentHandler:self.contentHandler];
}
- (void)serviceExtensionTimeWillExpire {
// Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
[OneSignalExtension serviceExtensionTimeWillExpireRequest:self.receivedRequest withMutableNotificationContent:self.bestAttemptContent];
self.contentHandler(self.bestAttemptContent);
}
@end
```
OneSignalパッケージがインストールされていないため、エラーが表示されます。これは次のステップで解決されます。
### 7. NSEターゲットにOneSignalを追加
SDKがiOSの依存関係にSwift Package Manager（SPM）を使用している場合、このステップはスキップできます。OneSignalパッケージはすでに解決されており、すべてのターゲットで利用可能です。
`ios/Podfile`を更新して次を含めます：
```ruby Podfile theme={null}
target 'OneSignalNotificationServiceExtension' do
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
```ruby Example theme={null}
target 'MyApp' do
config = use_native_modules!
use_react_native!(
:path => config[:reactNativePath],
# An absolute path to your application root.
:app_path => "#{Pod::Config.instance.installation_root}/.."
)
post_install do |installer|
# https://github.com/facebook/react-native/blob/main/packages/react-native/scripts/react_native_pods.rb#L197-L202
react_native_post_install(
installer,
config[:reactNativePath],
:mac_catalyst_enabled => false,
# :ccache_enabled => true
)
end
end
target 'OneSignalNotificationServiceExtension' do
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
ターミナルでプロジェクトを開いて実行します：
```shell shell theme={null}
cd ios pod install cd ..
```
#### 一般的なpod installエラー
次のエラーが発生する可能性があります。以下の方法で解決できます。
CocoaPodsは`xcodeproj` Ruby gemを使用してXcodeプロジェクトファイルを読み取ります。現在、最新の`xcodeproj`リリースはXcode 16で導入されたオブジェクトバージョン70を認識しません。そのため、CocoaPodsが`.xcodeproj`ファイルを開こうとすると、このエラーでクラッシュします。
1. Xcodeを閉じます。
2. プロジェクトの`ios/.xcodeproj/project.pbxproj`ファイルに移動します。
3. この行を変更します：`objectVersion = 70;`
4. これに置き換えます：`objectVersion = 55;`
5. 保存して閉じ、`cd ios pod install cd ..`を再実行します
### iOSでビルド
実機のiOSデバイスまたはiOSシミュレーター（16.2+）でアプリをビルドして実行できるようになりました。
#### 一般的なiOSビルドエラー
Xcode 15+でビルドする際、クロスプラットフォームシステムに影響を与えるデフォルト設定の変更により、このエラーが表示される場合があります。
1. Xcodeで`.xcworkspace`フォルダーを開き、**アプリターゲット > Build Phases**に移動します。
2. \*\*「Embed Foundation Extensions」**または**「Embed App Extensions」\*\*という名前のフェーズがあるはずです。
3. このビルドフェーズを\*\*「Run Script」\*\*の\_上\_にドラッグして移動します。
4. アプリをビルドして実行します。エラーは解決されるはずです。
RuntimeError - `PBXGroup` attempted to initialize an object with unknown ISA `PBXFileSystemSynchronizedRootGroup` from attributes: `{"isa"=>"...", "exceptions"=>["//", "..."], "explicitFileTypes"=>{}, "explicitFolders"=>[], "path"=>"OneSignalNotificationServiceExtension", "sourceTree"=>""}`
修正方法：
1. エラー内の「path」の下にリストされているフォルダーを見つけます
2. Xcodeプロジェクトサイドバーで、フォルダーを右クリックします
3. **Convert to Group**を選択します
iOSビルドが機能することを確認した後、[OneSignal SDK統合のテスト](#testing-the-onesignal-sdk-integration)に進みます。
***
## OneSignal SDK統合のテスト
このガイドでは、プッシュ通知、サブスクリプション登録、アプリ内メッセージをテストして、OneSignal SDK統合が正しく機能していることを確認する方法を説明します。
### モバイルサブスクリプションを確認
初期化時に`requestPermission`メソッドを追加した場合、ネイティブのプッシュ許可プロンプトが自動的に表示されます。
プロンプトを受け入れる前に、OneSignalダッシュボードを確認してください：
* **Audience > Subscriptions**に移動します。
* ステータスが「Never Subscribed」の新しいエントリが表示されるはずです。
サブスクリプションのステータスが**Subscribed**と表示されるはずです。
[モバイルサブスクリプション](/docs/ja/subscriptions)の作成に成功しました。
モバイルサブスクリプションは、ユーザーがデバイスで初めてアプリを開いたとき、またはユーザーが同じデバイスでアプリをアンインストールして再インストールしたときに作成されます。
### テストサブスクリプションをセットアップ
テストサブスクリプションは、メッセージを送信する前にプッシュ通知をテストするのに役立ちます。
ダッシュボードで、サブスクリプションの横にある\*\*Options（3つのドット）\*\*ボタンをクリックし、**Add to Test Users**を選択します。
**test usersタブ**で後でデバイスを簡単に識別できるように、サブスクリプションに名前を付けます。
**Audience > Segments > New Segment**に移動します。
セグメントに`Test Users`という名前を付けます（この名前は後で使用されるため重要です）。
テストユーザーのセグメントの作成に成功しました。
この個別のデバイスとテストユーザーのグループにメッセージを送信するテストが可能になりました。
### API経由でテストプッシュを送信
OneSignalダッシュボードで、\*\*Settings > [Keys & IDs](/docs/ja/keys-and-ids)\*\*に移動します。
以下のコードの`YOUR_APP_API_KEY`と`YOUR_APP_ID`を実際のキーに置き換えます。このコードは、先ほど作成した`Test Users`セグメントを使用します。
```curl theme={null}
curl -X \
POST --url 'https://api.onesignal.com/notifications' \
--header 'content-type: application/json; charset=utf-8' \
--header 'authorization: Key YOUR_APP_API_KEY' \
--data \
'{
"app_id": "YOUR_APP_ID",
"target_channel": "push",
"name": "Testing basic setup",
"headings": {
"en": "👋"
},
"contents": {
"en": "Hello world!"
},
"included_segments": [
"Test Users"
],
"ios_attachments": {
"onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
},
"big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'
```
ターミナルでコードを実行します。
すべてのセットアップ手順が正常に完了した場合、テストサブスクリプションは画像を含む通知を受信するはずです：
画像は折りたたまれた通知ビューでは小さく表示されます。通知を展開すると、完全な画像が表示されます。
ダッシュボードで、**Delivery > Sent Messages**に移動し、メッセージをクリックして統計を表示します。
**confirmed**統計が表示されるはずです。これは、デバイスがプッシュを受信したことを意味します。
API経由でセグメントに通知を送信することに成功しました。
* 画像が受信されない場合は、[Notification Service Extension](#ios-setup)が不足している可能性があります。
* confirmed receiptがない場合は、[こちら](/docs/ja/confirmed-delivery#troubleshooting-confirmed-delivery)のトラブルシューティングガイドを確認してください。
* 問題が発生した場合は、APIリクエストとアプリ起動の最初から最後までのログを`.txt`ファイルにコピー&ペーストしてください。その後、両方を`support@onesignal.com`と共有してください。
### アプリ内メッセージを送信
[アプリ内メッセージ](/docs/ja/in-app-messages-setup)を使用すると、ユーザーがアプリを使用している間にユーザーとコミュニケーションできます。
これは、ユーザーが新しいセッションを開始する\_前\_にアプリ内オーディエンスの基準を満たす必要があるためです。OneSignalでは、ユーザーがアプリをバックグラウンドまたは閉じた状態から少なくとも30秒後に開くと、新しいセッションが開始されます。詳細については、[アプリ内メッセージの表示方法](/docs/ja/in-app-messages-setup#how-are-iams-displayed%3F)に関するガイドを参照してください。
* OneSignalダッシュボードで、**Messages > In-App > New In-App**に移動します。
* **Welcome**メッセージを見つけて選択します。
* Audienceを、以前使用した**Test Users**セグメントに設定します。
\*\*Schedule > How often do you want to show this message?\*\*で、**Every time trigger conditions are satisfied**を選択します。
**Make Message Live**をクリックして、Test Usersがアプリを開くたびにメッセージが利用できるようにします。
アプリ内メッセージがライブになったら、アプリを開きます。次のように表示されるはずです：
メッセージが表示されない場合：
* 新しいセッションを開始します
* 再度開く前に、少なくとも30秒間アプリを閉じるかバックグラウンドにする必要があります。これにより、新しいセッションが開始されます。
* 詳細については、[アプリ内メッセージの表示方法](/docs/ja/in-app-messages-setup#how-are-iams-displayed%3F)を参照してください。
* まだ`Test Users`セグメントに含まれていますか？
* アプリを再インストールしたりデバイスを切り替えたりした場合は、デバイスを[Test Users](#set-up-test-users)に再度追加し、Test Usersセグメントの一部であることを確認してください。
* 問題が発生していますか？
* 上記の手順を再現しながら[デバッグログの取得](/docs/ja/capturing-a-debug-log)に従ってください。これにより、`support@onesignal.com`と共有できる追加のログが生成され、何が起こっているかを調査するのに役立ちます。
OneSignal SDKのセットアップが成功し、次のような重要な概念を学びました：
* [サブスクリプション](/docs/ja/subscriptions)の収集、[テストサブスクリプション](/docs/ja/find-set-test-subscriptions)の設定、[セグメント](/docs/ja/segmentation)の作成。
* セグメントと[Create message](/reference/create-message) APIを使用した画像付き[プッシュ](/docs/ja/push)と[Confirmed receipt](/docs/ja/confirmed-delivery)の送信。
* [アプリ内メッセージ](/docs/ja/in-app-messages-setup)の送信。
このガイドを続けて、アプリでユーザーを識別し、追加機能をセットアップします。
***
## ユーザー識別
以前、モバイル[サブスクリプション](/docs/ja/subscriptions)の作成方法を説明しました。次に、OneSignal SDKを使用して、すべてのサブスクリプション（プッシュ、メール、SMSを含む）にわたる[ユーザー](/docs/ja/users)の識別に拡張します。プラットフォーム間でユーザーを統合し、エンゲージメントするために、External ID、タグ、マルチチャネルサブスクリプション、プライバシー、イベントトラッキングについて説明します。
### External IDを割り当て
External IDを使用して、バックエンドのユーザー識別子を使用して、デバイス、メールアドレス、電話番号間でユーザーを一貫して識別します。これにより、チャネルとサードパーティシステム間でメッセージングが統一されたままになります（特に[統合](/docs/ja/integrations)に重要）。
アプリによって識別されるたびに、SDKの[`login`メソッド](/docs/ja/mobile-sdk-reference#login-external-id)を使用してExternal IDを設定します。
OneSignalは、サブスクリプション（Subscription ID）とユーザー（OneSignal ID）に対して一意の読み取り専用IDを生成します。
ユーザーが異なるデバイスでアプリをダウンロードしたり、ウェブサイトにサブスクライブしたり、アプリ外でメールアドレスや電話番号を提供したりすると、新しいサブスクリプションが作成されます。
すべてのサブスクリプションにわたってユーザーを識別するために、SDK経由でExternal IDを設定することを強くお勧めします。作成方法に関係なく。
### データタグを追加
[タグ](/docs/ja/add-user-data-tags)は、ユーザープロパティ（`username`、`role`、設定など）とイベント（`purchase_date`、`game_level`、ユーザーインタラクションなど）を保存するために使用できる文字列データのキーと値のペアです。タグは、高度な[メッセージパーソナライゼーション](/docs/ja/message-personalization)と[セグメンテーション](/docs/ja/segmentation)を強化し、より高度なユースケースを可能にします。
アプリでイベントが発生したときに、SDKの[`addTag`および`addTags`メソッド](/docs/ja/mobile-sdk-reference#data-tags)を使用してタグを設定します。
この例では、ユーザーはレベル6に到達し、`current_level`というタグで識別され、値は`6`に設定されます。
レベルが5から10の間のユーザーのセグメントを作成し、それを使用してターゲット化されたパーソナライズされたメッセージを送信できます：
### メールおよび/またはSMSサブスクリプションを追加
以前、SDKがプッシュとアプリ内メッセージを送信するためにモバイルサブスクリプションを作成する方法を見ました。対応するサブスクリプションを作成することで、メールとSMSチャネルを通じてユーザーにリーチすることもできます。
* [`addEmail`メソッド](/docs/ja/mobile-sdk-reference#addemail-%2C-removeemail)を使用してメールサブスクリプションを作成します。
* [`addSms`メソッド](/docs/ja/mobile-sdk-reference#addsms-%2C-removesms)を使用してSMSサブスクリプションを作成します。
メールアドレスや電話番号がOneSignalアプリに既に存在する場合、SDKはそれを既存のユーザーに追加し、重複は作成しません。
ダッシュボードの**Audience > Users**または[View user API](/reference/view-user)を使用して、統合されたユーザーを表示できます。
マルチチャネルコミュニケーションのベストプラクティス
* メールまたはSMSサブスクリプションを追加する前に、明示的な同意を得てください。
* 各コミュニケーションチャネルの利点をユーザーに説明してください。
* ユーザーが好むチャネルを選択できるように、チャネルの設定を提供してください。
***
### プライバシーとユーザー同意
OneSignalがユーザーデータを収集するタイミングを制御するには、SDKの同意ゲーティングメソッドを使用します：
* [`setConsentRequired(true)`](/docs/ja/mobile-sdk-reference#setconsentrequired)：同意が与えられるまでデータ収集を防ぎます。
* [`setConsentGiven(true)`](/docs/ja/mobile-sdk-reference#setconsentgiven)：同意が付与されるとデータ収集を有効にします。
詳細については、プライバシーとセキュリティのドキュメントを参照してください：
* [SDKによって収集されるデータ](/docs/ja/data-collected-by-the-onesignal-sdk)
* [個人データの取り扱い](/docs/ja/handling-personal-data)
***
## プッシュ許可のプロンプト
アプリを開いたときにすぐに`requestPermission()`を呼び出すのではなく、より戦略的なアプローチを取ります。許可をリクエストする前に、アプリ内メッセージを使用してプッシュ通知の価値を説明します。
ベストプラクティスと実装の詳細については、[プッシュ許可のプロンプト](/docs/ja/prompt-for-push-permissions)ガイドを参照してください。
***
## プッシュ、ユーザー、アプリ内イベントをリッスン
SDKリスナーを使用して、ユーザーのアクションと状態の変化に反応します。
SDKは、フックできるいくつかのイベントリスナーを提供します。詳細については、[SDKリファレンスガイド](/docs/ja/mobile-sdk-reference)を参照してください。
### プッシュ通知イベント
* [`addClickListener()`](/docs/ja/mobile-sdk-reference#addclicklistener-push)：通知がタップされたときを検出します。[ディープリンク](/docs/ja/deep-linking)に役立ちます。
* [`addForegroundLifecycleListener()`](/docs/ja/mobile-sdk-reference#addforegroundlifecyclelistener-push)：フォアグラウンドでの通知の動作を制御します。
完全なカスタマイズについては、[Mobile Service Extensions](/docs/ja/service-extensions)を参照してください。
### ユーザー状態の変更
* [ユーザー状態用の`addObserver()`](/docs/ja/mobile-sdk-reference#addobserver-user-state)：External IDが設定されたときを検出します。
* [`addPermissionObserver()`](/docs/ja/mobile-sdk-reference#addpermissionobserver-push)：ネイティブのプッシュ許可プロンプトとのユーザーの特定のインタラクションを追跡します。
* [プッシュサブスクリプション用の`addObserver()`](/docs/ja/mobile-sdk-reference#addobserver-push-subscription-changes)：プッシュサブスクリプションのステータスが変更されたときを追跡します。
### アプリ内メッセージイベント
* [`addClickListener()`](/docs/ja/mobile-sdk-reference#addclicklistener-in-app)：アプリ内クリックアクションを処理します。ディープリンクやイベントの追跡に最適です。
* [`addLifecycleListener()`](/docs/ja/mobile-sdk-reference#addclicklistener-in-app)：アプリ内メッセージの完全なライフサイクル（表示、クリック、閉じるなど）を追跡します。
***
## 高度なセットアップと機能
統合を強化するための追加機能を探索します：
* [🔁 別のサービスからOneSignalへの移行](/docs/ja/migrating-to-onesignal)
* [🌍 位置情報トラッキング](/docs/ja/mobile-sdk-reference#location)
* [🔗 ディープリンク](/docs/ja/deep-linking)
* [🔌 統合](/docs/ja/integrations)
* [🧩 Mobile Service Extensions](/docs/ja/service-extensions)
* [🛎️ アクションボタン](/docs/ja/action-buttons)
* [🌐 多言語メッセージング](/docs/ja/multi-language-messaging)
* [🛡️ Identity Verification](/docs/ja/identity-verification)
* [📊 カスタムアウトカム](/docs/ja/custom-outcomes)
* [📲 Live Activities](/docs/ja/live-activities)
### Mobile SDKのセットアップとリファレンス
[モバイルプッシュセットアップ](/docs/ja/mobile-push-setup)ガイドを確認して、すべての主要機能が有効になっていることを確認してください。
利用可能なメソッドと設定オプションの詳細については、[Mobile SDKリファレンス](/docs/ja/mobile-sdk-reference)にアクセスしてください。
おめでとうございます！Mobile SDKセットアップガイドが正常に完了しました。
***
サポートが必要ですか？
サポートチームとチャットするか、`support@onesignal.com`にメールしてください
以下を含めてください：
* 発生している問題の詳細と再現手順（利用可能な場合）
* OneSignal App ID
* 該当する場合は、External IDまたはSubscription ID
* 該当する場合は、OneSignalダッシュボードでテストしたメッセージのURL
* 関連する[ログまたはエラーメッセージ](/docs/ja/capturing-a-debug-log)
お気軽にお問い合わせください！
***