> ## 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.

# ☁️ Data and Infrastructure

*(連携で、MoEngage と Snowflake などのデータウェアハウスやプラットフォームとの間で大量のデータを同期する場合は、この例を使用してください。)*

#### **\[Partner Name] と MoEngage の連携**

**作成者** : \[Your Company Name]\
**最終更新日** : \[Date]

*(貴社と事業内容について、2～3 文で簡潔に紹介してください。次に、MoEngage との連携の中核となる価値提案を説明してください。共通の顧客にとって、どのような重要な課題を解決しますか?)*

*例:*

**パートナー名** : \[Partner Name]

**パートナーカテゴリー** : データウェアハウス

# 概要 🚀

*(データの観点から連携の中核となる価値を説明してください。データのサイロ化の解消やユーザープロファイルの強化など、重要なビジネス課題をどのように解決するかを説明し、データフローが一方向か双方向かを記載してください。)*

MoEngage と **\[Partner Name]** の連携により、高品質なリアルタイムの顧客データを活用して統合されたユーザープロファイルを構築し、高度にパーソナライズされたエンゲージメントを促進できます。

**\[Partner Name]** から MoEngage に **\[データの種類。例: ユーザープロファイル、計算された属性、イベント]** をシームレスに転送することで、大がかりなエンジニアリング作業を必要とせずに、強力なマーケティングユースケースを実現し、セグメンテーションを強化し、スタック全体でデータの一貫性を確保できます。この連携は双方向のフローにも対応しており、MoEngage から充実したエンゲージメントデータを **\[Partner Name]** にエクスポートして、より詳細なビジネスインテリジェンスや分析に活用できます。

# ユースケース 🎯

*(この連携でユーザーが実現できる主な内容を 2～3 件挙げてください。具体的かつ行動指向で記述してください。)*

* **ウェアハウスのデータでユーザープロファイルを強化** : 顧客生涯価値 (CLV)、解約予測スコア、商品親和性モデルなどの計算された属性を **\[Partner Name]** から MoEngage に同期して、高度にターゲティングされたセグメントを作成し、キャンペーンをパーソナライズします。
* **ウェアハウスのイベントからジャーニーをトリガー** : 重要なイベント (例: サブスクリプションの更新、オフラインでの購入、サポートチケットのエスカレーション) を **\[Partner Name]** から MoEngage に送信して、あらゆるチャネルでリアルタイムかつコンテキストに応じたユーザージャーニーをトリガーします。
* **BI ツールでキャンペーンデータを分析** : MoEngage のキャンペーンインタラクションデータ (送信、開封、クリック、コンバージョン) を **\[Partner Name]** にエクスポートし、社内のデータセットと結合して 360 度のアトリビューションと ROI 分析を行います。

# 前提条件 ✅

*(ユーザーが設定を開始する前に準備しておく必要があるものをすべて挙げてください。必要に応じて、アカウントの種類やプランのレベルを明示してください。)*

* 有効な **MoEngage アカウント**。
* *\[例: ` Pro`、`Enterprise`]* プランの有効な **\[Partner Name] アカウント**。
* 両方のプラットフォームへの管理者アクセス権。
* **\[Partner Name]** ダッシュボードから取得した *\[例: ` API Key`、`Account ID` など]*。
* *(データウェアハウス連携の場合は、必要に応じて以下に具体的な認証情報と権限の手順を追加してください。)*
* データウェアハウス (例: Snowflake、Redshift、BigQuery) に MoEngage 専用の**サービスアカウントまたはデータベースユーザーを作成**します。
* サービスアカウント/ユーザーに**必要な権限/ロールを割り当て**ます。これには、MoEngage がインポート元とする特定のスキーマとテーブルへの `READ` アクセス権と、MoEngage がデータをエクスポートするスキーマへの `WRITE` アクセス権を含める必要があります。
* MoEngage で接続を設定するために必要となる、アクセストークンやサービスアカウントのキーファイル (例: BigQuery 用の JSON ファイル) などの**認証情報を生成して安全に保管**します。

# 連携の設定 🛠️

*(これは最も重要なセクションです。設定について、明確なステップバイステップのガイドを提供してください。貴社プラットフォームで必要な設定 (サービスアカウントの作成、権限の付与、認証情報の確認など) と、MoEngage での手順を詳しく説明してください。必要に応じて、スクリーンショットや貴社の詳細なドキュメントへのリンクを使用してください。)*

## ステップ 1: \[Partner Name] で MoEngage にアクセス権を付与する

MoEngage がデータをインポートまたはエクスポートする前に、貴社プラットフォーム内で専用のユーザー/ロールを作成し、必要な権限を付与する必要があります。

