Auction examples
- Running auctions
- Sponsored listings
- Sponsored banners
- Sponsored brands
Asset examples
Webhook examples
Events
Assets API
Audience API
Billing API
Campaign API
- GETGet Campaigns
- POSTCreate Campaign
- GETGet Campaign By Id
- DELDelete Campaign By Id
- PATCHUpdate Campaign By Id
- GETGet Campaign Bids
- POSTCreate Campaign Bids
- DELDelete Campaign Bid By Id
- PATCHUpdate Campaign Bid By Id
- POST[BETA] Get estimated clicks of a future campaign for a given vendor
- GETGet Products In Campaign
- GETGet Sponsored Products
Catalog API
Invitation API
Modal API
Reporting API
Report events
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
If the impression is over an ad promotion, this is the resolvedBidId field received from the /auctions request. In most situations, especially when reporting a sponsored interaction, you'll want to fill in this field.
Entity is meant for reporting organic events, not sponsored or promoted products. It refers to the object involved in the organic interaction. But, in most cases, you won't need to fill in this object. Be aware that if resolvedBidId has any value, entity will be disregarded.
URL path of the page triggering the event.
For web apps, this can be obtained in JS using window.location.pathname.
For mobile apps, use the deep link for the current view, if available.
Otherwise, encode the view from which the event occurred in your app as a path-like string (e.g. /root/categories/:categoryId).
1For components with multiple items (i.e. search results, similar products, etc), this should indicate the index of a given item within that list.
x > 1For paginated pages, this should indicate which page number triggered the event.
x > 1For paginated pages this should indicate how many items are in each result page.
x > 1The ID of the product associated to the page in which this event occurred, if applicable. This ID must match the ID provided through the catalog service.
1An array of IDs of the categories associated to the page in which this event occurred, if applicable. These IDs must match the IDs provided through the catalog service.
The search string provided by the user in the page where this event occurred, if applicable. This search string must match the searchQuery field that was provided in the auction request (if provided).
1RFC3339 formatted timestamp including UTC offset.
1The marketplace's unique ID for the impression. This field ensures the event reporting is idempotent in case there is a network issue and the request is retried. If there is no impression model on the marketplace side, generate a unique string that does not change if the event is resent.
1If the marketplace wants to attribute an impression to an additional entity, they can use the additionalAttribution field. When using this field, the resolvedBidId must also exist in the event body.
If the click is over an ad promotion, this is the resolvedBidId field received from the /auctions request. In most situations, especially when reporting a sponsored interaction, you'll want to fill in this field.
Entity is meant for reporting organic events, not sponsored or promoted products. It refers to the object involved in the organic interaction. But, in most cases, you won't need to fill in this object. Be aware that if resolvedBidId has any value, entity will be disregarded.
URL path of the page triggering the event.
For web apps, this can be obtained in JS using window.location.pathname.
For mobile apps, use the deep link for the current view, if available.
Otherwise, encode the view from which the event occurred in your app as a path-like string (e.g. /root/categories/:categoryId).
1For components with multiple items (i.e. search results, similar products, etc), this should indicate the index of a given item within that list.
x > 1For paginated pages, this should indicate which page number triggered the event.
x > 1For paginated pages this should indicate how many items are in each result page.
x > 1The ID of the product associated to the page in which this event occurred, if applicable. This ID must match the ID provided through the catalog service.
1An array of IDs of the categories associated to the page in which this event occurred, if applicable. These IDs must match the IDs provided through the catalog service.
The search string provided by the user in the page where this event occurred, if applicable. This search string must match the searchQuery field that was provided in the auction request (if provided).
1RFC3339 formatted timestamp including UTC offset.
1The marketplace's unique ID for the click. This field ensures the event reporting is idempotent in case there is a network issue and the request is retried. If there is no click model on the marketplace side, generate a unique string that does not change if the event is resent.
1If the marketplace wants to attribute a click to an additional entity, they can use the additionalAttribution field. When using this field, the resolvedBidId must also exist in the event body.
RFC3339 formatted timestamp, including UTC offset, of the instant in which the order was placed. Please note that purchases will NOT be attributed to an auction that happened after.
1Items purchased.
The marketplace ID of the product being purchased.
1Count of products purchased.
x > 1The price of a single item in the marketplace currency.
x > 0The vendor ID of the product being purchased. This field is optional and should be filled in if a product is sold by multiple vendors.
1The marketplace unique ID for the order. This field ensures the event reporting is idempotent in case there is a network issue and the request is retried. If there is no unique ID for orders on the marketplace side, generate a unique string that does not change if the event needs to be resent.
1