Gathering detailed insights and metrics for advert-fetcher
Gathering detailed insights and metrics for advert-fetcher
npm install advert-fetcher
Typescript
Module System
Min. Node Version
Node Version
NPM Version
47.9
Supply Chain
89.3
Quality
78.1
Maintenance
100
Vulnerability
100
License
Total Downloads
8,816
Last Day
2
Last Week
4
Last Month
59
Last Year
314
Minified
Minified + Gzipped
Latest Version
0.6.3
Package Id
advert-fetcher@0.6.3
Size
12.50 kB
NPM Version
5.5.1
Node Version
8.9.3
Cumulative downloads
Total Downloads
Last day
0%
2
Compared to previous day
Last week
-84%
4
Compared to previous week
Last month
490%
59
Compared to previous month
Last year
-22.5%
314
Compared to previous year
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:
1npm 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ý:
1gulp.task('copy:advertFetcher', () => 2 gulp 3 .src('./node_modules/advert-fetcher/*.html') 4 .pipe(gulp.dest('./static/html/')) 5);
Nyní stačí vložit hlavní iframe advert fetcheru do stránky:
1<body> 2 <iframe 3 id="advert-fetcher" 4 width="1" 5 height="1" 6 sandbox="allow-scripts allow-same-origin" 7 src="/static/html/advert-fetcher.html?service=...&tld=...&workerUrl=..."> 8 <!-- nepovinný fallback pokud klient nepodporuje iframy na stránce --> 9 <script src="//h.imedia.cz/js/dot-small.js"></script> 10 <script src="//i.imedia.cz/js/im3.js"></script> 11 <script> 12 DOT.cfg({ 13 service: 'název služby', 14 impress: false 15 }); 16 im.conf.server = 'i.imedia.cz'; 17 </script> 18 </iframe> 19 ...
Query parametry ("veřejné" nastavení advert fetcheru) je popsáno níže.
Je doporučeno tento iframe skrýt v UI pomocí CSS:
1#advert-fetcher { 2 position: fixed; 3 left: -1px; 4 top: -1px; 5}
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 dev
workerUrl
- URL na HTML dokument advert-fetcher-worker.html
Pro vložení reklamy do stránky je nutno vložit do stránky iframe odkazující na
dokument advert.html
:
1<iframe 2 class="ad" 3 width="..." 4 height="..." 5 sandbox="allow-popups allow-popups-to-escape-sandbox allow-top-navigation allow-scripts allow-same-origin" 6 src="/static/html/advert.html?zoneId=...&collocation=..."> 7 <!-- nepovinný fallback pokud klient nepodporuje iframy na stránce --> 8 <div id="ad-seznam.sluzba.zona"></div> 9 <script> 10 im.getAds([{ 11 id: 'ad-seznam.sluzba.zona', 12 zoneId: 'seznam.sluzba.zona', 13 collocation: '...' 14 }]); 15 </script> 16</iframe>
No vulnerabilities found.
No security vulnerabilities found.