Skip to main content
PUT /api/v2/storefront/esa/{esaId}/default-advertiser Sets the catch-all advertiser for an embedded sales agent. Every incoming buyer that has no matching per-buyer mapping routes to this advertiser. Setting it clears the Default GAM advertiser setup blocker. Call again with a different advertiserId to replace it. Available on Google Ad Manager and AdsWizz sources. The call is rejected for FreeWheel and SpringServe: SpringServe organizes demand as demand tags and has no advertiser to route to, and FreeWheel advertisers are not yet wired into Interchange. Each ad server keeps its default advertiser in its own place — Google Ad Manager on the tenant, AdsWizz on its adapter config — and this endpoint routes the write for you. The Google Ad Manager-only PUT /esa/{esaId}/gam/default-advertiser remains for existing integrations.

​
Request

​
Parameters

​
Response

advertiserId echoes the advertiser now serving as the catch-all for unmatched buyers.

​
Errors

  • 400 VALIDATION_ERROR — advertiserId is empty or over 64 characters, esaId is not a positive integer, or the ESA’s ad server does not support advertiser mapping (FreeWheel, SpringServe).
See Errors for the full error contract.

Buyer routing tasks

All buyer-routing operations

Buyer routing overview

How buyers resolve to advertisers

Ensure GAM advertiser

Provision a catch-all advertiser

Create buyer mapping

Override the default for one buyer