Skip to main content

End-to-End Integration Flow: Sponsored Brand With Display

Overview​

Sponsored Brand With Display is a hybrid ad format that combines a single display/banner creative with dynamic product content. It is designed to blend brand visibility with product-level performance outcomes:

  • One display creative (brand message/visual).
  • A products array containing multiple products rendered alongside the creative.
  • Clicking a product directs the user to a product detail experience on the retailer platform.

This format may appear as "Sponsored Brand Display" or "Sponsored Display Brand" in some admin UIs and campaign-type selectors. They refer to the same format.

What's New in This Release​

If you already support Sponsored Display With Product, this integration is intentionally similar. The key differences are:

  • Ad Placement configuration requires explicit product-count rules — a minimum and a maximum number of products.
  • The ad response can contain multiple products (the products array length can be greater than 1).
  • Click event reporting requires product_id when multiple products are shown — this is the only change to the Events API payload. Not sending product_id does not invalidate the click itself; however, the click is then registered to the creative only.

Ad Placement Setup​

Create or Configure an Ad Placement​

Create (or configure) an Ad Placement representing the slot on your page/app where the ad will render. In some admin UIs this format may appear as "Sponsored Display Brand".

Key placement fields:

  • Format / Campaign Type: Sponsored Brand With Display.
  • Recommended sizes: the primary size you want advertisers to upload.
  • Accepted sizes: additional sizes that may be served in the same placement (optional but recommended).
  • Minimum Number of Products and Maximum Number of Products: both are optional. When set, the minimum must be at least 3 and the maximum cannot exceed 250.

Rendering Contract​

Your UI should render:

  • Exactly 1 display creative (e.g., image/banner).
  • N product tiles/cards, where N is derived from the placement configuration and the response payload.

Rendering should respect placement rules: render at most the maximum number of products, and aim to render at least the minimum when supply allows.

Enable Sponsored Brand With Display for a Marketplace​

There is currently no UI panel for enabling this format at the marketplace level. Activation is done by requesting it through our Customer Success Team.

Campaign Creation (Advertiser Workflow)​

Once the marketplace config is ACTIVE and the placement exists, advertisers can create campaigns for this format from the GoWit UI. The campaign form flow is aligned with Sponsored Display With Product:

  1. Create Campaign.
  2. Select campaign type "Sponsored Brand Display" (or "Sponsored Display Brand").
  3. Configure campaign settings (budget, dates, targeting).
  4. Add a creative (display/banner asset) and associate products (SKUs).

Products are shown according to the Ad Placement configuration (minimum and maximum products).

Ad Request and Ad Response (Ad Serving Integration)​

Endpoint​

Request creative ads each time a user visits a page where ads should appear:

POST /server/v2/ads

Request Guidance​

The request is identical to the existing ad request structure — the standard required fields still apply (marketplace_id, session_id, page_number, and the placements array). No format-specific fields are needed; putting the created Ad Placement's id in placements is what selects the Sponsored Brand With Display format.

Response Handling Requirements​

Sponsored Brand With Display responses are identical to the Sponsored Display With Product ad responses. The one critical difference is that they support multiple products. Each ad contains:

  • One creative (display asset).
  • A products array that can contain multiple products.
  • An ad_id that must be used for event reporting (impression/click).

For the full response schema, see the Ad Serving API — Get Creative Ads reference.

Event Reporting (Impressions and Clicks)​

Endpoint​

Report impression, click, and sale events to GoWit:

POST /server/events

Required Identifiers​

The usual parameters for the existing event reporting apply as-is.

Because Sponsored Brand With Display can show multiple products, click events must include product_id to indicate which product tile/card was clicked. This is the only change versus prior creative formats.

Note: It is good practice to make only products clickable during rendering and to include product_id on all clicks. Making the creative clickable without sending product_id will not register any click event on the rendered products (the click is attributed to the creative only).

Implementation Checklist​

Placement and Campaign​

  • Marketplace config for Sponsored Brand With Display is ACTIVE.
  • Placement is created with correct format, sizes, and (if set) minimum/maximum products (min ≥ 3, max ≤ 250).
  • Campaign exists with a creative and sufficient product SKUs.

Ad Serving​

  • Ad request is called on every eligible page/view with the correct placement IDs.
  • Response handling supports products arrays with multiple entries.
  • Rendering enforces placement minimum/maximum product rules.

Event Reporting​

  • Impression events include marketplace_id, event_type, session_id, and ad_id.
  • Click events include marketplace_id, event_type, session_id, ad_id, and product_id (for Sponsored Brand With Display).
  • Events are de-duplicated as needed to prevent double-reporting.

References​