> ## 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.
# アプリ内メッセージの概要
> OneSignalアプリ内メッセージの開始方法：アプリ内キャンペーンのセットアップ、デザイン、トリガー、およびテストを行い、モバイルユーザーを効果的にエンゲージする方法。
アプリ内メッセージ（IAM）は、モバイルアプリ内に表示されるカスタマイズ可能なターゲットメッセージです。次のことができます：
* プッシュ通知への登録や位置情報の更新などのユーザーアクションを促す。
* ターゲットユーザーに新機能や未活用の機能を宣伝する。
* アプリの更新をリリースせずにリアルタイムでお知らせやニュースを表示する。
* アンケートやカルーセルを作成する。
* オンボーディングと教育コンテンツを支援する。
***
## アプリ内セットアップ
アプリ内メッセージを使用するには、アプリにOneSignal SDKをインストールする必要があります。完了すると、コードを書かずにOneSignalダッシュボードからアプリ内メッセージを作成して送信できます。SDKには、次のような高度なユースケース用のメソッドもあります：
* 特定の時間にメッセージをトリガーする
* クリック処理とディープリンク
* メッセージを一時停止する
* ライフサイクル管理など！
モバイルアプリのコードベースにOneSignalを追加します。
開発者向け：トリガー、クリックハンドラー、およびライフサイクルAPIにアクセスします。
ユーザーの動作またはアプリのアクティビティに基づいてメッセージが表示されるタイミングを制御します。
ユーザーがメッセージとインタラクションしたときに何が起こるかを定義します。
***
## アプリ内メッセージの送信
OneSignalダッシュボードおよびジャーニー内からアプリ内メッセージを送信できます。
OneSignalダッシュボードからアプリ内メッセージを作成して送信します。
自動化されたマルチステップおよびマルチチャネルフローを構築します。
### ダッシュボードから送信
**作成...** を選択してメッセージチャネルを選択します。**メッセージ** または **テンプレート** に移動して以前のメッセージを表示することもできます。
* [ブロックエディター](./design-your-in-app-message)または[HTMLエディター](./design-your-in-app-message-with-html)でゼロから始める
* 事前に作成された[テンプレート](./templates)を使用する
トラッキングとレポート用の内部メタデータを追加します。API相当: `name`
メッセージを受け取るユーザーを選択します。[セグメント](./segmentation)を含めたり除外したりして、特定のグループをターゲットにできます。セグメントが設定されていない場合、デフォルトはすべての「購読済みユーザー」です。
アプリ内メッセージは、プッシュオプトインステータスに関係なく、セグメント内のすべての[モバイルサブスクリプション](./subscriptions)に配信されます。ただし、メッセージにプッシュプロンプトの[クリックアクション](#click-actions)が含まれている場合、購読済み（オプトイン済み）のモバイルサブスクリプションには表示されません。
### メッセージのデザイン
ビジュアルなドラッグアンドドロップエディターまたはHTMLエディターを使用して、より細かく制御できます。
ビジュアルエディターを使用してメッセージをすばやく構築します。
開発者がメッセージをカスタマイズするための完全な制御。
テスト済みのレイアウトとキャンペーンから開始します。
HTMLメッセージにOneSignalのクリックアクションを追加します。
動的コンテンツを追加して、各ユーザーのメッセージをパーソナライズします。
グローバルオーディエンス向けにコンテンツをローカライズします。
### クリックアクション
ユーザーがメッセージ内の要素をクリックしたときに何が起こるかをカスタマイズします。
ユーザーがメッセージ内の要素をクリックしたときに何が起こるかをカスタマイズします。
メッセージとのインタラクションを追跡します。
モバイルSDKでクリックイベントに反応します。
クリック時にユーザーをナビゲートします。
### トリガー
アプリセッション中にメッセージを表示するタイミングを定義します。
4つのトリガータイプ：
ユーザーがアプリを起動したときにトリガーします。
アプリを開いてからX秒後に遅延します。
最後のアプリ内メッセージの後X時間遅延します。
SDK `addTrigger(s)`を介して制御されます。
#### このメッセージをいつ閉じるべきですか？
メッセージは次の場合に閉じることができます：
* ユーザーのインタラクション時（クリック、スワイプ）
* 設定された時間の後（自動閉じ）
### スケジュールと頻度
* **表示開始**：メッセージが対象になる時期
* **表示停止**：終了日時を設定するか「永久に表示」
#### このメッセージをどのくらいの頻度で表示しますか？
* **1回のみ**（デフォルト）
* トリガーが満たされる**毎回**
* カスタム繰り返しロジックで**複数回**：
例：
* **1時間**の間隔で**2回**表示
* **30日**の間隔で**12回**表示
***
## アプリ内メッセージの表示方法
アプリ内メッセージはアクティブにプッシュされません。代わりに、オーディエンスに基づいてアプリの起動時にプルされます。次に、トリガーロジックに基づいて表示されます。
メッセージは次の場合に表示されます：
1. ユーザーが**新しいセッション**が開始される*前に*オーディエンス基準を満たしている。
* **新しいセッション**は、ユーザーがアプリをバックグラウンドまたは閉じた状態で少なくとも30秒後に開いたときに開始されます。
* メッセージが公開されたときにユーザーがアプリを開いている場合、または同じセッション中にセグメントに入った場合、メッセージを表示する資格を得るには、少なくとも30秒間アプリをフォーカス外（閉じるかバックグラウンド）にする必要があります。
2. トリガー条件が満たされている。
3. スケジュールされた時刻と頻度が有効である。
セッション中にセグメント基準が変更された場合、ユーザーはメッセージを表示するためにアプリを再度開く必要があります。
### テスト
テスト中は、次のことを行うことをお勧めします：
アプリに[`setLogLevel`メソッドを`Verbose`に](./mobile-sdk-reference#setloglevel)追加して、より詳細なログを取得します。
上記の[アプリ内メッセージの表示方法](#how-in-app-messages-are-shown)で説明したように、ユーザーは**新しいセッションが開始される前に**オーディエンス基準に一致する必要があります。
* デバイスのサブスクリプションIDがわからない場合は、[デバイスの検索とテストユーザーの設定](./test-users)を参照してください。
* デバイスのサブスクリプションが含まれるセグメント内にあり、使用されている場合は除外されるセグメント内にないことを確認してください。
* **ヒント**：デバイスをテストサブスクリプションとして追加し、**テストユーザー**フィルターを含めるようにセグメントを作成または更新できます。
これにより、新しいセッションを作成してメッセージの資格を得るためにアプリを開いていることが保証されます。
メッセージが表示されるための[トリガー](#triggers)を満たしていることを確認してください。
* 「表示開始」と「表示停止」の日付が正しく設定されていることを確認してください。
* テスト中は、[「このメッセージをどのくらいの頻度で表示しますか？」](#schedule-%26-frequency)を「トリガー条件が満たされるたびに」に設定します。
* メッセージがアクティブになったら、デバイスでアプリを開くことができます。
* トリガー条件に基づいてメッセージが表示されるはずです。
#### テストとプレビューボタン
**テストとプレビュー**ボタンを使用すると、選択したテストデバイスにプッシュ通知が送信されます。プッシュをクリックしてアプリを開くと、アプリ内メッセージが表示されます。この機能を使用するには、次のことが必要です：
* デバイスが[テストユーザー](./test-users)であることを確認してください。
* プッシュ通知は**テスト目的でのみ送信されます**。メッセージが公開されているときはプッシュは送信されません。
* アプリを開いて「テストメッセージ」を送信できます。アプリ内メッセージが表示されます。
* タグ置換はテストアプリ内メッセージでは機能しません。
* メッセージが表示されない場合は、[テスト手順](#testing)に従っていることを確認してください。
* テストアプリ内メッセージを受信するには、デバイスがプッシュに登録されている必要があります。テストIAMはプッシュ通知によってトリガーされるため、サブスクリプションに無効なAPNsトークンがある場合、またはプッシュに登録されていない場合、テストは機能しません。
Need help?
Chat with our Support team or email `support@onesignal.com`
Please include:
* Details of the issue you're experiencing and steps to reproduce if available
* Your OneSignal App ID
* The External ID or Subscription ID if applicable
* The URL to the message you tested in the OneSignal Dashboard if applicable
* Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)
We're happy to help!
***
## チュートリアルとユースケース
タグを使用してアプリ内メッセージをパーソナライズするためのステップバイステップガイド。
ユーザーにアプリの更新を促します。
タイムリーなレビューリクエストで評価を高めます。
アプリ内でフィードバックを収集します。
プッシュオプトイン率を向上させます。
ユーザーに位置情報追跡を有効にするよう依頼します。
ユーザーがアプリの新機能を理解できるようにチュートリアルを設定します！
***
## 分析
メッセージのパフォーマンスとエンゲージメントを追跡します。
アプリ内メッセージのインプレッション、クリック、閉じる、コンバージョン指標。
OneSignalで利用可能なすべての分析オプション。
プッシュイベントをデータウェアハウスまたはBIツールにリアルタイムでストリーミングします。
***
## よくある質問
### アプリ内メッセージにはプッシュ通知の許可が必要ですか？
いいえ。アプリ内メッセージは、プッシュのオプトインステータスに関係なく、対象セグメント内のすべてのモバイル購読者に配信されます。アクティブなセッション中にアプリ内に表示されます。
### アプリ内メッセージが表示されないのはなぜですか？
最も一般的な原因は、ユーザーのセッションが更新されなかったことです。ユーザーはアプリを少なくとも30秒間閉じるかバックグラウンドに移動させ、再度開いて新しいセッションを開始する必要があります。また、ユーザーが対象セグメントに含まれており、トリガー条件が満たされていることを確認してください。完全なチェックリストについては、[テスト](#testing)を参照してください。
### APIを使用してアプリ内メッセージを送信できますか？
アプリ内メッセージはOneSignalダッシュボード内で作成する必要があります。
アプリ内メッセージを[Journeys](./journeys-overview)に含め、APIからトリガーされる[カスタムイベント](./custom-events)を通じてユーザーをJourneyに追加することができます。
### アプリ内メッセージとプッシュ通知の違いは何ですか？
アプリ内メッセージは、ユーザーがアプリを積極的に使用している間にアプリ内に表示されます。プッシュ通知はデバイスの通知トレイに表示され、アプリが閉じている場合でもユーザーに届きます。アプリ内メッセージはプッシュ許可を必要とせず、サーバーからプッシュされるのではなく、セッション開始時に取得されます。
### Webでアプリ内メッセージを使用できますか？
いいえ。アプリ内メッセージは、OneSignalモバイルSDKがインストールされたモバイルアプリのみで利用可能です。Webについては、代わりに[ウェブプッシュ通知](./web-push-setup)の使用をご検討ください。