Overview
Buyer instructions let you tailor how your storefront responds to a specific buyer. Each row scopes a discount, freeform notes, and an optional country filter to a buyer identity. When a buyer’s request matches a row, the Interchange Merchandising Engine applies that row’s discount and notes while composing products for the response. A row is scoped by an(operatorDomain, brandDomain) tuple, which is unique per
storefront. The two fields combine into one of four shapes:
| Scope shape | operatorDomain | brandDomain | Applies to |
|---|---|---|---|
| House | null | null | Any buyer (your default) |
| House + brand | null | set | Any operator buying for this brand |
| Operator | set | null | This operator, any brand |
| Operator + brand | set | set | This operator buying for this brand |
The resolver picks the maximum
discountPercent across all matching rows.
Adding a brand-specific row only wins by being a better deal than the rows it
overlaps with.operatorDomain or brandDomain,
delete the
row and
create a
new one.
Fields
| Field | Type | Description |
|---|---|---|
operatorDomain | string | null | Operator (e.g. agency or DSP) the row applies to, or null to match any operator. 1–253 chars |
brandDomain | string | null | Advertiser brand the row applies to, or null to match any brand. 1–253 chars |
discountPercent | number | null | Discount percent off the storefront base price for matching buys. 0–100. null = no discount contribution |
notes | string | null | Freeform notes the Merchandising Engine applies to compositions for matching buyers. Max 2000 chars. null = no notes contribution |
countries | string[] | null | ISO 3166-1 alpha-2 codes (uppercase). Row applies only when the buy targets one of these countries. null = applies regardless of country |
Tasks
List buyer instructions
Read every row on the storefront.
Create buyer instructions
Add a new scoped row.
Update buyer instructions
Change discount, notes, or countries on a row.
Delete buyer instructions
Remove a row by id.
Related
Storefront overview
How buyer instructions fit alongside operating instructions.
Intelligence runs
See which rows matched and the effective discount applied per run.