Skip to main content

はじめに

MoEngage Event Exports を使用すると、さまざまなサードパーティツールにイベントを転送できます。次の機能を提供しています。
  1. MoEngage Streams - Streams を使用すると、MoEngage で利用可能なユーザーアクションやキャンペーンインタラクションイベントなどのイベントを、事前に定義した API エンドポイントにほぼリアルタイムで転送できます。
  2. Data Warehouses - MoEngage は、イベントをテーブルに直接転送する宛先として、複数のデータウェアハウスをサポートしています。サポート対象は次のとおりです。
    1. Amazon Redshift
    2. Google BigQuery (GCS 経由)
    3. Snowflake
  3. Cloud Storages - MoEngage は、イベントを JSON ファイルとしてバケットに転送する宛先として、複数のクラウドストレージもサポートしています。
    1. Amazon S3
    2. Google Cloud Storages
    3. SFTP

エクスポートスキーマ

エクスポートスキーマは宛先のタイプによって異なります。各カテゴリ (Data Warehouse、Cloud Storages、API) には、さまざまな MoEngage イベントとユーザー定義イベントに対応する一貫したスキーマがあります。

Streams (API)

MoEngage は、指定された API エンドポイントに Bulk API 呼び出しを行います。一般的な構造は次のとおりです。 JSON

スキーマ

イベントオブジェクトスキーマ

イベント属性オブジェクト

イベント属性は、エクスポートされるイベントによって異なる場合があります。どの属性がエクスポートされるかについては、以下のイベント定義を参照してください。

ユーザー属性オブジェクト

ユーザー属性は、設定によって異なる場合があります。どの属性がエクスポートされるかについては、以下のユーザープロパティの定義を参照してください。
  • moengage_user_id - この属性は常にエクスポートされます。これはユーザーの MoEngage 内部 ID です。

デバイス属性オブジェクト

デバイス属性は、設定によって異なる場合があります。どの属性がエクスポートされるかについては、以下のデバイスプロパティの定義を参照してください。
  • moengage_device_id - この属性は常にエクスポートされます。これはユーザーの内部デバイス ID です。

データウェアハウスの宛先

MoEngage はデータウェアハウスに単一のテーブルを作成し、選択したすべてのイベントをそのテーブルにエクスポートします。

Amazon Redshift

moengage_events という名前のテーブルを作成します。

Snowflake

moe_events_<table_creation_timestamp> という名前のテーブルを作成します。

テーブル構造

テーブルの全体的な構造は、すべてのイベントタイプで固定されています。エクスポートされる新しいユーザープロパティまたはイベント属性は、それぞれ user_attributes 列または event_attributes 列の一部になります。すべてのイベントは、分析しやすいように、イベント名やイベント時刻などの必要な情報をすべて含む単一のテーブルに格納されます。 次の一般的なスキーマに従います。
  • event_attributes_ で始まる列にはイベント属性が含まれます。その後に event_attributes_campaign_name のようにイベント属性名が続きます。
  • user_attributes_ で始まる列にはユーザー属性が含まれます。その後に user_attributes_moengage_user_id のようにユーザー属性名が続きます。
  • device_attributes で始まる列にはデバイス属性が含まれます。その後に device_attributes_moengage_device_id のようにデバイス属性名が続きます。
  • また、event_attributes、user_attributes、device_attributes という 3 つの JSON (または同等の) フィールドがあります。これらの各フィールドには、辞書形式の生の JSON フィールドが含まれます。

Google BigQuery (汎用)

MoEngage は、BigQuery Transfer File サービスを使用して、GCS バケット経由で BigQuery テーブルにイベントをエクスポートします。BigQuery でイベント用のテーブルを作成するには、次の 2 つの方法があります。
  1. エクスポートされたファイルのスキーマを使用して、エクスポートされたイベント専用のテーブルを作成する。
  2. 汎用スキーマを持つテーブルを作成する。
汎用スキーマを作成したいが、イベントがわからない場合は、次のスキーマを使用できます。 JSON

クラウドストレージの宛先

MoEngage は圧縮ファイルをクラウドストレージにエクスポートします。

汎用エクスポートスキーマ

  • ファイル形式: .json.gz
  • 解凍された各ファイルには、JSON 形式の改行区切りのイベントが含まれます (各行が 1 つのイベントです)。
  • 各ファイルには複数のタイプのイベントが含まれる場合があります。イベントのタイプごとに 1 つのファイルを作成するわけではありません。
  • イベントの JSON 形式は次のとおりです。
JSON

スキーマ

イベントオブジェクトスキーマ

イベント属性オブジェクト

イベント属性は、エクスポートされるイベントによって異なる場合があります。どの属性がエクスポートされるかについては、以下のイベント定義を参照してください。

ユーザー属性オブジェクト

ユーザー属性は、設定によって異なる場合があります。どの属性がエクスポートされるかについては、以下のユーザープロパティの定義を参照してください。
  • moengage_user_id - この属性は常にエクスポートされます。これはユーザーの MoEngage 内部 ID です。

デバイス属性オブジェクト

デバイス属性は、設定によって異なる場合があります。どの属性がエクスポートされるかについては、以下のデバイスプロパティの定義を参照してください。
  • moengage_device_id - この属性は常にエクスポートされます。これはユーザーの内部デバイス ID です。

Amazon S3

MoEngage は、S3 Exports の設定時に指定したフォルダ内に、事前に定義されたファイルパスを作成します。 ファイルは次の場所に格納されます。 s3://<your_bucket_name>/[<folder_path>_]<connection_name>/export_day=<DD-MM-YYYY>/event_exports_<export_timestamp>.json.gz

Google Cloud Storage

MoEngage は、GCS バケット内に事前に定義されたファイルパスを作成します。ファイルは次の場所に格納されます。 gs://<your_bucket_name>/event-exports/<your_app_name>/<connection_id>/export_day=YYYY-MM-DD/export_hour=HH/<file-name>.json.gz

SFTP

MoEngage は、SFTP サーバー上に事前に定義されたファイルパスを作成します。ファイルは次の場所に格納されます。 sftp://<your_host_name>/[<folder_path>/]<connection_name>/export_day=<DD-MM-YYYY>/event_exports_<export_timestamp>.json.gz

エクスポートされるイベント

MoEngage が追跡するすべての属性は moe_ で始まります。

ユーザー属性

デバイス属性

これらは、ユーザーのデバイスデータから導出されるプロパティです。これらの属性は、エクスポートではユーザー属性の下に表示される点に注意してください。

MoEngage (標準) イベント

MoEngage は、デフォルトでいくつかの標準イベントを追跡します。

共通イベント属性

これらの属性は、MoEngage が標準イベントを取得するときに自動的に追跡されます。

標準イベント

これらのイベントは MoEngage によって自動的に追跡されます。

ユーザー定義 (カスタム) イベント

共通イベント属性

これらの属性は、カスタム/ユーザー定義イベントを追跡するときに自動的に追跡されます。