Skip to main content
Buyer routing decides which Google Ad Manager advertiser a buyer’s spend books against when your storefront draws from a Google Ad Manager-backed embedded sales agent (ESA). Every incoming buyer resolves to exactly one GAM advertiser: a per-buyer mapping if one matches, otherwise the storefront’s default advertiser catch-all.
  • Default advertiser — the catch-all every unmatched buyer routes to. Set it once with PUT /esa/{esaId}/gam/default-advertiser. Until it is set, the Default GAM advertiser setup blocker stays open.
  • Per-buyer mappings — override the default for a specific buyer, keyed on operatorDomain (optionally narrowed by brandHouse, brandId, or principalId). A matching mapping wins over the default.
  • Recent buyers — the buyers the ESA has actually seen, with whether each resolved through the default or a specific mapping, so you can spot buyers that need their own advertiser.
GAM advertiser records are cached from the upstream network. List them to find the id you pass as the default or as a mapping target, or call ensure to create-or-find one by name. All examples use the storefront base URL: 
https://api.interchange.io/api/v2/storefront
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY. The {esaId} path parameter is the embedded sales-agent connection id.

​
Task reference

List GAM advertisers

GET /esa/{esaId}/gam/advertisers — cached advertiser records

Ensure GAM advertiser

POST /esa/{esaId}/gam/advertisers/ensure — create or find by name

Set default advertiser

PUT /esa/{esaId}/gam/default-advertiser — the catch-all advertiser

List buyer mappings

GET /esa/{esaId}/buyer-advertiser-mappings — per-buyer overrides

Create buyer mapping

POST /esa/{esaId}/buyer-advertiser-mappings — route one buyer

Update buyer mapping

PATCH /esa/{esaId}/buyer-advertiser-mappings/{mappingId} — edit a mapping

Delete buyer mapping

DELETE /esa/{esaId}/buyer-advertiser-mappings/{mappingId} — remove a mapping

List recent buyers

GET /esa/{esaId}/recent-buyers — buyers seen and how they resolved