BigQuery インポート

Overview

MoEngageは、BigQueryデータベース内のテーブルからユーザープロフィールとイベントデータの両方を直接インポートできるようにします。この統合は、貴重な顧客データをMoEngageに取り込むプロセスを効率化し、セグメンテーションとエンゲージメントを向上させます。

輸入の種類

MoEngageは、あなたのBigQueryデータウェアハウスからの次のタイプのデータインポートをサポートしています:

  • 登録ユーザー : MoEngageに既に登録されているユーザー。
  • 匿名ユーザー : MoEngageにまだ登録していないユーザー。
  • イベント (標準およびユーザー定義): MoEngage は、キャンペーンインタラクションイベントなどの標準イベントと、ユーザー定義またはカスタムイベントをインポートできます。

必要なアクセス許可

詳細については、 MoEngageに権限を付与する を参照してください。

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

データタイプ属性をインポートするには、追加の手順が必要です。詳細については、 こちら を参照してください。

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

library_add_check

前提条件

  • MoEngageアプリマーケットプレイスで関連する権限を持つ BigQuery接続 が設定されていることを確認してください。
  • もしあなたのセキュリティポリシーが私たちのIPをホワイトリストに追加することを要求する場合は、 こちら を参照してください。
  • サポートのために オブジェクトデータタイプ を有効にする必要があります(オプション)。

BigQueryインポートを設定するには、次の手順を実行します:
  1. MoEngage ダッシュボードの左側のナビゲーションメニューで、 データ > データインポート をクリックします。
  2. 右上隅の + インポート をクリックし、 ユーザー または イベント を選択して新しいインポートを作成します。
  3. クリックして Google BigQuery タイルを選択します。
  4. クリックして 続行 します。

ステップ 1: ソースとフォーマット

このステップでは、BigQuery接続を構成し、ファイル形式を指定します。「 インポート名 」ボックスに、このインポートをインポートダッシュボードで簡単に識別できる名前を入力してください。

インポート名

選択したインポートの種類に基づいて、次のステップは異なる場合があります:

ユーザーインポート イベントのインポート

登録ユーザー、匿名ユーザー、または両方をインポートするかを選択できます。 ユーザータイプ のセクションで、 登録ユーザー または 匿名ユーザー を選択します。両方のユーザータイプは異なるファイル名が必要です。詳細については、 命名規則 を参照してください。

新しいイベントを作成するには、次の手順を実行してください:

  1. リストの イベントを選択 の最後にある + イベントを作成 をクリックします。新しいイベントを 作成 するダイアログボックスが表示されます。
  2. In the イベント名 ボックスに、イベントのユニークな名前を入力してください。デフォルトでは、表示名はイベント名と同じになります。
    CreateNewEvent.png

このイベントや他のMoEngageイベントを表示または編集するには、 データ管理 ページに移動できます。

インポート元

この最初のステップでは、 ソースとフォーマット として、使用するBigQuery接続とインポートするテーブルを指定する必要があります。始めるには、次のステップを実行してください:

  1. この BigQuery 接続 リストから、インポートに使用する接続を選択してください。
    まだBigQuery接続を作成していない場合は、BigQuery接続リストの最後にある + 接続を追加 をクリックすると、セットアップのためにアプリマーケットプレイスにリダイレクトされます。あなたのBigQueryデータウェアハウスをMoEngageに接続する方法については、 こちら で詳しく学ぶことができます。
  2. BigQuery 接続を選択すると、 スキーマ/データセット テーブル/ビュー のリストが表示されます。
  3. In the Schema/Dataset リストで、スキーマ/データセットを選択します。
    注意 : スキーマが正しく読み込まれない場合は、前提条件に記載されている必要な権限をMoEngageに付与したことを確認してください。
  4. テーブル/ビュー リストから、データをインポートするテーブル/ビューを選択します。

イベントインポート

上記のステップに加えて、MoEngageは複数のイベントを含むテーブルに対して追加のサポートを提供します。テーブルに複数のイベントが含まれている場合は、最初にプレビューを表示し、その後 テーブルに複数のイベントが含まれています チェックボックスを選択する必要があります。

MoEngageは、 Event_ Name 列の値を使用して、インポートする必要がある行をフィルタリングします。選択したイベント名と一致する行のみをインポートします。テーブル内の既存の列をイベント名列として指定できます。この列を選択してデータを再度プレビューした後、インポートを進める前にレビューのためにフィルタリングされた行が表示されます。

テーブルをプレビューした後、次のステップに進みます。 インポートの設定とアクション

