はじめに
BigQuery は、Google Cloud Platform (GCP) で利用できるフルマネージドのサーバーレスデータウェアハウスです。インフラストラクチャを管理することなく、テラバイト規模のデータに対してリアルタイムで複雑な分析を実行できます。MoEngage <> BigQuery
MoEngage と BigQuery の連携により、ユーザーデータとイベントデータを Google BigQuery に直接転送し、高度な分析を行うことができます。
注: これは直接連携であり、データのエクスポートに Google Cloud Storage (GCS) は必要ありません。
連携
MoEngage から BigQuery へのイベントのエクスポート
ステップ 1: ユーザーに割り当てられたロールに必要な権限があることを確認する
BigQuery エクスポートを正常に設定して実行するには、実行するアクションに応じて、サービスアカウントまたはユーザーに次の権限が必要です。- 接続を作成する場合: MoEngage App Marketplace 内で新しい BigQuery 接続を確立するには、ユーザーに BigQuery Data Viewer ロールと BigQuery Job User ロールが必要です。これにより、MoEngage はプロジェクトとデータセットの詳細を検証できます。詳細については、こちらを参照してください。
- エクスポートを実行する場合: 実際のデータ転送を実行するには、サービスアカウントに BigQuery Data Editor ロールを割り当てる必要があります。これにより、MoEngage は特定の BigQuery テーブルに対してデータの読み取りと書き込みを行うために必要な権限を得られます。
ステップ 2: MoEngage App Marketplace で新しい BigQuery エクスポートを追加する
- イベントと属性の完全なリストについては、Data Exports Glossary を参照してください。
- エクスポートされたイベントの
event_timeは常に UTC です。 - MoEngage は現在、履歴データのエクスポートをサポートしていません。
- MoEngage UI の左側のナビゲーションメニューで、App marketplace をクリックします。
- App Marketplace ページで、BigQuery を検索します。
- Google BigQuery タイルをクリックします。
- Google BigQuery ページで、Integrate タブに移動し、+Add Export をクリックします。
- 次の詳細を入力します。
フィールド 必須 説明 Export name はい BigQuery エクスポートの名前を入力します。エクスポート名は 3 文字以上にしてください。 BigQuery connection はい BigQuery 接続を選択します。 Dataset ID はい データのエクスポート先となる BigQuery の特定のデータセットを選択します。 Table name 任意 エクスポートテーブルの名前を入力します。空白のままにすると、MoEngage が接頭辞 moe_events を付けた名前を作成します。
注: エラーを避けるため、このテーブルは MoEngage に自動作成させてください。User Properties 任意 エクスポートに含める特定のユーザープロパティを選択します。 Select events はい BigQuery にエクスポートするイベントを選択します。既存のイベントと MoEngage に新たに取り込まれるイベントを含むすべてのイベントをエクスポートするか、エクスポートする特定のイベントを手動で選択するかを選べます。 
- Save export をクリックします。
エクスポートのプロセスと頻度
エクスポートを保存すると、MoEngage はデータセット内に宛先テーブルを作成します。その後、新しいイベントデータが 1 時間間隔でこの同じテーブルに追加されます。 初回のアクション: MoEngage は、最初のエクスポートがトリガーされたときにテーブルを作成します。 定期的なアクション: MoEngage は 1 時間ごとに同じテーブルにデータを追加 (追記) します。テーブル構造のサンプル
エクスポート設定でテーブル名を指定しない場合、MoEngage は次の形式を使用してデータセット内に単一のテーブルを作成します。moe_events_<table_creation_timestamp>
注: このテーブルは接続ごとに 1 回作成されます。この接続で設定されたすべての 1 時間ごとのエクスポートと異なるイベントタイプは統合され、この特定のテーブルに追加されます。
テーブルの全体的な構造は、すべてのイベントタイプで固定されています。エクスポートされる新しいユーザープロパティまたはイベント属性は、それぞれ user_attributes 列または event_attributes 列に含まれます。すべてのイベントは、分析しやすいように、イベント名やイベント時刻などの必要な情報を含む単一のテーブルに統合されます。
よくある質問
データの受信はいつから始まりますか?
データの受信はいつから始まりますか?
通常、アカウントで自動データエクスポートが設定され、データが表示され始めるまでに最大 30 分かかります。
後から追加のイベントをエクスポートできますか?
後から追加のイベントをエクスポートできますか?
はい。後から新しいイベントをエクスポートする必要がある場合は、いつでも App Marketplace で設定を編集し、新しいイベントをエクスポートに追加できます。
Automated Data Exports を使用して履歴データをエクスポートできますか?
Automated Data Exports を使用して履歴データをエクスポートできますか?
現時点では、Automated Data Exports を使用して履歴データをエクスポートすることはできません。設定後、エクスポートを有効にした時点から各イベントのデータが表示され始めます。
Automated Data Exports に料金はかかりますか?
Automated Data Exports に料金はかかりますか?
ご利用の料金プランにまだ含まれておらず、後からこの機能を有効にする必要がある場合は、カスタマーサクセスマネージャーと協力して料金プランに含める必要があります。MoEngage が毎月データウェアハウス/パートナー/API に送信するデータ量によっては、追加料金が発生する場合があります。
Data Exports は最新のユーザー属性を保証しますか?
Data Exports は最新のユーザー属性を保証しますか?
いいえ。Data Exports は主にイベントをほぼリアルタイムでエクスポートするために構築されており、MoEngage のユーザー属性は非同期で更新されるため、現在のところエクスポートでユーザー属性の最新値を保証することはできません。