Overview

MoEngageは、顧客がSnowflakeデータベース内に保存されたテーブルを通じてユーザーとイベントをインポートできるようにします。

輸入の種類

MoEngageは、あなたのSnowflakeデータウェアハウスから以下をインポートできます:

1. 登録ユーザー : これらはMoEngageにすでに登録されているユーザーです。
2. 匿名ユーザー : これらは、まだMoEngageに登録されていないユーザーです。
3. イベント (標準およびユーザー定義): MoEngage は、キャンペーンインタラクションイベントなどの標準イベントと、独自のユーザー定義イベントをインポートできます。

データの準備

MoEngageはインポートのために特別なテーブルスキーマを準備する必要はありません。あなたのテーブルのすべての列は、MoEngage ダッシュボードでスキップするか、別々にマッピングすることができます。ただし、インポートを設定する前に注意すべき点がいくつかあります。

データ型属性のインポート

データタイプ属性のインポートには追加の手順が必要です。このことについては、私たちの 専用ガイド で詳しく学ぶことができます。

必要なアクセス権限

MoEngageは、MoEngageにデータを取り込むために、あなたのデータベースへの READ アクセスを必要とします。既存のデータベースユーザーにこれらの権限を付与するか、MoEngage専用の新しいデータベースユーザーを作成することを選択できます：

-- Grant SELECT permission on all tables in the schema
GRANT SELECT ON SCHEMA `catalog_name`.`schema_name` TO `user@example.com`;
-- Grant USE SCHEMA permission to access the schema
GRANT USE SCHEMA ON SCHEMA `catalog_name`.`schema_name` TO `user@example.com`;
-- Grant USE CATALOG permission (recommended for complete access)
GRANT USE CATALOG ON CATALOG `catalog_name` TO `user@example.com`;

次の値を変更することを忘れないでください:

1. <YOUR_WAREHOUSE_NAME> - MoEngageがクエリを実行する際に使用する倉庫の名前。
2. <YOUR_DATABASE_NAME> - インポートしたいデータベースの名前。
3. <YOUR_PASSWORD> - 新しく作成されたデータベースユーザーに強力なパスワードを設定してください。

Snowflakeからのインポートを設定する

MoEngage ダッシュボード > データ > データインポート から Snowflake インポートを設定できます。

クリックすると + インポート を選択してソースを選ぶことができます。Snowflakeをクリックして、ユーザー（次のステップで登録済み/匿名を選択できます）またはイベントの新しいインポートを作成します。

ステップ 1: Snowflake 接続とテーブルソースを選択します

インポート名

このインポートを識別しやすくするための名前を入力してください。 選択したインポートの種類に基づいて、次のステップは異なる場合があります:

Import Source

この最初のステップでは、 MoEngageに使用するSnowflake接続とインポートするテーブルを指定する必要があります。

始めるには、このインポートに使用するSnowflake接続を選択してください。まだSnowflake接続を作成していない場合は、ドロップダウンの最後にある「+ 接続を追加」オプションをクリックすると、設定するためにアプリマーケットプレイスに移動します。SnowflakeウェアハウスをMoEngageに接続する方法については、 こちら で詳しく学ぶことができます。

Snowflake 接続を選択したら、インポートするスキーマとテーブルを選択する必要があります。スキーマの読み込みにエラーが発生した場合は、 上記のように MoEngage に十分な権限を与えていることを確認してください。

イベントのインポート

上記の手順に加えて、MoEngageは複数のイベントを含むテーブルに対して追加のサポートを提供します。テーブルに複数のイベントが含まれている場合は、まずテーブルを「プレビュー」し、その後「 テーブルに複数のイベントが含まれています 」オプションを選択する必要があります。

MoEngageは「イベント名」列の値を使用して、インポートする必要がある行をフィルタリングします。選択したイベント名と一致する行のみをインポートします。テーブルの既存の列をイベント名を含む列としてマークできます。この列を選択して再度プレビューすると、確認のためにフィルタリングされた行を表示します。

テーブルをプレビューしたら、次のステップに進むことができます。

ステップ 2: あなたの列を MoEngage 属性にマッピングする

このステップでは、テーブルの列をMoEngageに存在する属性にマッピングする必要があります。すべての列が上下に表示されます：

1. カラム名 - これはマッピングされるカラム名です。カラム名の下には、参照用に（前のステップで取得したテーブルの最初の行から選ばれた）サンプル値も表示しています。
2. マップ属性 - ここでは、テーブルの列をマッピングするMoEngage属性を選択する必要があります。新しい属性を作成することもできます。いくつかの属性は複数のデータ型からの取り込みをサポートしているため、列のデータ型も選択する必要があります。「DateTime」列については、 フォーマット を選択する必要があります。
3. その他のアクション - 列をスキップすることを選択できます。スキップされた列はインポートされません。

