advert-fetcher
Advanced tools
Advert Fetcher je nástroj pro bezpečnější načítání reklamy z IM scriptu pomocí sandboxingu IM do iframu, a zobrazovaní reklamy v samostatných iframech.
Schéma komunikace:
.-----------------------. .------------------------------.
| Advert fetcher iframe | <--------> | Advert fetcher worker iframe |
'-----------------------' '------------------------------'
^ ^ ^
| | '------------------------------.
| '----------------. |
v v v
.-----------------. .-----------------. .-----------------.
| Reklamní iframe | | Reklamní iframe | | Reklamní iframe |
'-----------------' '-----------------' '-----------------'
Pokud není nutno přenastavovat interní konfiguraci advert fetcheru, integrace je poměrně přímočará:
Přidejte si advert fetcher do projektu jako npm závislost:
npm install --save-dev advert-fetcher
HTML soubory v balíčku je vhodné překopírovat do adresáře se statickými
soubory. Pokud je v projektu použit gulp, postup je následovný:
gulp.task('copy:advertFetcher', () =>
gulp
.src('./node_modules/advert-fetcher/*.html')
.pipe(gulp.dest('./static/html/'))
);
Nyní stačí vložit hlavní iframe advert fetcheru do stránky:
<body>
<iframe
id="advert-fetcher"
width="1"
height="1"
sandbox="allow-scripts"
src="/static/html/advert-fetcher.html?service=...&tld=...&workerUrl=...">
<!-- nepovinný fallback pokud klient nepodporuje iframy na stránce -->
<script src="//h.imedia.cz/js/dot-small.js"></script>
<script src="//i.imedia.cz/js/im3.js"></script>
<script>
DOT.cfg({
service: 'název služby',
impress: false
});
im.conf.server = 'i.imedia.cz';
</script>
</iframe>
...
Query parametry ("veřejné" nastavení advert fetcheru) je popsáno níže.
Je doporučeno tento iframe skrýt v UI pomocí CSS:
#advert-fetcher {
position: fixed;
left: -1px;
top: -1px;
}
Iframe advert fetcheru vyžaduje několik nastavení poskytnutých skrz query parametry v URL iframu:
service - název služby, pro kterou je vydávána reklamatld - top-level doména, obvykle cz, nebo test, nebo devworkerUrl - URL na HTML dokument advert-fetcher-worker.htmlPro vložení reklamy do stránky je nutno vložit do stránky iframe odkazující na
dokument advert.html:
<iframe
class="ad"
width="..."
height="..."
sandbox="allow-popups allow-popups-to-escape-sandbox allow-top-navigation allow-scripts"
src="/static/html/advert.html?zoneId=...&collocation=...">
<!-- nepovinný fallback pokud klient nepodporuje iframy na stránce -->
<div id="ad-seznam.sluzba.zona"></div>
<script>
im.getAds([{
id: 'ad-seznam.sluzba.zona',
zoneId: 'seznam.sluzba.zona',
collocation: '...'
}]);
</script>
</iframe>
FAQs
Utility for safe fetching of adverts through the IM script.
The npm package advert-fetcher receives a total of 0 weekly downloads. As such, advert-fetcher popularity was classified as not popular.
We found that advert-fetcher demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PEP 770 proposes adding SBOM support to Python packages to improve transparency and catch hidden non-Python dependencies that security tools often miss.
Security News
Socket CEO Feross Aboukhadijeh discusses open source security challenges, including zero-day attacks and supply chain risks, on the Cyber Security Council podcast.
Security News
Research
Socket researchers uncover how threat actors weaponize Out-of-Band Application Security Testing (OAST) techniques across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.