Requesting a Home Page Banner X Ad

Home page banner ads require a simple "context' to be sent to Project Agora Commerce. A "context" is a bit of code that defines the conditions under which a product is shown to a customer.

Banner X Ads use the /bannerx endpoint

Project Agora Commerce may need to enable home page ads before ads can be served.

You will receive your contentStandardId from CitrusAd once your content standard is generated.

Minimum Viable Context:

Below are the minimum values needed to generate a search term ad:

POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic your_api_key_here
{
    "catalogId": "string",
    "pageType": "string",
    "contentStandardId": "string",
    "bannerSlotIds": [
          {
            "slotId": "string",
      "maxNumberOfAds": number
     }
   ]
}

Exemplar Context

Here is an example of a context for the pageType "Home":

What Happens when an Ad Is Successfully Requested

When you successfully request an ad, you receive the following object:

You may receive less fields within a banner object, this will occur when a banner is configured without all possible fields.

Requesting Multiple Banners

The example below requests 2 banner slot ids in the same home page request:

What Happens When an Ad Is Successfully Requested

When you successfully request an ad, you receive the following object:

If you are unsure of the strings displayed on this page. Take a look at the Reference page.

PreviousRequesting a Search Term Banner X AdNextBanner X Ad Reference

Last updated