クラウドデータ取り込みのテーブル設定

このページでは、クラウドデータ取り込み（CDI）がデータを読み取る方法を選択し、PAYLOAD 列を使用する場合にソーステーブルを設定する方法について説明します。

データ定義オプションの選択

データウェアハウスソースから同期を作成する場合、データ定義ステップでBrazeがデータを読み取る方法を選択します。表示されるオプションは同期タイプによって異なります。

テーブル設定とペイロードフォーマットの違いを理解する

PAYLOAD 列を使用する CDI ユーザーデータ同期では、以下の両方を設定します。

Braze はまずソーステーブルから行を読み取り、次に選択したデータ型に基づいて PAYLOAD フィールドを検証します。

ソーステーブルの設定

PAYLOAD 列を使用するデータウェアハウスのユーザーデータ同期では、ソーステーブルまたはビューに以下を含める必要があります。

• UPDATED_AT
• PAYLOAD
• 1つ以上のサポートされたユーザー識別子列:
  • EXTERNAL_ID
  • ALIAS_NAME および ALIAS_LABEL
  • BRAZE_ID
  • EMAIL
  • PHONE

テーブルに複数の識別子列が含まれている場合でも、各行には一度に1つの識別子タイプのみを含めてください。

UPDATED_AT の要件

• 夏時間の問題を避けるため、UPDATED_AT の値は UTC で保存してください。
• Brazeは、UPDATED_AT が最後に同期された値よりも後の行を同期します。
• 新しい行が同じタイムスタンプを共有している場合、境界のタイムスタンプの行が再同期されることがあります。

重複するタイムスタンプと増分更新のガイダンスについては、クラウドデータ取り込みのベストプラクティスを参照してください。

注

ファイルストレージソースは異なる設定要件を使用し、UPDATED_AT をサポートしていません。詳細については、ファイルストレージ連携を参照してください。

PAYLOAD 列の設定

PAYLOAD 値は、選択したデータ型に対して Braze /users/track エンドポイントで使用されるのと同じオブジェクト形式に従います。

階層化属性の場合、オブジェクトプロパティとしての日付のキャプチャに記載されている形式を使用して日付を含めてください。

ペイロードの例

• 階層化カスタム属性
• イベント
• 購入
• 購読グループ

1
2
3
4
5
6
7
8
9
10
11
12

{
      "most_played_song": {
        "song_name": "Solea",
        "artist_name": "Miles Davis",
        "album_name": "Sketches of Spain",
        "genre": "Jazz",
        "play_analytics": {
            "count": 1000,
            "top_10_listeners": true
        }
      }
}

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
    "subscription_groups" : [
        {
            "subscription_group_id": "subscription_group_identifier_1",
            "subscription_state": "unsubscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_2",
            "subscription_state": "subscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_3",
            "subscription_state": "subscribed"
        }
      ]
}

関連するCDI設定ドキュメント

• データウェアハウス連携ソース固有のDDLの例。
• ファイルストレージ連携ファイルベースのCDI設定。
• Cloud Data Ingestionのベストプラクティス同期の動作と最適化に関するガイダンス。