* **MoEngage 用のサービスユーザー/ロールを作成する** *(MoEngage 連携専用の新しいユーザーまたはロールを作成する方法を説明してください。例: 「\[Partner Name] ダッシュボードにログインし、Admin > Users に移動して、「Create New User」をクリックします。」)*
* **必要な権限を付与する** *(権限を付与するための正確な SQL コマンドまたは UI ベースの手順を記載してください。インポート用の READ アクセス権とエクスポート用の WRITE アクセス権について具体的に記載してください。*
* ***接続の認証情報を確認する***\_ (MoEngage での設定に必要なすべての認証情報をどこで確認できるかをユーザーに示してください。スクリーンショットを使用してください。)\_

## ステップ 2: \[外部プラットフォーム。例: Snowflake] での設定

1. 外部プラットフォームで必要な初期設定の手順を説明してください。これには、特定のアプリ、ビュー、または共有の設定が含まれることがよくあります。
2. 必要に応じて、このプロセスに関する貴社の詳細なドキュメントへのリンクを記載してください。

## ステップ 3: MoEngage での設定

1. 接続を完了するためにユーザーが MoEngage 内で行う必要がある手順を説明してください。
2. データのインポートとエクスポートを設定するためにユーザーが行う必要がある手順を説明してください。
3. 詳細に記述し、必要に応じてスクリーンショットを使用してください。

# トラブルシューティングとよくある質問❓

*(ユーザーが直面する可能性のある一般的な問題とその解決策を 2～3 件挙げてください)*。

*例:*

## 問題

**問題の例:** 増分同期で新規または更新されたレコードが取得されない。

* **「Last Updated」列を確認する**: 定期的な同期では、MoEngage は多くの場合、タイムスタンプ列 (例: `updated_at`) に基づいて新規または変更されたレコードを識別します。レコードが変更されるたびに、ソーステーブルでこの列の値が正しく更新されていることを確認してください。タイムスタンプが変わらない場合、MoEngage は更新を検出しません。
* **タイムゾーンの一貫性を確認する**: 増分同期に使用する `TIMESTAMP` 列が UTC で保存されていることを確認してください。MoEngage はすべてのタイムスタンプを UTC として解釈します。ソースデータがローカルタイムゾーンの場合、時差によって同期ウィンドウから外れ、最近更新されたレコードが取得されない可能性があります。
* **MoEngage で同期設定を確認する**: MoEngage のインポートジョブの設定を再確認してください。「Periodic Sync」を選択し、レコードの最終更新タイムスタンプを追跡する列を正しく指定していることを確認してください。

## よくある質問

> **JSON、STRUCT、ARRAY などの複雑なデータ型はインポート時にどのように処理されますか?**
>
> **\[動作を記載してください]**。例: 「JSON データを MoEngage の Object データ型として正常にインポートするには、\[Partner Name] のソース列が `JSON` 型または `VARIANT` 型である必要があります。STRUCT 列は MoEngage の Object フィールドに自動的にマッピングされます。

> **連携では TIMESTAMP 列や異なるタイムゾーンをどのように処理しますか?**
>
> **\[動作を記載してください]**。例: 「MoEngage はすべての `TIMESTAMP` データを UTC として解釈します。時間ベースのセグメンテーションとキャンペーンのトリガーを正確に行うため、ウェアハウス内のすべてのタイムスタンプ情報を UTC で保存することを強くお勧めします。

> **カスタム SQL クエリや複数のテーブルの結合を使用してデータをインポートできますか?**
>
> **\[動作を記載してください]**。例: 「JOIN を含むカスタム SQL クエリを直接記述することはサポートされていません。ベストプラクティスは、MoEngage にインポートするすべてのテーブルのすべてのフィールドを含む専用の `VIEW` を \[Partner Name] に作成することです。その後、このビューをデータソースとして選択できます。

> **連携は VIEW からのデータのインポートをサポートしていますか?**
>
> **\[動作を記載してください]**。例: 「はい、\[Partner Name] のテーブルとビューの両方をインポートのデータソースとして選択できます。

> **\[Partner Name] でソーススキーマが変更された場合 (例: 列の追加や削除) はどうなりますか?**
>
> **\[動作を記載してください]**。例: 「ソーステーブル/ビューに新しい列を追加した場合は、MoEngage でインポートジョブを手動で編集して新しいフィールドをマッピングする必要があります。列が削除されると、同期が失敗する可能性があります。インポートジョブを更新して、存在しないフィールドを削除してください。

> **1 回限りの履歴データのインポートを実行できますか?**
>
> **\[動作を記載してください]**。例: 「はい。履歴データをインポートするには、1 回限りの同期ジョブを設定できます。これにより、指定したテーブルまたはビューからすべての行が取得されます。継続的な同期では、連携はタイムスタンプ列に基づいて新規または更新された行のみを取得します。

> **問題が解決しない場合は誰に問い合わせればよいですか?**
>
> **\[Partner Name]** でのデータ設定や同期の失敗に関する問題については、**\[Partner Support Email/Link]** からサポートチームにお問い合わせください。MoEngage 内でのデータ処理やキャンペーン設定に関する問題については、カスタマーサクセスマネージャーにお問い合わせください。

# サポート 🤝

* **\[Partner Name]** に関する問題については、`[Partner Support Email or Link to Support Portal]` から当社のサポートチームにお問い合わせください。
* MoEngage プラットフォームに関する問題については、MoEngage サポートチームにお問い合わせください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.