> ## 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.
# モバイルプッシュセットアップ
> iOS、Android、Huawei、Amazon 全体で OneSignal を使用してモバイルプッシュ通知を設定するためのエンドツーエンドチェックリスト。
プッシュ通知は、ユーザーがアプリをアクティブに使用していないときに再エンゲージします。テキストや画像、ボタン、サウンドなどのリッチコンテンツを表示できます。
モバイルでプッシュが機能するには：
* ユーザーがモバイルアプリをインストールしている必要があります
* 正しいプラットフォーム認証情報を設定する必要があります（Android の FCM、iOS の APNs、Huawei の HMS、Amazon の ADM）
* ユーザーが通知を受信する権限を付与する必要があります
このガイドでは、SDK セットアップからパーソナライズされたプッシュメッセージの送信まで、すべてのステップを説明します。
***
## SDK セットアップと移行
アプリに OneSignal SDK を統合してデバイスを登録し、プッシュメッセージングを有効にします。別のプロバイダーから移行する場合、OneSignal は Firebase、Airship、Braze などからの移行をサポートしています。
アプリに OneSignal SDK を統合してデバイスを登録し、プッシュメッセージングを有効にします。
Firebase、Airship、Braze、またはその他のプッシュプロバイダーから移行します。
***
## プッシュ権限プロンプト
モバイルプラットフォームでは、プッシュ通知を受信する前にユーザーがオプトインする必要があります。Apple の[Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/ios/system-capabilities/notifications) では、送信したい情報の種類を説明し、ユーザーにオプトインまたはオプトアウトする明確な方法を提供することを推奨しています。
OneSignal のアプリ内メッセージを使用して、システムプロンプトをトリガーする前に価値を説明する事前権限プロンプトを構築できます。
アプリ内メッセージを使用してカスタム事前権限プロンプトを構築します。
SDK でプログラム的に権限リクエストをトリガーします。
プロンプトを表示する前に通知センターにサイレント通知を表示します。
***
## ユーザーとサブスクリプション
SDK がアクティブになると、ユーザーがアプリを開くたびに OneSignal は自動的にユーザーとサブスクリプションレコードを作成します。
モバイルサブスクリプションは次の場合に作成されます：
* デバイスで初めてアプリを開く
* アプリをアンインストールして再インストールし、再度アプリを開く
各デバイスは個別のサブスクリプションを作成します。サブスクリプションは、`OneSignal.login` を介して[外部 ID](./users#external-id) を割り当てるまで匿名のままです。
ユーザーを管理し、外部 ID を割り当て、匿名ユーザーと識別済みユーザーを理解します。
サブスクリプションがデバイスとチャネル全体でどのように作成・管理されるか。
ターゲットメッセージングのためにユーザーを動的セグメントにグループ化します。
***
## プッシュ通知のデザイン
効果的なプッシュ通知を作成するには、テキストを書く以上のことが必要です。すべてのプッシュ通知を最大限に活用する方法をご覧ください。その後、以下のデザイン要素を確認してください。
1. [タイトル](./push#title)：注意を引く見出し（推奨：50 文字以内）
2. [メッセージ](./push#message)：メイン通知コンテンツ（推奨：120 文字以内）
3. [アイコン](./notification-icons)：ブランドアイコンまたは通知固有の画像
4. [大きな画像](./push#image)：目を引くビジュアルコンテンツ
5. [アクションボタン](./action-buttons)：行動を促すボタン
6. プッシュが受信されたときのタイムスタンプ
7. [アプリ名](./push#app-name)：アプリの名前
プッシュ通知の作成、オプション、配信動作の完全な概要。
一貫したメッセージングのために再利用可能なテンプレートで時間を節約します。
### パーソナライゼーションとローカライゼーション
汎用プッシュ通知を高パフォーマンスメッセージに変える方法をご覧ください。その後、以下のパーソナライゼーションオプションを確認してください。
名前や好みなどの動的変数を挿入してメッセージを調整します。
各ユーザーの優先言語でメッセージを自動的に配信します。
***
## プッシュ動作の設定
配信後の通知の動作を制御します。タイミング、表示設定、ユーザーのインタラクションが含まれます。
### 配信、表示、却下設定
大規模なオーディエンスに対する通知配信速度を制御します。
同じユーザーへの通知の過剰送信を防ぐために制限を設定します。
デバイスがオフラインのときにプッシュサービスがメッセージを保持する期間を定義します。
通知の混雑を減らすために前のメッセージを新しいものに置き換えます。
重要度レベル（バナー、サイレント）およびその他の表示方法を制御します。
iOS の優先度レベル（パッシブ、時間に敏感）を制御します。
各プラットフォームの通知オーディオを設定します。
iOS でアプリアイコンのバッジカウント動作を管理します。
### データとバックグラウンド通知
アプリが可視通知を表示せずに処理できるカスタムデータをプッシュペイロードに含めます。
視覚的な通知なしでカスタムペイロードを送信します。
アプリ内処理のためにプッシュペイロードにキーと値のデータを添付します。
### クリック動作とディープリンク
ユーザーが通知をタップしたときに何が起こるかを制御します。
ディープリンクとトラッキング URL を使用して、関連するコンテンツやページにユーザーをルーティングします。
プラットフォーム固有のディープリンク実装の詳細。
通知からユーザーがすぐにアクションを実行できるようにします。
クリックイベントをリッスンし、カスタムコードでアプリ内動作をトリガーします。
***
## 分析とトラブルシューティング
通知のパフォーマンスを測定し、一般的な配信の問題を解決します。
各メッセージの配信、開封率、クリックスルーメトリクスを表示します。
チャネル全体のエンゲージメントとユーザー行動メトリクスを探索します。
メッセージがデバイスに表示されない場合のトラブルシューティングチェックリスト。
プラットフォーム全体の画像レンダリングの問題を修正します。
重複通知が表示される理由をトラブルシューティングします。
***
## 次のステップ
実験でメッセージを最適化し、エンゲージメントを促進する要因を見つけます。
ユーザー行動によってトリガーされる自動化されたマルチステップメッセージングフローを構築します。
パーソナライゼーションとターゲティングのためにユーザーレベルのデータを追加します。
アプリ内でリッチでインタラクティブなメッセージでユーザーにリーチします。
***
## よくある質問
### ユーザーはプッシュ通知を受け取るためにオプトインする必要がありますか？
はい。iOS と Android はどちらも、プッシュ通知を受信する前にユーザーが権限を付与する必要があります。iOS では、システムプロンプトを表示する必要があります。Android 13+ では、`POST_NOTIFICATIONS` 権限が必要です。システムダイアログをトリガーする前に価値を説明するために、[事前権限プロンプト](./prompt-for-push-permissions)を使用してください。
### FCM、APNs、HMS、ADM とは何ですか？
これらはプラットフォーム固有のプッシュ配信サービスです。**FCM**（Firebase Cloud Messaging）は Android と Web に配信します。**APNs**（Apple プッシュ通知サービス）は iOS と macOS に配信します。**HMS**（Huawei Mobile Services）は Huawei デバイスに配信します。**ADM**（Amazon Device Messaging）は Amazon Fire デバイスに配信します。[SDK セットアップ](./mobile-sdk-setup)中に OneSignal ダッシュボードでそれぞれの認証情報を設定します。
### なぜプッシュ通知が表示されないのですか？
一般的な原因には、プラットフォーム認証情報の欠如または有効期限切れ、ユーザーが権限を付与していない、またはサイレントモードやフォーカスモードなどのデバイスレベルの設定があります。完全なトラブルシューティングチェックリストについては、[通知が表示されないまたは遅延している](./notifications-show-successful-but-are-not-being-shown)を参照してください。
### 可視通知なしでプッシュ通知を送信できますか？
はい。[データとバックグラウンド通知](./data-notifications)を使用して、アプリがサイレントに処理するカスタムペイロードを送信します。これらはバックグラウンド同期のトリガー、ローカルデータの更新、またはユーザーを中断せずにコンテンツを更新するのに役立ちます。