Configure Predefined Advertisements#

Predefined advertisements are static JPEG/JPG images that the Advertise Searcher (ASe) service stores in ChromaDB and returns when a matching product is detected. This guide explains how to provision products with predefined ads.

Prerequisites#

Ensure the application is deployed. See the Get Started guide.

Steps#

Prepare image assets: Create JPEG or JPG advertisement images and place them in web-ui/pre-defined-ads/.

Note: Only JPEG/JPG image formats are supported.

Update the product associations: Edit web-ui/ProductAssociations.csv and add or update rows for your products. Each row defines:

Column	Description
Product label	Detection label as it appears from PID (normalized to lowercase).
Price	Displayed price string.
Promo text	Short promotional description.
Slogan	Brand or campaign slogan.
Cross-sell target	Label of a related product to promote alongside.
Dynamic prompt	Text prompt used for AIG if no predefined ad is found.
Image filename	Filename (in `pre-defined-ads/`) to use as the predefined ad. Leave blank to always use dynamic generation.

Verify filenames match: Ensure image filenames in the CSV exactly match the files present in web-ui/pre-defined-ads/.
Redeploy the application:
```
make down
make up
```