Overview
MoEngageは、BigQueryデータベース内のテーブルからユーザープロフィールとイベントデータの両方を直接インポートできるようにします。この統合は、貴重な顧客データをMoEngageに取り込むプロセスを効率化し、セグメンテーションとエンゲージメントを向上させます。
輸入の種類
MoEngageは、あなたのBigQueryデータウェアハウスからの次のタイプのデータインポートをサポートしています:
- 登録ユーザー : MoEngageに既に登録されているユーザー。
- 匿名ユーザー : MoEngageにまだ登録していないユーザー。
- イベント (標準およびユーザー定義): MoEngage は、キャンペーンインタラクションイベントなどの標準イベントと、ユーザー定義またはカスタムイベントをインポートできます。
必要なアクセス許可
詳細については、 MoEngageに権限を付与する を参照してください。
データ型属性をインポート
データタイプ属性をインポートするには、追加の手順が必要です。詳細については、 こちら を参照してください。
BigQueryからのインポートを設定する
library_add_check |
前提条件
|
BigQueryインポートを設定するには、次の手順を実行します:
- MoEngage ダッシュボードの左側のナビゲーションメニューで、 データ > データインポート をクリックします。
-
右上隅の
+ インポート
をクリックし、
ユーザー
または
イベント
を選択して新しいインポートを作成します。
- クリックして Google BigQuery タイルを選択します。
-
クリックして
続行
します。
ステップ 1: ソースとフォーマット
このステップでは、BigQuery接続を構成し、ファイル形式を指定します。「 インポート名 」ボックスに、このインポートをインポートダッシュボードで簡単に識別できる名前を入力してください。
インポート名
選択したインポートの種類に基づいて、次のステップは異なる場合があります:
登録ユーザー、匿名ユーザー、または両方をインポートするかを選択できます。
ユーザータイプ
のセクションで、
登録ユーザー
または
匿名ユーザー
を選択します。両方のユーザータイプは異なるファイル名が必要です。詳細については、
命名規則
を参照してください。
イベントのインポートでは、
イベントを選択
リストからインポートしたいイベントを選択できます。
選択したイベントに応じて、ファイル名が異なります。ファイル名は、選択したイベントのイベント名で始まる必要があります。
イベントを選択
リストでは、MoEngageがアプリに利用可能なすべてのイベントの名前を表示します。イベントにマウスをホバーすると、MoEngageはその特定のイベントに期待されるファイル名を表示します:
既存のイベントを選択するか、新しいイベントを作成することができます。単一のテーブルに複数のイベントが保存されている場合、MoEngageは
イベント名
列に基づいてインポートする一致する行を決定します。
イベント名
列の値は、選択したイベントに依存します。これらのイベントのいくつかは、異なる表示名とイベント名を持っている場合があります。イベント情報は、
データ管理
ページで常に確認できます。たとえば、イベント
アプリ/サイトが開かれました
は、
イベント名
列の値を
MOE_APP_OPENED
として持つ必要があります:
新しいイベントを作成するには、次の手順を実行してください:
- リストの イベントを選択 の最後にある + イベントを作成 をクリックします。新しいイベントを 作成 するダイアログボックスが表示されます。
-
In the
イベント名
ボックスに、イベントのユニークな名前を入力してください。デフォルトでは、表示名はイベント名と同じになります。
このイベントや他のMoEngageイベントを表示または編集するには、 データ管理 ページに移動できます。
この最初のステップでは、 ソースとフォーマット として、使用するBigQuery接続とインポートするテーブルを指定する必要があります。始めるには、次のステップを実行してください:
-
この
BigQuery
の
接続
リストから、インポートに使用する接続を選択してください。
まだBigQuery接続を作成していない場合は、BigQuery接続リストの最後にある + 接続を追加 をクリックすると、セットアップのためにアプリマーケットプレイスにリダイレクトされます。あなたのBigQueryデータウェアハウスをMoEngageに接続する方法については、 こちら で詳しく学ぶことができます。 - BigQuery 接続を選択すると、 スキーマ/データセット と テーブル/ビュー のリストが表示されます。
-
In the
Schema/Dataset
リストで、スキーマ/データセットを選択します。
注意 : スキーマが正しく読み込まれない場合は、前提条件に記載されている必要な権限をMoEngageに付与したことを確認してください。 -
テーブル/ビュー
リストから、データをインポートするテーブル/ビューを選択します。
イベントインポート
上記のステップに加えて、MoEngageは複数のイベントを含むテーブルに対して追加のサポートを提供します。テーブルに複数のイベントが含まれている場合は、最初にプレビューを表示し、その後 テーブルに複数のイベントが含まれています チェックボックスを選択する必要があります。
MoEngageは、 Event_ Name 列の値を使用して、インポートする必要がある行をフィルタリングします。選択したイベント名と一致する行のみをインポートします。テーブル内の既存の列をイベント名列として指定できます。この列を選択してデータを再度プレビューした後、インポートを進める前にレビューのためにフィルタリングされた行が表示されます。
テーブルをプレビューした後、次のステップに進みます。 インポートの設定とアクション 。
ステップ2:設定とアクションのインポート
このステップでは、BigQuery接続とファイル形式を設定した後、データ列をMoEngage属性にマッピングする必要があります。 すべての列が一つずつ表示されます:
「 マップ列 」セクションには、次のものがあります:
- カラム名 : これはマッピングされるカラム名です(前のステップで取得したファイルの最初の行から選択)。カラム名の下には、MoEngageがサンプル値も表示します(前のステップで取得したファイルの2行目から選択)ので、参考にしてください。
- マップ列を属性に : どのMoEngage属性に列をマップするかを選択する必要があります。新しい属性を作成することもできます。いくつかの属性は複数のデータ型からの取り込みをサポートしているため、列のデータ型も選択する必要があります。「DateTime」列については、フォーマットも選択する必要があります。「DateTime」列については、 形式 を選択する必要があります。
- アクション : 任意で列をスキップすることができます。スキップされた列はインポートされません。
インポートの種類によって、いくつかの必須マッピングがあります:
マッピング | Description |
---|---|
ユーザー ID | あなたのテーブルには、システム内のユーザーアカウントを特定するために必要な一意のユーザー識別子を含む列を追加してください。 |
更新日時 |
MoEngageは、この列を使用して、最後の同期以来に追加または更新された行を特定します。このタイムスタンプ(日付+時間)がUTCタイムゾーンであることを確認する必要があります。この列の型は
サポートされている datetime フォーマットの完全なリストについては、この セクション を参照してください。 |
マッピング | Description |
---|---|
ユーザーID | この列は、MoEngageのユーザーIDをあなたのイベントに一致させます。 |
イベント時間 |
イベントが発生した日時(日時+時間)を含む列をマッピングすることを確認する必要があります。このタイムスタンプ(日付+時間)がUTCタイムゾーンであることを確認する必要があります。この列の型は
サポートされている日付時刻形式の完全なリストについては、この セクション を参照してください。 |
必須のマッピングがマークされると、マッピングテーブルの列名に反映され、もはやその列をスキップ可能としてマークすることはできません。
新しいイベントと同様に、新しいユーザー属性を作成することもできます。そうするためには:
-
「
+ 属性を作成
」を
属性を選択
リストからクリックします。
新しい属性を作成
ダイアログボックスが表示されます。
- 属性名 ボックスに、属性の名前を入力します。
-
「
データ型
」リストからデータ型を選択します。これらの属性や既存の属性は、
データ管理
ページから編集できます。
info 情報
新しく作成されたユーザー属性は、初回インポートが成功するまで データ管理 ページに表示されません。
マニフェストファイル
オプションとして、これらの列を自動的にマッピングするには、 マニフェストファイル をアップロードできます。マニフェストファイルをアップロードするには:
-
マッピングテーブルの右上にある
マッピングファイルをアップロード
をクリックしてください。
-
「
アップロードマッピング
」ダイアログボックスで、マニフェストファイルをアップロードします。
- 完了を クリック します。
あなたのマッピングは自動的に設定されています。MoEngage以外の属性を持つ列は空白のままにされており、列を手動でマッピングするか、新しい属性を作成することができます。マニフェストファイルが 期待される規約 に従っていることを確認してください。
マニフェストファイルにテーブルにない追加の列がある場合、それらは無視されます。また、既存のテーブル列のマッピングがマニフェストファイルに存在しない場合、MoEngageはマッピングを空白のままにしておくので、手動で設定できます。
info |
Information マニフェストファイルの列が存在しないMoEngage属性にマッピングされている場合、マッピングは空白になり、新しい属性をUIから手動で作成し、その後マッピングする必要があります。 |
オブジェクトデータ型のサポート
BigQueryでもObjectデータ型がサポートされています。
BigQueryに互換性のあるJSONデータを保存する
BigQuery に JSON データを格納するには、列のデータ型を VARIANT 型に変更する必要があります。詳細については、 こちら をご覧ください。BigQuery に格納されている JSON は有効な JSON でなければなりません。そうでない場合、値は JSON として書き込まれません。ここに例のJSONカラムがあります:
{ "Designation": "SSE", "Palace": "Banglore", "age": 30, "name": "Shasha" }
BigQueryを介してJSONデータをインポートする
MoEngageプラットフォームでオブジェクトタイプとして指定された既存の属性をBigQueryの列に関連付けることで、JSONデータをBigQueryにインポートできます。
新しいオブジェクト属性を作成するには、
属性を選択
リストの
属性をマップ
列の下にある
新しい属性を作成
をクリックします。
info |
Information MoEngage does not support mapping with nested attributes. Only top-level attributes are available to map. |
Save Users as a Segment
When importing users, you can include them in a custom segment in MoEngage. The imported users are consistently added to this segment with each sync, and no users will be removed. To save imported users as a custom segment, perform the following steps:
-
Turn the
Save as a custom segment
toggle on to save your imported users in a custom segment and send tailored campaigns to the same.
- In the セグメント名 ボックスに、セグメントの名前を入力してください。
- ユーザーIDの 列 リストで、テーブルの識別子列を選択してください。
インポート動作
ユーザーインポートの場合、既存のユーザーのみを更新することも選択できます。これは、新しいユーザーを作成することなく、MoEngageでユーザーの属性を一括更新したいときに便利です。これを有効にするには、 インポート動作 の下にある 既存のユーザーのみを更新 チェックボックスを選択します:
インポート通知を送信
インポートのステータスについてメールで通知を受け取ることを選択できます。そうするには:
- インポートステータスを送信する チェックボックスを選択してください。
-
In the
Select email id
list, select the email ID. You can select up to 10 emails to send the status emails to.
The import status email contains information about the following events:
- An import was created
- An import was successful
- An import failed
- After completing all mappings, click Next .
Step 3: Scheduling
In this step, you must define when to import files from your BigQuery server.
In this step, you must define when to sync with your tables. MoEngage supports the following types of imports:
- One-time imports : You can run the import as soon as possible or at a later date and time (scheduled).
- Periodic : You can run your imports hourly, daily, weekly, or monthly, or with intervals and advanced configurations.
For each run, MoEngage will try to fetch a file with the configured DateTime format , so ensure your file names are configured properly. Optionally, you can specify whether the import should end after a specified set of occurrences or at a particular date. Click Done when ready.
warning |
Warning Upon initial import, all matching rows from your table are imported. Subsequent imports only include changed rows. |
Duplicate Imports
A duplicate import is considered when the:
- Users/ Events import types are the same.
- Event name/ Registered/Anonymous/All users import subtypes are the same.
- Event name/ Registered/Anonymous/All users import types have the same BigQuery connection.
- Event name/ Registered/Anonymous/All users import types have the same Schema/Dataset and Table/View.
FAQ
BigQuery requires the column type to be
JSON
during table creation.
You can import
STRUCT
columns as Object Data Types in MoEngage. We will pull in the schema of your
STRUCT
and create a corresponding set of fields in MoEngage. It is not possible to cherry-pick or rename the individual fields within your struct columns when importing them into MoEngage.
MoEngage interprets stored time as UTC. BigQuery advises storing timestamps in UTC.
No. Currently, writing manual queries (to perform joins, and so on) is not supported. It is recommended that you create a dedicated table or view with all the columns you want to import to MoEngage.
Yes.私たちは、あなたのBigQueryビューからデータをインポートすることもサポートしています。MoEngageにViewsを読み取るアクセスを許可すると、それらは自動的にテーブル/ビューの選択ドロップダウンリストに表示されます。
はい。一度限りのインポートを作成することは、最初の同期で全ての行を取り込むため、基本的には履歴データをインポートすることと同じです。