Lookup Catalog

Lookup Catalog は、RT 2.0 パーソナライゼーションがリクエストを受け取った瞬間に、商品カタログ・クーポン定義・セールスケジュールなどの外部ビジネスデータを参照できる機能です。ユーザーごとの値を保持するプロファイルアトリビュートとは異なり、Lookup Catalog のデータは product_id のようなユーザー以外のディメンションをキーとして持ち、RT 2.0 の内部ストレージからリアルタイムに照会されます。

パーソナライゼーションのレスポンスに、商品・SKU・クーポン・その他のユーザー以外のディメンションによって異なるデータを含める必要がある場合に Lookup Catalog を使用します。

• 現在表示中の商品に対する割引率と終了日を含むセールバナーを返す。
• ユーザーがカートに追加した商品に適用できるクーポンを持っている場合のみ、クーポンリマインダーを返す。
• ユーザーが最後に閲覧したアイテムをキーとした商品レコメンドのメタデータを返す。

ユーザーごとのアトリビュート（氏名・ティア・購入履歴など）のみが必要な場合は、代わりに Real-time Attributes を使用してください。

1. データエンジニアが Data Workbench の cdp_lookup_catalog データベースにルックアップテーブルを作成・管理し、Treasure Workflow の同期ワークフローを実行して RT 2.0 の内部ストレージにデータをプッシュします。
2. Audience Studio で、ペアレントセグメントに Lookup Catalog Attribute を作成し、カタログテーブルをランタイムルックアップキー（RT アトリビュートの値）に紐付けます。
3. パーソナライゼーションリクエストが届くと、RT 2.0 はランタイムキーの値を使って対応する行を照会し、カラムの値をオファーペイロードの一部として返します。
4. クライアントが返された値をレンダリングします。たとえば TD Web SDK は Liquid が解決した HTML を DOM のゾーンやポップアップに描画します。

データエンジニアは Data Workbench の cdp_lookup_catalog データベースにルックアップテーブルを作成・管理します。

• データベースは通常 cdp_lookup_catalog という名前にします。任意の Plazma データベースを使用できますが、この名前が標準的な規則です。
• 主キーは、テーブル内で最初に現れる time 以外のカラムです。テーブルの先頭カラムが time という名前の場合は、2 番目のカラムが主キーとして使用されます。主キーカラムは一意で NULL でない値が必要で、型は string でなければなりません。
• その他のカラムには string、number、boolean、または array 型（array<string>、array<int> など）の値を含めることができます。配列のネスト（配列の中に配列がある構造）はサポートされていません。詳細は制限事項を参照してください。
• Lookup Catalog Attribute の設定でカラム名を指定する際は、Plazma のカラム名（queryAs エイリアスではない）を使用します。
• データはアップロード前に重複除去・正規化が必要です。ワークフローは重複除去を行いません。

product_id をキーとする limited_time_sale テーブル:

カートレベルのクーポン検索に複合キー（user_id + product_id を結合）を使用する user_product_coupon テーブル:

配列型（array<string>、array<bigint> など）のカラムは完全にサポートされています。1 行にスカラーカラムと配列カラムを混在させることができます。

同期ワークフローは cdp_lookup_catalog データベースから読み取り、Bulk Load API を通じて変更されたレコードのみを RT 2.0 の内部ストレージにプッシュします。変更検知にはハッシュベースの手法を使用します。

このワークフローは cdp_lookup_catalog 内の対象テーブルをすべて自動検出し、実行ごとに同期します。オプションの p_table_name パラメーターを設定すると、実行を単一テーブルに限定できます（テスト用途に便利です）。セットアップ手順・パラメーター一覧・トラブルシューティングについては、Lookup Catalog Sync Workflow を参照してください。

Audience Studio で、ペアレントセグメントに Lookup Catalog アトリビュートを追加します。

