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

このページでは、クラウドデータ取り込み（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 の例については、データウェアハウス統合を参照してください。
• ファイルベースの設定については、ファイルストレージ統合を参照してください。
• 同期の動作と最適化のガイダンスについては、クラウドデータ取り込みのベストプラクティスを参照してください。