Backup ad

A backup ad (placeholder) is the code that's displayed if there are no banners to display from commercial ad campaigns. It's used if:

• There are no active ad campaigns.
• Limits or targeting parameters prohibit banner impressions to this user (for example, if restrictions on unique impressions or geography are triggered).

A backup ad may be an image, HTML code, or JavaScript code and may perform different functions — for example, promote a product or monetize unsold traffic.

You can add backup ads:

• For a placement (if the backup ad isn't set, it's selected based on the banner type).
• For the banner type (if the backup ad isn't set, the server returns the system placeholder code, which doesn't affect site display).

The sequence of selecting a banner for impressions

Add a backup ad

1. To add a banner to a placement, go to Inventory → Your site → Sections → Placements and click Backup Ad.

   To add a backup ad to a banner type, go to Settings → Banner types and click Backup Ad next to the desired type.

2. Add the banner in one of the following ways:

   • File: Upload an image (*.jpg, *.png, *.gif) or attach a link to it. Specify the redirect link in the Transition URL field.
   • Code: Insert the HTML, JSON, or JavaScript code (or XML code for placements with XML banner types), including the ad tag from third-party ad management systems. For detailed instructions on inserting the code, see the section for your specific banner type.

Backup ad for nondimensional banner types

When using nondimensional banner types, the ad tag doesn't take up space on the site page, so you can place banners of different sizes on the same placement (if the site layout allows this).

For example, a 600 × 90 placement hosts the 600 × 90 nondimensional banner type. There are no suitable banners to display, and the backup ad isn't set, so the response from the Adfox server has code 204 in the JSON errors object. The placement size doesn't change and the site layout isn't affected.

To add a backup ad with the Adfox code:

1. Use the code generator. Select the code type that you place in the backup ad.
2. If necessary, add tracking pixels.
3. Copy the code and paste it in the Code field with the JavaScript type when adding a backup ad.

Backup ads for XML banner types

• If there are no suitable banners to display, and the backup ad isn't set, a system placeholder code is output:

  <?xml version="1.0"?><nobanner></nobanner>
  

• For a custom banner to be displayed, add the XML code.

Backup ad for video ads

For a banner for VAST player ads to be displayed, you need an ad request link. Put this link in square brackets in the VASTAdTagURI block, for example:

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="2.0">
   <Ad id="%placeId%">
      <Wrapper>
         <AdSystem>Adfox.ru</AdSystem>
         <VASTAdTagURI><![CDATA[//ads.adfox.ru/XXXXXX/getCode?p1=xxx&p2=xxx&pfc=a&pfb=a&plp=a&pli=a&pop=a&puid1=%userValue1%]]></VASTAdTagURI>
         <Impression></Impression>
         <Creatives></Creatives>
      </Wrapper>
   </Ad>
</VAST>

If you need to pass additional parameters to the request code, use macros:

• For values of user characteristics: puidN with the %userValueN% value, where N is the characteristic number. For example, &puid1=%userValue1%.
• To send a referer: dl with the %referrerEncoded% value. For example, &dl=%referrerEncoded%.

Copy the code and paste it in the Code field when adding a backup ad for a placement and/or banner type.

Contact support

Send an email