インポートの種類によって、いくつかの必須マッピングがあります：

一度必須のマッピングがマークされると、マッピングテーブルの列名に反映され、その列をスキップ可能としてマークすることはできなくなります。

新しいイベントと同様に、ドロップダウンから「+ 属性を作成」をクリックすることで新しい属性を作成することもできます：

属性に名前を付け、そのデータ型を選択してください。このページでは、 データ管理 の既存の属性と同様に、これを編集できます。新しく作成した属性は、最初の成功したインポートの後にのみアプリで利用可能になることに注意してください。

マニフェストファイル

オプションで、これらの列を自動的にマッピングするために、 マニフェストファイル をアップロードすることができます。

マニフェストファイルをアップロードするには、マッピングテーブルの右上にある「マッピングファイルをアップロード」オプションをクリックしてください。

マニフェストファイルをアップロードし、完了をクリックしてください。あなたのマッピングは自動的に設定されます。MoEngage以外の属性を持つ列は空白のままとなり、列を手動でマッピングするか、新しい属性を作成することができます。マニフェストファイルが 期待される規約 に従っていることを確認してください。

マニフェストファイルに存在するが、テーブルにない追加の列は無視されます。また、既存のテーブル列のマッピングがマニフェストファイルに存在しない場合、MoEngageは手動で設定できるようにマッピングを空白のままにします。

マニフェストファイルの列が存在しないMoEngage属性にマッピングされている場合、そのマッピングは空白になり、まずUIから新しい属性を手動で作成してからマッピングする必要があります。

オブジェクトデータ型のサポート

Snowflakeでは、Objectデータ型もサポートされています。

Snowflakeに互換性のあるJSONデータを保存する

Snowflake内で有効なJSONを保存するには、列のデータ型を VARIANT 型に変更する必要があります。詳細については、 こちら を参照してください。Snowflakeに保存されているJSONは有効なJSONである必要があります。そうでない場合、値はJSONとして書き込まれません。ここに例のJSON列があります:

{ "Designation": "SSE", "Palace": "Banglore", "age": 30, "name": "Shasha" }

Snowflakeを介してJSONデータをインポートする

MoEngageで オブジェクト タイプとしてマークされ、Snowflakeの列にマッピングできる既存の属性:

マッピングステップから新しいオブジェクト属性を常に作成できます。以下に示すように:

セグメントとして保存

ユーザーをインポートする場合、MoEngage内のカスタムセグメントに追加することもできます。同期が実行されるたびに、インポートされたユーザーはこのカスタムセグメントに追加され続けます。このセグメントからユーザーを削除することはありません。このセグメントに対してターゲットを絞ったキャンペーンを送信できます。インポートしたユーザーをカスタムセグメントに保存するには、「カスタムセグメントとして保存」オプションを有効にしてください：

セグメントに名前を付け、テーブルの識別子列を選択してください。

インポートの動作

ユーザーインポートの場合、既存のユーザーのみを更新することも選択できます。これは、MoEngageで新しいユーザーを作成することなく、ユーザーの属性を一括更新したいときに役立ちます。これを有効にするには、インポート動作の下にある「既存のユーザーのみを更新」オプションをチェックしてください。

インポート通知の送信

インポートのステータスについて、オプションとしてメールで通知を受け取ることができます。ステータスメールを送信するために、最大10件のメールを選択してください。次のイベントに関するメールを受け取ります：

1. インポートが作成されました
2. インポートが成功しました
3. インポートに失敗しました

すべてのマッピングに満足したら、次へクリックしてください。エラーがあれば、修正して前に進みましょう。

ステップ 3: インポート頻度を選択

このステップでは、テーブルと同期するタイミングを定義する必要があります。次のタイプのインポートをサポートしています：

1. 一度きりのインポート: すぐにインポートを実行するか、後で日付と時刻を指定して実行することができます（スケジュール設定）。インポート条件に一致するすべての既存の行がインポートされます。
2. 定期的: インポートを数分ごと、毎時、毎日、毎週、または毎月、またはインターバルや高度な設定で実行することを選択できます。

オプションで、指定された発生回数のセットの後、または特定の日付でインポートを終了するかどうかを指定できます。準備ができたら 完了 をクリックしてください。

重複インポート

一度に1つのユニークなインポートのみを設定できます。インポートは、 これらすべて が同じである場合、重複したインポートと見なされます：

1. インポートタイプ - ユーザー / イベント
2. インポートサブタイプ - イベント名 / 登録済み / 匿名 / すべてのユーザー - イベント名が同じ場合、または同じSnowflake接続を持つ登録済み/匿名/すべてのユーザーのインポートがすでに存在する場合
3. スノーフレーク接続
4. インポートスキーマ＆テーブル

上記のいずれかが異なる限り、インポートはユニークと見なされます。

よくある質問