How do CitrusAd's brand pages work?
CitrusAd's brand pages work by specifying a placement of
brandpage, and specifying any additional request parameters that provide the context of the user. Currently, this supports a page title and text, a full-width banner X top banner, and 15 product ads. Individual calls are made three endpoints and you will merge the responses on your website.
From each endpoint's response, you render the page on your own ecommerce site. CitrusAd does not host the page on your site, CitrusAd serves the content to be rendered.
Templating your brand page
It's important to note that in your ecommerce system you do not need to set up a unique "brand page" link for every campaign in the CitrusAd system.
CitrusAd advise to generate a templated page at a consistent URL such as `
https://www.<RETAILER>.com/brand/* wherein the content served by CitrusAd is injected when there is an active brand page.
When a user lands on a page such as
https://www.<RETAILER>.com/brand/summer-cola, you will send a request to CitrusAd with the filter of
brandpage:summer-cola. From here, if CitrusAd has an active brand page, you will receive the content for you to render on your templated page.
This means that you're able to generate brand pages via the CitrusAd system, with no requirement to configure a page per campaign in your retailer backend.
What if no content is served?
In the unlikely event your customer has landed on a link where there is no active brand page, CitrusAd will not serve content. Some retailers may navigate to a 404, re-navigate a user to the homepage or previous page, or alternatively serve the content of the page empty like the below: