Unfortunately, XML/JSON feeds don't follow any standards, which can be a problem sometimes. We have added many presets for popular ad networks. However, creating a preset for every ad network on the market is impossible.

If you didn't find the ad network you need in the list, you should select Custom format. It will allow you to configure a custom XML/JSON feed format.

First, you need to learn what XML and JSON data formats are.

Then, you must create an XML/JSON ad (e.g., Link XML), configure an endpoint URL, and connect it to some zones.

After that, you should go to the zone debugger to get a response from the endpoint. Alternatively, you can check the endpoint's documentation (if it was provided) for a response example.

Next, if it is not pointed out in the documentation, you must recognize the feed response format. Here are some hints:

  • A JSON response should contain many curly brackets { }
  • An XML response should contain many angle brackets < > and must start with "<?xml"

At last, you need to check the feed structure and fill in several fields on the ad form. Please refer to the appropriate field names from the feed response. Unfortunately, this process can be not so obvious sometimes. Below, you find several examples.

Fields

  • JSON format – tick if your feed is in JSON format
  • Multiple items – tick if the response may contain more than one ad
  • List tag – a tag name that contains a list of ads
  • Item tag – refers to a tag that contains ad data.
  • Click URL tag – refers to the tag name (or an attribute name) that contains an ad URL
  • Bid tag – refers to the tag name (or an attribute name) that contains a bid
  • Bid pricing model – a bid type; the endpoint owner has to provide this information.

There are additional fields for Native and Push notification feeds:

  • Title tag – refers to the tag name (or an attribute name) that contains an ad title
  • Description tag – refers to the tag name (or an attribute name) that contains an ad description
  • Item tag – refers to a tag that contains ad data.
  • Icon URL tag – refers to the tag name (or an attribute name) that contains an icon URL
  • Image URL tag – refers to the tag name (or an attribute name) that contains an image URL
  • Pixel URL tag – refers to the tag name (or an attribute name) that contains impressions tracking pixel URL

Special notes

Tag and attribute names are case-sensitive. Therefore, "Url" and "URL" cannot be used interchangeably.

Examples

Example #1

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <listing bid="0.023032" url="https://example.com" />
</result>
  • This is an XML feed. No need to tick "JSON format"
  • It contains one ad only. No need to tick "Multiple items"
  • The item tag (attribute) is "listing"
  • The click URL tag (attribute) is "url"
  • The bid tag (attribute) is "bid"

Example #2

<?xml version="1.0" encoding="utf-8"?>
<result>
    <bid>0.023</bid>
    <redirecturl>example.com</redirecturl>
    <clickid>123456789</clickid>
</result>
  • This is an XML feed. No need to tick "JSON format"
  • It contains one ad only. No need to tick "Multiple items"
  • The item tag is not needed since the ad is placed at the root level
  • The click URL tag is "redirecturl"
  • The bid tag is "bid"

Example #3

{
  "results": [
    {
      "clickurl": "https://example.com/click",
      "bid": 0.20
    }
  ]
}
  • This is a JSON feed. Tick "JSON format"
  • It contains one ad, but there is a JSON array "results": [ … ]. This means it may contain more than one ad, so you should tick "Multiple items"
  • The list tag is "results"
  • The item tag is not needed. Leave empty
  • The click URL tag is "clickurl"
  • The bid tag is "bid"

Example #4

<?xml version="1.0" encoding="UTF-8"?>
<Ads Successful="True" Count="0">
    <Listing>
        <URL>http://example.com?url1</URL>
        <Cost>0.019</Cost>
    </Listing>
    <Listing>
        <URL>http://example.com?url2</URL>
        <Cost>0.018</Cost>
    </Listing>
</Ads>
  • This is an XML feed. No need to tick "JSON format"
  • It contains two ads. Tick "Multiple items"
  • The list tag is not needed because ads are placed at the root level
  • The item tag is "Listing"
  • The click URL tag is "URL"
  • The bid tag is "Cost"

Example #5

<?xml version="1.0" encoding="UTF-8"?>
<Ads Successful="True" Count="0">
  <Results> 
    <Listing>
        <URL>http://example.com?url1</URL>
        <Cost>0.019</Cost>
    </Listing>
    <Listing>
        <URL>http://example.com?url2</URL>
        <Cost>0.018</Cost>
    </Listing>
  </Results> 
</Ads>
  • This is XML feed. No need to tick "JSON format"
  • It contains two ads. Tick "Multiple items"
  • The list tag is "Results"
  • The item tag is "Listing"
  • The click URL tag is "URL"
  • The bid tag is "Cost"

Example #6

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <listing 
        title="Title"
        descr="Descr"
        site= "Super Site"
        bid="0.123"
        url="https://example.com"
        pixel="https://example.com?pixel"
        image="https://example.com?image"
    />
</result>
  • This is an XML feed. No need to tick "JSON format"
  • It contains one ad only. No need to tick "Multiple items"
  • The item tag (attribute) is "listing"
  • The click URL tag (attribute) is "url"
  • The bid tag (attribute) is "bid"
  • The title tag (attribute) is "title"
  • The description tag (attribute) is "descr"
  • The image URL tag (attribute) is "image"
  • The pixel URL tag (attribute) is "pixel"