LogoLogo
  • Overview
  • What Ads Can Project Agora Commerce Serve?
  • Integration
    • API Introduction
    • Integration Workflow
      • Integration Summary
      • Integration Steps
    • Syncing Data
      • Syncing Data Via File Protocols
    • Syncing Catalog & Products
      • Syncing Catalog and Products Via File
    • Syncing Order Data
      • Syncing Order Data Via API
    • Reporting Clicks and Impressions
    • Integration Checklist
  • Integration Guides
    • HTTP Persistence & Ad Caching
    • Reference
    • Requesting Ads (the "Context" and its Parts)
    • Product Listing Ad Integration Guide
      • Requesting a Category Product Ad
      • Requesting a Search Term Product Ad
      • Requesting a Home Page Product Ad
    • Discovery Product Listing Ad Integration Guide
      • Requesting a Discovery Product Ad
    • Banner Ad Integration Guide
      • Banner Ad Content Standard
      • Requesting a Search Term Banner Ad
      • Requesting a Category Banner Ad
      • Requesting a Home Page Banner Ad
      • The Post Checkout Banner Ad Context
      • Graceful Fallback in the Event That No Ads Are Displayed
    • Banner X Ad Integration Guide
      • Banner X Ad Content Standard
      • Requesting a Category Banner X Ad
      • Requesting a Search Term Banner X Ad
      • Requesting a Home Page Banner X Ad
      • Banner X Ad Reference
      • Graceful Fallback in the Event That No Ads Are Displayed
Powered by GitBook
On this page
  1. Integration Guides
  2. Banner Ad Integration Guide

Banner Ad Content Standard

PreviousBanner Ad Integration GuideNextRequesting a Search Term Banner Ad

Last updated 4 years ago

In order to make it possible for advertisers to place Banner Ads on a retailer's e-commerce site, a content standard is needed. Content standards define what conditions must be met for the creative that advertisers create and upload.

Below is an example of a content standard page that defines a Banner Ad slot on an example retailer website. The Banner Ad slot in this instance (Category / Search) is located at the top of the website sub category page above the first row of product tiles.

An example of a content standard, which defines to the supplier, which page type (category or search page) the Banner Ad will appear on and the location of the Banner Ad within that page.

Once you have defined the rules around how Banner Ads should look on your website and where they will appear throughout your website, Banner Ads will appear in your admin console for approval before they become part of the dynamic auctions that are available to advertisers to bid on.

When you (the retailer) have defined your content standard, advertisers will provide content to fill the slots, which you will then use the Project Agora Commerce interface to approve for inclusion on your e-commerce website. How to Define a Content Standard and Share it with Project Agora Commerce.

This section explains how a retailer defines a content standard and provides the content standard to Project Agora Commerce so that Banner Ads can be made available to advertisers.

Example Content Standard

The content standard is the list of all slots on your website and their attributes. These attributes include the width and height of the Banner Ad, supported image types, specific Banner Ad rules, guidelines for any branding or use of color within the Banner Ad and the slot id of the Banner Ad. Each Banner Ad location on your website is known as a "slot", and each slot has a unique "slot id".

Multiple page types can host the same "slot" depending on your integration. An example of this would be a "category" Banner Ad. This could be hosted on multiple category levels within your site.

Providing Content Standard Data to Project Agora Commerce

To create your content standard you will need to provide Project Agora Commerce appropriate details about your website. This should be screenshots or links to pages of your website with the information in the section below called "Necessary Fields in the Content Standard". Project Agora Commerce will then convert your content standard into code that will make your Banner Ad slots available for real-time auction to advertisers.

If you are unsure what pages and positions to serve Banner Ads, contact Project Agora Commerce for our opinion on where to serve Banner Ads to best monetize your website.

Necessary Fields in the Content Standard

You (the retailer) must provide the following parameters in the fields of the content standard:

Banner Ad information:

  • Width of the Banner Ad (for example, 2000px)

  • Height of the Banner Ad (for example, 300px)

  • Image type of the art in the Banner Ad (for example, PNG)

  • Slot id of the Banner Ad -- this should be unique, with no spaces. It should be human-readable and variable-name safe. For example, "homepage_desktop_1", "homepage_mobile_1", "HomePageDesktop1", and "HomepageMobile1" are all acceptable values. Spaces are not permitted. "Home page desktop 1" is not an acceptable slot id for a Banner Ad.

Design Rules for the Banner Ad -- (example rules)

  • Banner Ads must have the background color #F2F2F2

  • Banner Ads must use the "Open Sans Light" font for any text.

  • Banner Ads must contain your company logo

  • Banner Ads must not contain more than 40 characters of text

  • Banner Ads must not be more than 40% covered in color, branding or product images

Banner Ad Definition Examples

Category Banner Ad:

Category Banner
Slot ID - CategoryBanner001
2000px Wide
300px High
Acceptable File Formats: SVG, PNG, JPG

Product Tile Banner Ad:

Product Tile Banner
Slot ID - ProductTileBanner001
200px Wide
375px High
Acceptable File Formats: SVG, PNG, JPG

Example Retailer Slot Rules

An example of rules to be sent to Project Agora Commerce can be seen below.

532KB
Generic Website Standard.pdf
pdf
186KB
Example Retailer Slot Rules.pdf
pdf
Example Retailer Slot Rules