Switching to the new ad tag
Starting July 20, 2021, Adfox uses the universal ad loader code. Previously, different loader codes were used to load different types of Yandex Advertising Network and Adfox ad units. With the new codes, the browser does not waste time accessing multiple loads, so ads are served faster. The new Adfox banner ad tag is now asynchronous by default and contains a single yaContextCb loading queue: this optimizes loading of different types of ads on the page.
The old ad tags are compatible with the new ones, so you can change the banner codes on the pages of your site gradually. We recommend that you first make changes to one of the ad tags on the page and make sure that it works properly, and then move on to the next one.
Replacing the old ad tag with the new one
You can get the new ad tag in the Adfox interface:
- At the site level: Open the Sites tab and click
next to the site name.
- At the placement level: Go toand click
next to the name of the site.
- At the banner level: On the Campaigns tab, select a campaign, go to and click
next to the desired placement.
To replace the ad tag manually:
- Add the ad loader code to the
<head>
of each page where your ads are served:<script>window.yaContextCb = window.yaContextCb || []</script> <script src="https://yandex.ru/ads/system/context.js" async></script>
Copied to clipboardNote. The ad loader code is the same for all types of Yandex ads. If the page already contains separate codes of the Yandex Advertising Network ad units or recommendation widget, you don't need to duplicate the ad loader code. - Remove the scripts with the old code loaders from the banner code:
<script src="https://yastatic.net/pcode/adfox/loader.js" crossorigin="anonymous"></script>
<script src="https://an.yandex.ru/system/adfox.js" crossorigin="anonymous"></script>
<script src="https://an.yandex.ru/system/context.js" crossorigin="anonymous"></script>
- Add new lines to the banner code:
window.yaContextCb.push(()=>{ ... })
Old code New code <div id="adfox_162624621735476317"></div> <script> window.Ya.adfoxCode.create({ ownerId: 353052, containerId: 'adfox_162624621735476317', params: { pp: 'g', ps: 'ezwy', p2: 'gnhv' } }); </script>
<div id="adfox_162624621735476317"></div> <script> window.yaContextCb.push(()=>{ Ya.adfoxCode.create({ ownerId: 353052, containerId: 'adfox_162624621735476317', params: { pp: 'g', ps: 'ezwy', p2: 'gnhv' } }) }) </script>
Old code New code <div id="adfox_162624621735476317"></div> <script> window.Ya.adfoxCode.create({ ownerId: 353052, containerId: 'adfox_162624621735476317', params: { pp: 'g', ps: 'ezwy', p2: 'gnhv' } }); </script>
<div id="adfox_162624621735476317"></div> <script> window.yaContextCb.push(()=>{ Ya.adfoxCode.create({ ownerId: 353052, containerId: 'adfox_162624621735476317', params: { pp: 'g', ps: 'ezwy', p2: 'gnhv' } }) }) </script>
- How the new ad tag works
- The ad rendering function is no longer called immediately, but is added to a single call queue. When the browser downloads and runs the loader code, it parses the queue and calls the ad block ad tags. If the loader is already in the browser cache when loading the page, the ad tags are run faster.
- Example of the new ad tag
-
<!-- In the site <head>, add the loader code once--> <script>window.yaContextCb = window.yaContextCb || []</script> <script src="https://yandex.ru/ads/system/context.js" async></script> <!--Adfox START--> <!--login--> <!--Placement: example.pro / * / *--> <!--Banner type: 100%х250 Turbo--> <!--Position: <top of the page>--> <div id="adfox_16244342575025707"></div> <script> window.yaContextCb.push(()=>{ Ya.adfoxCode.create({ ownerId: 353052, containerId: 'adfox_16244342575025707', params: { pp: 'g', ps: 'ezwy', p2: 'gnhv' } }) }) </script>
Replacing obsolete asynchronous ad tag
If your site uses obsolete asynchronous ad tag, replace it with the new one.
Code correspondence:
Code type | Obsolete code | New code |
---|---|---|
Asynchronous code | adfoxAsyncParams | Ya.adfoxCode.create |
Adaptive code | adfoxAsyncParamsAdaptive | Ya.adfoxCode.createAdaptive |
Code type | Obsolete code | New code |
---|---|---|
Asynchronous code | adfoxAsyncParams | Ya.adfoxCode.create |
Adaptive code | adfoxAsyncParamsAdaptive | Ya.adfoxCode.createAdaptive |
Examples of replacing obsolete asynchronous ad tag with the new one:
Obsolete code | New code |
---|---|
| |
Obsolete code | New code |
---|---|
| |