# モバイルIn-App SDK連携の前提条件

iOSまたはAndroidアプリからモバイルIn-Appメッセージを取得・表示する準備をする場合に使用します。キャンペーン設定については、[モバイルIn-Appキャンペーンのセットアップ](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites)を参照してください。

Beta
ネイティブSDK連携はプレビューです。一般提供前に、API、ペイロード、パッケージ配布方法、イベントスキーマが変更される場合があります。

## 必要な値

SDK連携の前に、次の値を準備してください。

- イベント送信用の書き込み専用APIキー
- アカウントリージョンのRecordsエンドポイント
- Personalizationエンドポイント
- Personalization token
- トリガーイベント用のデータベースとテーブル
- メッセージを表示する画面または操作を識別するイベントスキーマ


書き込み専用APIキーとPersonalization tokenをメッセージコンテンツや`profileContext`に含めないでください。

## アプリ向けRealtime Personalizationを設定する

トリガーイベントをテストする前に、アプリ向けのRealtime Personalization設定を完了します。

1. アカウントで**Realtime Personalization 2.0**を有効化します。
2. モバイルアプリのイベントを受け取るRTイベントテーブルを設定します。
3. キャンペーンで統合された顧客IDが必要な場合、**IDスティッチング**を設定します。


Parent Segment、Realtime Personalizationエントリー、Personalization Sectionは、[モバイルIn-Appキャンペーンのセットアップ](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites)でキャンペーン担当者が作成します。

## トリガーイベントの契約を定義する

キャンペーンをトリガーできる画面または操作に到達したとき、アプリからイベントを送信します。イベント名、画面名、顧客識別子、ターゲティング属性は、Realtime Personalizationで設定した名前と一致させてください。

対応するイベント名前空間とフィールドについては、[Engage Mobile SDK APIとイベントリファレンス](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-reference)を参照してください。

SDKは`purchase`、`add_to_cart`、`search`などのビジネスイベントを推測しません。キャンペーンで使用する場合は、アプリからイベントを作成・送信してください。

## ネイティブSDK連携を導入する

受け取ったSDKアーティファクトに対応するプラットフォーム別ガイドを使用してください。

- [iOS SDK連携](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/developer-guide-ios)
- [Android SDK連携](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/developer-guide-android)
- [Hosted Pages WebViewとBridgeの連携](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/rich-landing-integration)


アプリでCore SDKを一度初期化し、Personalizationエンドポイントとtokenを設定してから、最初のトリガーイベントより前にプラットフォーム別の`TDEngage.install`を呼び出します。

## 連携を確認する

キャンペーンを作成する前に、次を確認してください。

- RTイベントが想定したテーブルに到着していること
- 顧客IDが想定どおり解決されていること
- Parent Segmentにテスト対象の顧客が含まれていること
- PersonalizationエントリーとSectionが有効で、アプリから利用できること
- テストイベントによってアプリがメッセージを取得すること
- Engage Mobile SDKがレスポンスを表示できること
- 一致するメッセージがないレスポンスをアプリが安全に処理できること


実装上の問題については、[モバイルIn-App SDKのトラブルシューティング](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-troubleshooting)を参照してください。

## 関連ドキュメント

- [モバイルIn-Appキャンペーンをセットアップする](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites)
- [Engage Mobile SDK APIとイベントリファレンス](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-reference)
- [モバイルIn-Appの計測](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/measurement)
- [モバイルIn-App SDKのトラブルシューティング](/ja/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-troubleshooting)