> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Connected Apps
[YouTube 動画プレーヤー](https://www.youtube.com/embed/uWCX6u4Lhrk)
Connected Apps は、外部プラットフォームを MoEngage のカスタマーエンゲージメントエコシステムと連携させるための、MoEngage のローコードフレームワークです。このガイドでは、**MoEngage からお客様のプラットフォームへ**データを送信する連携である **Connected Channel** の構築手順を説明します。
> [!NOTE]
>
> **📌 別の方法をお探しですか?**
>
> ユースケースが MoEngage **へ**データを送信するもの (CRM の同期、イベントトラッキング、フォームの送信など) である場合は、代わりに **Connected Sources** が必要です。利用を開始するには、[お問い合わせください](mailto:partnerships@moengage.com)。
## Connected Apps で構築する理由
MoEngage App Marketplace は、250 社以上のテクノロジーパートナーで構成される厳選されたエコシステムです。Connected Apps は、このエコシステムに参加するための最速の手段です。
> **市場リーチの拡大**
>
> App Marketplace に掲載することで、MoEngage の大規模な顧客基盤での認知度を高められます。
> **新たな収益源**
>
> サブスクリプション、トランザクション、またはコネクター料金を通じて収益化できます。
> **市場投入の迅速化**
>
> 合理化された連携プロセスにより、ソリューションをより早く市場に投入できます。
> **開発コストの削減**
>
> ローコードフレームワークにより、あらゆる規模のチームが連携を構築してデプロイできます。
## Connected Apps の種類
Connected Apps には 2 種類の連携タイプがあります。このガイドでは **Connected Channels** について説明します。Connected Sources が必要な場合は、[Connected Sources ガイド](/docs/ja/partner-guide/integrate-with-us/build-integration/connected-sources)を参照してください。
> ↑
>
> ## Connected Channels
>
> このガイド
>
> MoEngage がお客様のプラットフォーム**へ**データを送信します。メッセージング、広告、サポートツールに最適です。
>
> 
> ↓
>
> ## Connected Sources
>
> spacer
>
> お客様のプラットフォームが MoEngage **へ**データを送信します。CRM、e コマース、フォームツールに最適です。
>
> 
Connected Channels は、メッセージングチャネル、広告およびリターゲティングプラットフォーム、IVR システム、サポートツール、チャットボットなど、幅広いプラットフォームをサポートしています。
# Connected Channel の構築
> [!NOTE]
>
> **前提条件**
>
> MoEngage Partner Sandbox で Connected Apps が有効になっていることを確認してください。App を作成するオプションが表示されない場合は、[お問い合わせください](mailto:partnerships@moengage.com)。
## ステップ 1: 始める前に — 主要な用語
構築を始める前に、主要な概念を理解しておきましょう。各要素は次のように組み合わされています。
| 用語 | 説明 | 例 |
| :- | :- | :- |
| **Connected App** | MoEngage からデータを送信する外部のサードパーティアプリケーションまたはツールです。メッセージングアプリケーション、広告またはリターゲティングプラットフォーム、あるいはマーケティングテクノロジースタック内の社内ツールなどが該当します。 | - **メッセージングアプリケーション:** Telegram、Line、Viber
- **広告/リターゲティングプラットフォーム:** Snapchat Ads、Pinterest Ads、Criteo Ads
- **サポートツール:** Freshdesk、Zendesk
*注: ここに記載されている例は説明用であり、現在 MoEngage でサポートされていない場合があります。現在サポートされているアプリケーションの完全な一覧については、[サポートされている Connected Channels のセクション](https://www.moengage.com/docs/user-guide/campaigns-and-channels/connected-apps/getting-started-with-connected-apps/overview#supported-connected-channels)を参照してください。* |
| **Connected Channel** | MoEngage から外部の顧客インタラクションプラットフォームにデータを送信できる、MoEngage の Connected App 連携の一種です。 | **メッセージングアプリ** **リターゲティング** - TikTok Ads
- Criteo Ads
- Snapchat Ads
- Pinterest Ads
|
| **Channel Connector** | MoEngage キャンペーンを Connected App とどのように連携させるかを定義する特定の設定です。各コネクターは連携先の特定の API にリンクし、特定のユースケースに対応します。 | Criteo Ads の Connected Channel には通常、次の 2 つのコネクターがあります。 - カスタマーリストにユーザーを追加する。
- カスタマーリストからユーザーを削除する。
|
| **Connection** | Connected Channel の Channel Connector を連携させると、MoEngage は Connection を作成します。MoEngage プラットフォーム内で識別しやすいように、新しい接続に名前を付けることができます。 | 2 つの異なる Criteo Ad アカウント (Business A 用と Business B 用) を使用している場合は、次のように別々に接続します。 - Criteo Business A
- Criteo Business B
|
> [!NOTE]
>
> **💡 参考情報**
>
> MoEngage での [Connector Campaigns](https://www.moengage.com/docs/user-guide/campaigns-and-channels/connectors/create/create-a-connector-campaign) の仕組みを理解しておいてください。Connected Apps はこのユーザージャーニーにほぼ沿っています。また、既存の [Connected Channels](https://www.moengage.com/docs/user-guide/campaigns-and-channels/connected-apps/getting-started-with-connected-apps/overview#connected-channels) を参照して、このプラットフォーム上に構築された連携を確認することもできます。
***
## ステップ 2: MoEngage で App を作成する
まず、App Marketplace で [App を作成](/docs/ja/user-guide/campaigns-and-channels/connected-apps/getting-started-with-connected-apps/create-an-app)します。
1. MoEngage ダッシュボードで **App Marketplace** に移動します。
2. 右上隅にある **+ Create app** ボタンをクリックします。
3. ダイアログボックスで次の操作を行います。
* 一意の **App name** を入力します。
* **App type** として **Channel** を選択します。
* **Create** をクリックします。
これで App が作成されました。次に、コネクターを追加してユースケースを定義します。
***
## ステップ 3: コネクターを作成する
連携がサポートする各ユースケースは、**Connector** として定義されます。1 つの App に複数のコネクターを持たせることができます。たとえば、メッセージングアプリには、SMS の送信、MMS の送信、グループへのメッセージ送信のための個別のコネクターを用意できます。
各 Connector には、独自の **JSON 設定ファイル**が必要です。これは、特定のユースケースにおいて MoEngage がお客様の App とどのようにやり取りするかを指示する設計図です。
***
## ステップ 4: 設定ファイルを作成してアップロードする
JSON 設定ファイルは、コネクターの中核です。MoEngage がお客様の API とどのようにやり取りするか、ユーザーからどのような入力が必要か、レスポンスをどのように処理するかを指示します。
### 1. ファイルを作成する
包括的なヘルプドキュメントでは、このファイルを作成するための詳細なステップバイステップガイドを、例やベストプラクティスとともに提供しています。
📘 [**完全なガイドを読む: Channel Connector 設定ファイルを作成する**](/docs/ja/user-guide/campaigns-and-channels/connected-apps/getting-started-with-connected-apps/create-a-channel-connector-config-file)
### 2. ファイルをアップロードする
JSON 設定ファイルの準備ができたら、次の操作を行います。
1. MoEngage App Marketplace の App ページに戻ります。
2. **Configure** タブをクリックします。
3. **+ Add configuration** をクリックします。
4. JSON ファイルをアップロードします。検証エラーがある場合は、システムから通知されます。
5. アップロードが成功したら、**Add** をクリックします。
これでコネクターが作成されました。追加の設定ファイルを作成してアップロードすることで、App にさらにコネクター (ユースケース) を追加できます。
***
## ステップ 5: 連携をテストする
スムーズなユーザーエクスペリエンスを実現するには、徹底的なテストが不可欠です。次の 3 つのサブステップに従って、連携をエンドツーエンドで検証します。
### 5.1: 接続を作成する
1. App ページで **Integrate** タブに移動します。
2. **+ Add integration** をクリックします。
3. 接続に一意の **Connection name** (例: 「My Test Connection」) を付けます。
4. App Marketplace スコープで定義した入力変数に値を入力します。
5. **Connect** をクリックします。
### 5.2: テストキャンペーンを実行する
1. MoEngage で新しいキャンペーン (例: 1 回限りのプッシュキャンペーン) を作成します。
2. キャンペーンの作成プロセスで、新しい Connected Channel を選択します。
3. 前のステップで作成した **Connection** を選択します。
4. キャンペーン固有の入力変数に値を入力します。
5. テストセグメントに対してキャンペーンを開始します。
### 5.3: キャンペーンの統計情報を確認する
1. キャンペーンのパフォーマンスページを確認します。
2. 「Sent」と「Failed」の数値が、キャンペーン中に受け取った API レスポンスを反映していることを確認します。たとえば、テストで 10 件のメッセージを送信し、すべてが 200 OK レスポンスを受け取った場合は、「Sent」イベントが 10 件表示されるはずです。
***
# 公開のための App の提出
連携が正しく動作するようになったら、レビューに提出します。
### 提出方法
MoEngage のパートナーマネージャーに連絡して、App のレビューの準備ができたことを伝えてください。当社のチームが設定をレビューし、公開に向けてお客様と協力して作業を進めます。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.