{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Real-time","type":"markdown"},"seo":{"title":"Lookup Catalog","description":"Learn how to use RT 2.0 Lookup Catalog to reference non-user-keyed business data — product catalogs, coupon definitions, sale schedules — in real-time personalization responses.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"lookup-catalog","__idx":0},"children":["Lookup Catalog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup Catalog"]}," enables RT 2.0 Personalization to reference external business data — such as product catalogs, coupon definitions, and sale schedules — at the moment a personalization request is made. Unlike profile attributes that store per-user values, Lookup Catalog data is keyed by a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["non-user dimension"]}," such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," and is queried in real time from RT 2.0's internal storage."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-lookup-catalog","__idx":1},"children":["When to Use Lookup Catalog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Lookup Catalog when the personalization response must include data that varies by product, SKU, coupon, or another non-user dimension:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return a sale banner that contains the specific discount rate and end date for the product currently being viewed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return a coupon reminder only when the user has a coupon applicable to the product they just added to the cart."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return product recommendation metadata keyed by the user's most recently viewed item."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your use case requires only per-user attributes (name, tier, purchase history), use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/real-time/real-time-attributes-overview"},"children":["Real-time Attributes"]}," instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-lookup-catalog-works","__idx":2},"children":["How Lookup Catalog Works"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n A[(\"cdp_lookup_catalog\\ndatabase\")] -->|Treasure Workflow\\nscheduled upload| B[(\"RT 2.0\\nInternal Storage\")]\n B -->|Queried on each\\np13n API call| C[Personalization Response]\n C --> D[Client / SDK]\n","diagramHtml":"

Treasure Workflow
scheduled upload

Queried on each
p13n API call

cdp_lookup_catalog
database

RT 2.0
Internal Storage

Personalization Response

Client / SDK

","diagramHtmlDark":"

Treasure Workflow
scheduled upload

Queried on each
p13n API call

cdp_lookup_catalog
database

RT 2.0
Internal Storage

Personalization Response

Client / SDK

