Skip to main content

SPAAd

A single sponsored product ad returned in a placement response. Carries the product identifiers and the FCC Ad Manager tracking URLs for the ad.

positionintegerrequired

The relative position of the ad in the response. This position begins with the offset of the ad request. Earlier positions indicate more relevant ads.

skustringrequired

The sku id (listing id) of the sponsored product ad.

Example: 7109947_123
product_idstringrequired

The product id of the sponsored product ad.

Example: 7109947
product_group_idstring

The product group id corresponding to the product ad.

Example: 98745421
tracking objectrequired

The FCC Ad Manager tracking URLs for this ad. Contains the impression, view, and click URLs with placeholders for event-time substitution.

impressionUrlstringrequired

URL to fire on an impression. Replace [EVENTTIME] with epoch milliseconds before firing. see the Engagement Events API.

Example: https://<tracker-domain>/v3/tr/impression?pl=...&iet=[EVENTTIME]
viewUrlstringrequired

URL to fire when the ad is viewable per publisher defined criteria. Replace [STARTTIME] with the view start epoch milliseconds and [ENDTIME] with the view end epoch milliseconds. see the Engagement Events API.

Example: https://<tracker-domain>/v3/tr/view?pl=...&vst=[STARTTIME]&vet=[ENDTIME]
clickUrlstringrequired

URL to fire on a click. Replace [EVENTTIME] with epoch milliseconds before firing. see the Engagement Events API.

Example: https://<tracker-domain>/v3/tr/click?pl=...&cet=[EVENTTIME]
SPAAd
{
  "position": 0,
  "sku": "7109947_123",
  "product_id": "7109947",
  "product_group_id": "98745421",
  "tracking": {
    "impressionUrl": "https://<tracker-domain>/v3/tr/impression?pl=...&iet=[EVENTTIME]",
    "viewUrl": "https://<tracker-domain>/v3/tr/view?pl=...&vst=[STARTTIME]&vet=[ENDTIME]",
    "clickUrl": "https://<tracker-domain>/v3/tr/click?pl=...&cet=[EVENTTIME]"
  }
}