1. Audience Studio でペアレントセグメントを開きます。
2. RT Attributes の下で Add Attribute をクリックし、Lookup Catalog を選択します。

3. アトリビュートの各フィールドを設定します:

Lookup Catalog Attribute は Audience Studio のエントリー条件で使用でき、パーソナライゼーションのセクションを返すかどうかをサーバーサイドで制御できます。条件が満たされない場合、そのセクションとペイロード全体が API レスポンスから除外されるため、クライアント側に条件分岐ロジックを実装する必要はありません。

1. Audience Studio で Personalization を開き、対象のセクションに移動します。

2. Entry Criteria のキャンバスに、作成した Lookup Catalog Attribute をドラッグ＆ドロップして条件スロットに追加します。

3. 演算子と値を選択します。たとえば、ユーザー×商品の組み合わせでクーポンが存在する場合のみセクションを返すには:

   • アトリビュート: product_coupon → カラム: has_coupon
   • 演算子: ==
   • 値: "true"

リクエスト時にこの条件が満たされない場合、セクション全体がパーソナライゼーションレスポンスから除外されます。

Lookup Catalog のカラムが配列型で、ルックアップキーが Single-Value アトリビュート（単一キールックアップ）の場合、以下の演算子が適用されます:

配列カラムに対して Contain または In を使用する場合、array_matching は必須です。not: true フラグを指定するとどちらの演算子も反転します。

Lookup Catalog Attribute の値を API レスポンスに含めるには、Audience Studio の Personalization セクション設定で Attribute Payload にアトリビュートを追加します。

1. Audience Studio で Personalization のセクション設定を開きます。
2. Attribute Payload の下に、返したい Lookup Catalog Attribute のカラムを追加します。
3. 設定を保存します。

M2 では、Lookup Catalog Attribute はファーストクラスアトリビュートとして扱われ、Single・Counter・List アトリビュートと同様に レスポンスの attributes サブセクションに含まれます。

リクエストがエントリー条件を満たした場合、Lookup Catalog Attribute の値は offers.<section_name>.attributes の下に返されます:

{
  "offers": {
    "Coupon Reminder": {
      "attributes": {
        "product_coupon - has_coupon": "true",
        "product_coupon - coupon_ids": "CPN008"
      },
      "batch_segments": null,
      "td_app": null
    }
  }
}

エントリー条件が満たされない場合（例: そのユーザー×商品の組み合わせでクーポンが存在しない）、セクション全体が除外されます:

{
  "offers": {}
}

特定の商品にセールが設定されている場合のみ、商品詳細ページにインラインのセールバナーを表示します。

1. product_id をキーとし、discount_rate と sale_end カラムを持つ limited_time_sale テーブルを作成します。
2. 現在の product_id をルックアップキーとして保持する Single-Value RT アトリビュートを使用して、Lookup Catalog Attribute（sale_info）を作成します。
3. エントリー条件を設定します: sale_info.discount_rate IS NOT NULL — 該当商品のセール行が存在する場合のみセクションが返されます。

ユーザーがカートに追加した商品に適用できるクーポンを持っている場合、クーポンリマインダーを表示します。

1. 複合キー（user_id + product_id）と has_coupon、coupon_code カラムを持つ user_product_coupon テーブルを作成します。
2. ルックアップキーを 2 つ指定して Lookup Catalog Attribute（coupon）を作成します: まず user_id、次に product_id（最後に追加した商品を保持する RT アトリビュート）。
3. エントリー条件を設定します: coupon.has_coupon == "true"。

配列カラムに保存された商品に関連するキーワードを基に、パーソナライズされたタグを表示します。

1. product_id キーと array<string> 型の keywords カラムを持つ product_tags テーブルを作成します。
2. 現在の product_id をルックアップキーとして使用する Lookup Catalog Attribute（interest_tags）を作成します。
3. 任意でエントリー条件を設定します: interest_tags.keywords Contain "sale" （array_matching: any）。