"},"children":["flowchart TD\n A[(\"cdp_lookup_catalog\\ndatabase\")] -->|Treasure Workflow\\nscheduled upload| B[(\"RT 2.0\\nInternal Storage\")]\n B -->|Queried on each\\np13n API call| C[Personalization Response]\n C --> D[Client / SDK]\n"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A data engineer prepares lookup tables in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]}," database in Data Workbench and runs a Treasure Workflow sync workflow to push the data to RT 2.0's internal storage."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Audience Studio, a Lookup Catalog Attribute is created for the parent segment, linking the catalog table to a runtime lookup key (an RT attribute value)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When a personalization request arrives, RT 2.0 queries the matching row using the runtime key value and returns the column values as part of the offer payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The client renders the returned values — for example, the TD Web SDK renders Liquid-resolved HTML into a DOM zone or popup."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--prepare-lookup-catalog-data","__idx":3},"children":["Step 1 — Prepare Lookup Catalog Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A data engineer creates and maintains lookup tables in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]}," database in Data Workbench."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"database-and-table-conventions","__idx":4},"children":["Database and Table Conventions"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The database is typically named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]},". Any Plazma database can be used, but this name is the standard convention."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The primary key is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["first non-",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]}," column"]}," in the table — if the table's first column happens to be named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]},", the second column is used as the primary key instead. The primary key column must be unique, non-null, and of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additional columns can contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["array"]}," values (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},", etc.). Arrays of arrays (nested arrays) are not supported — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#limitations"},"children":["Limitations"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Column names in Lookup Catalog Attribute configuration use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plazma column name"]}," (not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryAs"]}," alias)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data must be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["deduplicated and normalized"]}," before upload — the workflow does not deduplicate."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"NULL key values cause upload failure"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rows where the primary key column is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NULL"]}," or empty will cause the sync workflow to fail with a 400 error. Ensure all rows have a valid, non-null key value before uploading."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-product-sale-table","__idx":5},"children":["Example: Product Sale Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A table ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limited_time_sale"]}," keyed by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"product_id"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["product_id"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"discount_rate"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["discount_rate"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"sale_end"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sale_end"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"banner_html"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["banner_html"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKU-12345"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026-07-31 23:59"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["
20% OFF — ends July 31
"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKU-67890"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["15"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026-08-15 23:59"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["
15% OFF — ends August 15
"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Sanitize HTML before storage"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a column stores raw HTML (as in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["banner_html"]}," above) and is rendered client-side via Liquid, make sure the source of that HTML is trusted and sanitized before it is ingested into the catalog table. Untrusted or user-generated HTML stored in a Lookup Catalog table can introduce an XSS risk when rendered in the browser."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-userproduct-coupon-table","__idx":6},"children":["Example: User–Product Coupon Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A table ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_product_coupon"]}," with a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["composite key"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," concatenated) for cart-level coupon lookups:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"user_product_id"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["user_product_id"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"has_coupon"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["has_coupon"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"coupon_code"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["coupon_code"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_001SKU-12345"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SAVE10"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_001SKU-67890"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FLASH15"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Composite key order matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a Lookup Catalog Attribute uses multiple lookup keys (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]},"), the runtime values are concatenated ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["without a delimiter"]},", in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["order the keys are defined"]}," in the attribute configuration (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_001"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKU-12345"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_001SKU-12345"]},"). The composite key stored in the table must match this exact concatenation — do not insert a delimiter between the parts, or lookups will fail to match."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"array-column-support","__idx":7},"children":["Array Column Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Columns with array types (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},", etc.) are fully supported. A row can have a mix of scalar and array columns."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"product_id"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["product_id"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"name"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["name"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"price"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["price"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"tags ( array )"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tags"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},") "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKU-12345"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Crew Tee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["29"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"sale\", \"tops\", \"new-arrival\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKU-67890"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Wide-leg Pants"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["58"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"sale\", \"bottoms\"]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Arrays of arrays are not supported"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Multi-dimensional arrays (arrays nested inside arrays) are not supported. Flatten nested structures before ingestion."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--upload-data-to-rt-storage","__idx":8},"children":["Step 2 — Upload Data to RT Storage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sync workflow reads from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]}," database and pushes changes to RT 2.0's internal storage via the Bulk Load API. Only records that have changed since the last run are uploaded (hash-based change detection)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The workflow automatically discovers all eligible tables in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]}," and syncs them on each run; set the optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p_table_name"]}," parameter to restrict a run to a single table (useful for testing). For setup instructions, parameter reference, and troubleshooting, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/real-time/lookup-catalog-workflow"},"children":["Lookup Catalog Sync Workflow"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Data freshness"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lookup Catalog data is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["batch-synced"]}," — it is not streaming. The data reflects the state at the last workflow execution. Design your sync schedule based on how frequently your catalog data changes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--create-a-lookup-catalog-attribute","__idx":9},"children":["Step 3 — Create a Lookup Catalog Attribute"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Audience Studio, add a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup Catalog"]}," attribute to the parent segment."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the parent segment in Audience Studio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RT Attributes"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Attribute"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup Catalog"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-a-lookup-catalog-attribute-2026-07-11.d373a7b776102acdaaa1a17635f338088c381c359ab47aea3e19d8bfb6f054e3.5b2238d2.webp","alt":"Add Attribute dialog with the Lookup Catalog tab selected, showing Name, System ID, Description, Lookup catalog table, Lookup columns, and Lookup keys fields"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the attribute fields:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"70%","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display name for the attribute (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_end_at"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["System ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal identifier used in Liquid templates and Entry Criteria (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_end_at"]},"). Auto-populated from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," but can be customized."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional description for internal documentation purposes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup catalog table"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select the table from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_lookup_catalog"]}," to use as the lookup source."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup columns"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select the columns to include in the response payload. Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plazma column name"]}," (not the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryAs"]}," alias)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup keys"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select the RT attribute type (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single-Value Attribute"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List Attribute"]},", etc.) and the specific attribute whose runtime value is used to look up rows. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add Lookup Key"]}," to add multiple keys for composite lookups. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order matters"]}," — keys are concatenated in the listed order to form the composite lookup key."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Composite key order"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For composite keys, define lookup keys in the same order as the key columns are concatenated in the catalog table. Mismatched order produces lookup misses."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Deleting a column after attribute creation"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a column is removed from the catalog table after a Lookup Catalog Attribute has been configured to reference it, the attribute configuration is not automatically updated. The offer response will simply stop returning that column's data after the next sync."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4--configure-entry-criteria-optional","__idx":10},"children":["Step 4 — Configure Entry Criteria (Optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lookup Catalog Attributes can be used in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Entry Criteria"]}," in Audience Studio to gate whether a personalization section is returned at all. This is server-side decision logic — the section and its entire payload are excluded from the API response when the condition is not met, so the client does not need to implement any conditional rendering logic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"setting-up-entry-criteria-in-audience-studio","__idx":11},"children":["Setting Up Entry Criteria in Audience Studio"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Audience Studio, open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personalization"]}," and navigate to the target section."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Entry Criteria"]}," canvas, drag and drop the Lookup Catalog Attribute you created into a condition slot."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the operator and value. For example, to return a section only when a coupon exists for the user–product combination:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Attribute: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_coupon"]}," → column: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_coupon"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Operator: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["=="]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Value: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"true\""]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When this condition is not satisfied at request time, the section is omitted entirely from the personalization response."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"No lookup_key required in the request"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," need to pass a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookup_key"]}," field in the API request. RT 2.0 automatically concatenates the runtime attribute values in the order defined in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lookup keys"]}," and queries the catalog data internally."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"operators-for-scalar-columns","__idx":12},"children":["Operators for Scalar Columns"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Operator"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operator"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"70%","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["=="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equal to a value"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["!="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not equal to a value"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<="]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[">"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[">="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric or timestamp comparison"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IS NULL"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IS NOT NULL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Null checks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Combine multiple conditions"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"operators-for-array-columns","__idx":13},"children":["Operators for Array Columns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a Lookup Catalog column is array-typed and the lookup key is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single-Value attribute"]}," (single-key lookup), the following operators apply:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operator"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operator"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"array_matching"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array_matching"]}]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"50%","data-label":"Semantics"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Semantics"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does any element in the array contain the substring?"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["In"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does the array contain any element exactly equal to one of the right-side values?"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["In"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do all elements in the array exactly equal one of the right-side values?"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array_matching"]}," is required when using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contain"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["In"]}," on an array column. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not: true"]}," flag inverts either operator."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"OR is not supported"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OR"]}," logic in Entry Criteria is not supported for Lookup Catalog Attributes in the current release. Use multiple sections with separate entry criteria if needed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4b--add-to-personalization-payload","__idx":14},"children":["Step 4b — Add to Personalization Payload"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To include Lookup Catalog Attribute values in the API response, add the attribute to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attribute Payload"]}," section of the Personalization configuration in Audience Studio."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Audience Studio, open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personalization"]}," section configuration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attribute Payload"]},", add the Lookup Catalog Attribute columns you want returned."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the configuration."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In M2, Lookup Catalog Attributes are treated as first-class attributes — they appear in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]}," sub-section of the response alongside Single, Counter, and List attributes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"personalization-api-response-structure","__idx":15},"children":["Personalization API Response Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a request matches the Entry Criteria, the response includes the Lookup Catalog Attribute values under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers..attributes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"offers\": {\n \"Coupon Reminder\": {\n \"attributes\": {\n \"product_coupon - has_coupon\": \"true\",\n \"product_coupon - coupon_ids\": \"CPN008\"\n },\n \"batch_segments\": null,\n \"td_app\": null\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the Entry Criteria condition is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," satisfied (for example, no coupon exists for that user–product combination), the section is omitted entirely:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"offers\": {}\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":16},"children":["Use Cases"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"limited-time-sale-banner","__idx":17},"children":["Limited-Time Sale Banner"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show an inline sale banner on a product detail page only while a sale is active for that specific product."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limited_time_sale"]}," table keyed by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["discount_rate"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_end"]}," columns."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a Lookup Catalog Attribute (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_info"]},") using a Single-Value RT attribute that stores the current ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," as the lookup key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Entry Criteria: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_info.discount_rate IS NOT NULL"]}," — the section is only returned when a sale row exists for this product."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cart-coupon-reminder","__idx":18},"children":["Cart Coupon Reminder"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show a coupon reminder when the user has a coupon applicable to the product they just added to the cart."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_product_coupon"]}," table with a composite key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]},") and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_coupon"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coupon_code"]}," columns."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a Lookup Catalog Attribute (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coupon"]},") with two lookup keys: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," first, then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," (RT attribute storing the most recently added product)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Entry Criteria: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coupon.has_coupon == \"true\""]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"interest-tag-personalization-array-column","__idx":19},"children":["Interest Tag Personalization (Array Column)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Display personalized tags based on a product's associated keywords stored as an array column."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_tags"]}," table with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," key and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keywords"]}," column of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a Lookup Catalog Attribute (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interest_tags"]},") using the current ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_id"]}," as the lookup key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally set Entry Criteria: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interest_tags.keywords Contain \"sale\""]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array_matching: any"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limitations","__idx":20},"children":["Limitations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"35%","data-label":"Limitation"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limitation"]}," "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"65%","data-label":"Detail"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Detail"]}," "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Batch sync only"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data is not updated in real time. Changes to the source table take effect only after the next sync workflow run."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No arrays of arrays"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multi-dimensional arrays (arrays nested inside arrays) are not supported. Flatten nested structures before ingestion."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key column constraints"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The primary key is the first non-",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]}," column in the table, must not contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NULL"]}," values, and must be of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schema changes require digest reset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If the primary key column is changed, the digest table (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_wf_{table_name}_digests"]},") must be dropped and recreated before the next workflow run. Previously uploaded data is not automatically deleted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sensitive lookup keys"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lookup keys marked as sensitive in Audience Studio cannot be used in client-side personalization requests. When a sensitive attribute is used as a lookup key, the entire section is redacted from the response for client-side requests."]}]}]}]}]}]},"headings":[{"value":"Lookup Catalog","id":"lookup-catalog","depth":1},{"value":"When to Use Lookup Catalog","id":"when-to-use-lookup-catalog","depth":2},{"value":"How Lookup Catalog Works","id":"how-lookup-catalog-works","depth":2},{"value":"Step 1 — Prepare Lookup Catalog Data","id":"step-1--prepare-lookup-catalog-data","depth":2},{"value":"Database and Table Conventions","id":"database-and-table-conventions","depth":3},{"value":"Example: Product Sale Table","id":"example-product-sale-table","depth":3},{"value":"Example: User–Product Coupon Table","id":"example-userproduct-coupon-table","depth":3},{"value":"Array Column Support","id":"array-column-support","depth":3},{"value":"Step 2 — Upload Data to RT Storage","id":"step-2--upload-data-to-rt-storage","depth":2},{"value":"Step 3 — Create a Lookup Catalog Attribute","id":"step-3--create-a-lookup-catalog-attribute","depth":2},{"value":"Step 4 — Configure Entry Criteria (Optional)","id":"step-4--configure-entry-criteria-optional","depth":2},{"value":"Setting Up Entry Criteria in Audience Studio","id":"setting-up-entry-criteria-in-audience-studio","depth":3},{"value":"Operators for Scalar Columns","id":"operators-for-scalar-columns","depth":3},{"value":"Operators for Array Columns","id":"operators-for-array-columns","depth":3},{"value":"Step 4b — Add to Personalization Payload","id":"step-4b--add-to-personalization-payload","depth":2},{"value":"Personalization API Response Structure","id":"personalization-api-response-structure","depth":3},{"value":"Use Cases","id":"use-cases","depth":2},{"value":"Limited-Time Sale Banner","id":"limited-time-sale-banner","depth":3},{"value":"Cart Coupon Reminder","id":"cart-coupon-reminder","depth":3},{"value":"Interest Tag Personalization (Array Column)","id":"interest-tag-personalization-array-column","depth":3},{"value":"Limitations","id":"limitations","depth":2}],"frontmatter":{"seo":{"title":"Lookup Catalog","description":"Learn how to use RT 2.0 Lookup Catalog to reference non-user-keyed business data — product catalogs, coupon definitions, sale schedules — in real-time personalization responses."}},"lastModified":"2026-07-11T07:05:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/real-time/lookup-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}