ステップ2:設定とアクションのインポート

このステップでは、BigQuery接続とファイル形式を設定した後、データ列をMoEngage属性にマッピングする必要があります。 すべての列が一つずつ表示されます:

マップ列 」セクションには、次のものがあります:

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

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

arrow_drop_down ユーザーインポート
マッピング Description
ユーザー ID あなたのテーブルには、システム内のユーザーアカウントを特定するために必要な一意のユーザー識別子を含む列を追加してください。
更新日時

MoEngageは、この列を使用して、最後の同期以来に追加または更新された行を特定します。このタイムスタンプ(日付+時間)がUTCタイムゾーンであることを確認する必要があります。この列の型は TIMESTAMP であるべきです。

サポートされている datetime フォーマットの完全なリストについては、この セクション を参照してください。

arrow_drop_down イベントインポート
マッピング Description
ユーザーID この列は、MoEngageのユーザーIDをあなたのイベントに一致させます。
イベント時間

イベントが発生した日時(日時+時間)を含む列をマッピングすることを確認する必要があります。このタイムスタンプ(日付+時間)がUTCタイムゾーンであることを確認する必要があります。この列の型は TIMESTAMP であるべきです。インポートされたイベントの イベント時間 は、あなたのMoEngageダッシュボード設定で選択されたタイムゾーンに変換されます。

サポートされている日付時刻形式の完全なリストについては、この セクション を参照してください。

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

新しいイベントと同様に、新しいユーザー属性を作成することもできます。そうするためには:

  1. + 属性を作成 」を 属性を選択 リストからクリックします。 新しい属性を作成 ダイアログボックスが表示されます。
    CreateNewAttribute.png
  2. 属性名 ボックスに、属性の名前を入力します。
  3. データ型 」リストからデータ型を選択します。これらの属性や既存の属性は、 データ管理 ページから編集できます。
    info

    情報

    新しく作成されたユーザー属性は、初回インポートが成功するまで データ管理 ページに表示されません。

マニフェストファイル

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

  1. マッピングテーブルの右上にある マッピングファイルをアップロード をクリックしてください。
  2. アップロードマッピング 」ダイアログボックスで、マニフェストファイルをアップロードします。
  3. 完了を クリック します。

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

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

info

Information

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

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

BigQueryでもObjectデータ型がサポートされています。

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

BigQuery に JSON データを格納するには、列のデータ型を VARIANT 型に変更する必要があります。詳細については、 こちら をご覧ください。BigQuery に格納されている JSON は有効な JSON でなければなりません。そうでない場合、値は JSON として書き込まれません。ここに例のJSONカラムがあります:

JavaScript
{ "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:

  1. 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.
  2. In the セグメント名 ボックスに、セグメントの名前を入力してください。
  3. ユーザーIDの リストで、テーブルの識別子列を選択してください。

インポート動作

ユーザーインポートの場合、既存のユーザーのみを更新することも選択できます。これは、新しいユーザーを作成することなく、MoEngageでユーザーの属性を一括更新したいときに便利です。これを有効にするには、 インポート動作 の下にある 既存のユーザーのみを更新 チェックボックスを選択します:

インポート通知を送信

インポートのステータスについてメールで通知を受け取ることを選択できます。そうするには:

  1. インポートステータスを送信する チェックボックスを選択してください。
  2. In the Select email id list, select the email ID. You can select up to 10 emails to send the status emails to.
    ImportStatus.png

    The import status email contains information about the following events:

    • An import was created
    • An import was successful
    • An import failed
  3. 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

arrow_drop_down What should the BigQuery column data type be for JSON data to import successfully as an Object Data Type into MoEngage?

BigQuery requires the column type to be JSON during table creation.

arrow_drop_down How does MoEngage import STRUCT columns in BigQuery?

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.

arrow_drop_down How does MoEngage handle BigQuery TIMESTAMP columns containing local time zones instead of UTC during import?

MoEngage interprets stored time as UTC. BigQuery advises storing timestamps in UTC.

arrow_drop_down Can I import data across tables?

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.

arrow_drop_down BigQueryからのビューのインポートはサポートしていますか?

Yes.私たちは、あなたのBigQueryビューからデータをインポートすることもサポートしています。MoEngageにViewsを読み取るアクセスを許可すると、それらは自動的にテーブル/ビューの選択ドロップダウンリストに表示されます。

arrow_drop_down 過去のインポートはできますか?

はい。一度限りのインポートを作成することは、最初の同期で全ての行を取り込むため、基本的には履歴データをインポートすることと同じです。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています

How can we improve this article?