You are here: Publishers > Inventory > Sites > Specifying auto refresh settings

Specifying auto refresh settings

Last updated on October 18, 2017)

Depending on your user access, when creating and editing sites and ad units, you can specify auto refresh settings for web and mobile ad units that use JavaScript, iframe, or structured ad calls. OpenX Ad ServerA complete digital advertising platform where publishers sell, manage, and deliver their advertising inventory across all digital formats. supports the following auto refresh settings:

  • A default refresh delay (how often to refresh) and/or a refresh maximum (how many times to refresh).

  • One or more custom, country-specific refresh delay and/or refresh maximum settings. You can apply different refresh settings depending on the location of the person viewing the ad.

OpenX Ad Server applies these refresh settings to web and mobile ad units that belong to your account's sites, unless specified for individual ad units or explicitly set in the ad tag. When determining auto refresh settings for an ad call, OpenX Ad Server applies this order of precedence:

  1. If refresh parameters (rd and rm) are set in the ad tagA small piece of code that defines the ad space where ads display on a website. It includes parameters that describe the inventory advertising campaigns can target, which may in turn display ads in the ad space., OpenX Ad Server uses these values and ignores any auto refresh settings associated with the siteAn OpenX component that represents top-level domains or sub-domains and is used to organize ad units. Sites enable you to target and report on inventory performance. or ad unitThe smallest inventory component that represents the space on a site where ads display..

  2. If refresh parameters are not passed in the ad tag, OpenX Ad Server checks for and applies country-specific auto refresh settings for the ad unit.

  3. Otherwise, OpenX Ad Server checks for and applies auto refresh settings for the ad unit.

  4. If auto refresh settings are not set for the ad unit, OpenX Ad Server checks for and applies country-specific auto refresh settings for the container site.

  5. Otherwise, OpenX Ad Server checks for and applies default auto refresh settings for the container site.

Defining site-level auto refresh settings

At the site level, enable and specify auto refresh settings by performing the following steps:

  1. Select the Auto Refresh Settings Enabled check box. Additional fields appear.

    auto refresh settings enabled

  2. To set a default refresh delay and/or a maximum number of refreshes, fill in the fields with integers.

    For example, if you set the first field to "2" and the second field to "60", the user sees fresh ads twice during his or her interaction with the page. The ads refresh after 60 seconds pass. After two refreshes, the user no longer sees fresh ads.

  3. To set one or more custom refresh delay and/or refresh maximum settings, click + add custom auto refresh settings, select the country in the list, and type integer values in the boxes. You can apply different refresh settings depending on the location where the end-user is viewing the ad space. To turn off refresh for specific cases, specify "0" for the first integer.

    country-specific auto refresh settings

  4. To delete a custom auto refresh setting, click - remove setting. To add more country-specific auto refresh settings, click + add custom auto refresh settings.

Defining ad unit-level auto refresh settings

At the ad unit level, you can override site-level settings by performing the following steps:

  1. In the Auto Refresh Settings field, click Click here to override.
  2. Auto Refresh Settings on the ad unit level

  3. You can now select the Auto Refresh Settings Enabled check box and define new auto refresh settings to override the site-level settings. For detailed instructions, refer to steps 2-4 in Defining site-level auto refresh settings.

This topic applies to Ad Server. This topic applies to SSP. Most SSP activities are completed by OpenX.

Feedback form