Ad Refresh Control
Active Installs
400+
Last Updated
April 23, 2025
First Released
October 1, 2020
Download History (Last one month)
Contributors
There is always a drive for more page views to bring more ad impressions, but publishers can often leverage their current traffic and ad slots in order to further increase ad impressions by refreshing the ad slots after a given amount of time.
Previously this required a site’s ad implementation code be modified, but not every publisher has the budget or engineers to enable this. Now with the 10up Ad Refresh Control Plugin publishers can enable the refreshing of their ads without needing to make any modifications to their existing ad implementation.
The increase in impressions will vary from site to site, depending largely on how quickly visitors scroll and how long they spend on each page. Impressions can often be improved with the use of sticky ads, allowing an ad(s) to be sticky on the screen and have a better chance of being visible long enough to be refreshed, but enabling the 10up Ad Refresh Control Plugin will allow publishers to get started immediately.
A settings page will allow adjustments such as the time between refreshes, the maximum number of refreshes, and even list advertisers who would not be happy if their ads were refreshed, but smart defaults will be active for all settings out of the box so you can feel safe activating the plugin without consulting an ads expert first.
Manual Installation
- Download a zip file and install via the WordPress plugin installer.
- Go to the WP-Admin > Settings > Ad Refresh Control settings page within the WordPress admin in order to adjust the settings to meet your specific needs. Settings that we’ve found useful for most sites will be used by default.
Settings
Viewability Threshold: The percentage of the ad slot which must be visible in the viewport in order to be considered eligible for being refreshed. It is recommended you do not lower this below 50 or you risk third-party viewability tracking platforms flagging your ad impressions as not having been viewed before refreshing.
Refresh Interval: The number of seconds that must pass between an ad crossing the viewability threshold and the the ad refreshing. The plugin enforces a minimum of 30 in order to avoid your site being flagged for abusing ad refreshes by advertisers.
Maximum Refreshes: The number of times each ad slot is allowed to be refreshed. If this is set to 4 then an ad slot could have a total of 5 impressions by combining the initial loading of the ad with the 4 times it can refresh.
Excluded Advertiser IDs: Prevent ad refreshes for specific advertiser IDs in the format of a comma-separated list (e.g., 125,594,293). If an ad slot ever displays an ad creative from one of the listed advertiser IDs then that ad slot will stop refreshing for the remainder of the page view.
Line Items IDs to Exclude: Prevent ad refreshes for specific line item IDs in the format of a comma-separated list (e.g., 125,594,293).
Sizes to Exclude: Prevent ad refreshes for specific sizes in the format of a comma-separated list (e.g., 125,594,293). Sizes can be specified by name “fluid” or size 300×250, e.g. fluid,300×250.
Slot IDs to Exclude: Prevent ad refreshes for specific slot IDs in the format of a comma-separated list based on the ID of the div, e.g. div-gpt-ad-grid-1.
Screenshot Gallery
No FAQ provided.
Changelog
1.1.5 – 2024-08-20
- Added: Better error handling for environments that don’t match our minimum PHP version (props @rahulsprajapati, @dkotter, @peterwilsoncc via #123, #157).
- Added: Support for the WordPress.org plugin preview (props @dkotter, @jeffpaul via #138).
- Changed: Bump WordPress “tested up to” version 6.6 (props @sudip-md, @ankitguptaindia, @jeffpaul, @dkotter via #147, #152).
- Changed: Bump WordPress minimum supported version to 6.4 (props @sudip-md, @ankitguptaindia, @jeffpaul, @dkotter via #147, #152).
- Security: Bump
browser-syncfrom 2.28.3 to 3.0.2 (props @dependabot, @Sidsector9 via #142). - Developer: Clean up NPM dependencies and update node to v20 (props @Sidsector9, @dkotter via #155).
- Developer: Move from
actions/upload-release-assettosoftprops/action-gh-releaseGitHub action (props @Sidsector9, @jeffpaul via #156). - Developer: Replaced
lee-dohm/no-responsewithactions/staleto help with closing no-response/stale issues (props @jeffpaul, @dkotter via #145). - Developer: “Testing” section in the
CONTRIBUTING.mdfile (props @kmgalanakis, @jeffpaul via #146).
1.1.4 – 2023-11-16
- Changed: Bump WordPress “tested up to” version 6.4 (props @QAharshalkadu, @jeffpaul via #134, #135).
- Security: Bump
postcssfrom 8.4.25 to 8.4.31,css-loaderfrom 2.1.1 to 6.8.1,postcss-importfrom 12.0.1 to 15.1.0,postcss-loaderfrom 3.0.0 to 7.3.3 andstylelint-orderfrom 1.0.0 to 6.0.3 (props @dependabot, @Sidsector9 via #127). - Security: Bump
@babel/traversefrom 7.4.3 to 7.23.2 (props @dependabot, @dkotter via #131). - Security: Bump
browserify-signfrom 4.0.4 to 4.2.2 (props @dependabot, @ravinderk via #133).
1.1.3 – 2023-10-16
- Changed: Updated the
skaut/wordpress-version-checkerto check WordPress “tested up to” during the Release Candidate phase (props @jeffpaul, @iamdharmesh via #118). - Changed: Bump WordPress “tested up to” version 6.3 (props @QAharshalkadu, @jeffpaul, @peterwilsoncc via #125, #126).
- Security: Bump
stylelintfrom 14.15.0 to 15.10.1 (props @dependabot, @ravinderk via #121). - Security: Bump
fseventsfrom 1.2.8 to 1.2.13 (props @dependabot, @ravinderk via #128).
1.1.2 – 2023-06-14
- Changed: Bump WordPress “tested up to” version 6.2 (props @Sidsector9, @iamdharmesh via #110).
- Changed: Documentation & deploy action updates (props @barryceelen, @jeffpaul, @dkotter via #104, #116).
- Security: Bump
minimistfrom 1.2.0 to 1.2.8 (props @dependabot, @cadic via #105). - Security: Bump
mkdirpfrom 0.5.1 to 0.5.6 (props @dependabot, @cadic via #105). - Security: Bump
loader-fs-cachefrom 1.0.2 to 1.0.3 (props @dependabot, @cadic via #105). - Security: Bump
ua-parser-jsfrom 1.0.2 to 1.0.34 (props @dependabot, @cadic via #106). - Security: Bump
browser-syncfrom 2.27.10 to 2.28.3 (props @dependabot, @cadic via #106). - Security: Bump
yamlfrom 2.1.3 to 2.2.2 (props @dependabot, @faisal-alvi via #111). - Security: Bump
json5from 1.0.1 to 1.0.2 (props @dependabot, @peterwilsoncc via #103). - Security: Bump
socket.io-parserfrom 4.2.2 to 4.2.3 (props @dependabot, @faisal-alvi via #112).
1.1.1 – 2023-01-05
- Added: Release build GitHub Action (props @dkotter via #99).
- Changed: Bump WordPress minimum version from 4.9 to 5.7 and PHP minimum version from 7.0 to 7.4 (props @jayedul, @dkotter via #72).
- Changed: Bump WordPress “tested up to” version to 6.1 (props @jayedul, @dkotter via #97).
- Changed: Support Level from
ActivetoStable(props @jeffpaul via #73). - Removed:
simple-gitas it is no longer used after updating ancestor dependencylint-staged(props @dependabot via #82). - Removed:
is-svgas it is no longer used after updating ancestor dependencypostcss-svgo(props @dependabot via #88). - Fixed: PHPCS workflow failures (props @peterwilsoncc, @cadic via #84).
- Security: Bump
terserfrom 3.17.0 to 4.8.1 (props @dependabot via #71). - Security: Bump
loader-utilsfrom 1.2.3 to 1.4.2 (props @dependabot via #74). - Security: Bump
minimatchfrom 3.0.4 to 3.1.2 (props @dependabot via #76). - Security: Bump
engine.iofrom 3.2.1 to 6.2.1 andbrowser-syncfrom 2.26.5 to 2.27.10 (props @dependabot via #78, #91). - Security: Bump
postcssfrom 7.0.14 to 8.4.19 andpostcss-preset-envfrom 5.3.0 to 7.8.3 (props @dependabot via #81). - Security: Bump
lint-stagedfrom 8.1.5 to 13.0.3 (props @dependabot via #82). - Security: Bump
set-valuefrom 2.0.0 to 2.0.1 andunion-valuefrom 1.0.0 to 1.0.1 (props @dependabot via #86). - Security: Bump
yargs-parserfrom 10.1.0 to 20.2.9,stylelintfrom 9.10.1 to 14.15.0, andwebpack-clifrom 3.3.1 to 3.3.12 (props @dependabot via #87). - Security: Bump
postcss-svgofrom 4.0.2 to 4.0.3 (props @dependabot via #88). - Security: Bump
nth-checkfrom 1.0.2 to 2.1.1 andcssnanofrom 4.1.10 to 5.1.14 (props @dependabot via #89). - Security: Bump
trim-newlinesfrom 2.0.0 to 3.0.1 andstylelint-declaration-use-variablefrom 1.7.0 to 1.7.3 (props @dependabot via #93). - Security: Bump
kind-offrom 6.0.2 to 6.0.3 (props @dependabot via #94). - Security: Bump
serialize-javascriptfrom 1.7.0 to 4.0.0,copy-webpack-pluginfrom 5.0.3 to 5.1.2, andterser-webpack-pluginfrom 1.2.3 to 1.4.5 (props @dependabot via #95). - Security: Bump
decode-uri-componentfrom 0.2.0 to 0.2.2 (props @dependabot via #98).
