Marketing Sponsor Block - Search (Phase 2)

Feature Release

1. Related Keywords
   1. Overview: As a customer types in the search box, the suggestion dropdown now shows related keywords generated by the system.
   2. How it works:
      1. Generated automatically from search history and existing product names. For example, typing "nho" can suggest "nho xanh không hạt" or "nho khô".
      2. Only keywords that return results are shown. Customers are never led to an empty results page.
      3. Manual mappings still take priority. If an admin has set up related keywords for a term in Foxtrot (Search Config), those are shown instead of the automated ones. This lets campaign keywords keep priority.
         1. To promote specific keywords for a campaign, keep using the manual mapping in Search Config, which overrides the automated list.
2. Highlighted Brand
   1. Overview: A sponsored brand card now appears at the top of the search results when a customer searches for a keyword set up for that brand.
   2. How it works:
      1. The card shows the brand logo, a “Sponsored” label, the brand name and a call-to-action button (for example “Visit Shop”) that opens a destination chosen by the admin.
      2. Only 1 Highlighted Brand can show at a time. It stays at the top of the results regardless of the sort option (Sales, Newest, Price).
      3. If the brand has no logo in Foxtrot, a placeholder thumbnail is shown.
3. Hero Brand SKU
   1. Overview: A row of up to 4 sponsored products appears at the top of the search results for the same trigger keywords, so customers can add them to cart straight from search.
   2. How it works:
      1. Each card shows a grey “Sponsored” label, the product image, name, price, sale price and Sale badge (if on sale) and the ADD button.
      2. SKUs show in the order set by the admin and can come from any brand.
      3. Out-of-stock handling is per store. A SKU that is out of stock at the customer’s store is hidden and the others still show. If all SKUs are out of stock at that store, the whole block is hidden.
      4. Campaign badges and countdown timers are not shown on these cards.
4. How to set up (Foxtrot)
   1. Go to Pages and create a new page with the type Search Sponsored Result Page.
   2. Fill in the page details: Name, Status (Enabled/Disabled) and Start/End date.
   3. Add Trigger Keywords (1 to 20) and choose the Match type:
      1. Exact Match: triggers only when the customer types the keyword exactly (for example “shampoo” does not trigger on “baby shampoo”).
      2. Contains Match: triggers when the search contains the keyword (for example “shampoo”, “baby shampoo” and “shampoo clear” all trigger). Avoid very short keywords such as a single letter, because they trigger on many searches.
   4. In Content Builder, add Highlighted Brand (select the brand and set the button link and optional button text), Hero Brand SKU (search and add 1 to 4 SKUs, drag to reorder), or both. A page needs at least one.
   5. If more than one active page matches the same keyword, the page with the later start date is shown.
   6. If no active page matches the search, the search results page looks exactly as it does today.