Advert Fetcher
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.
Přehled architektury
Schéma komunikace:
.-----------------------. .------------------------------.
| Advert fetcher iframe | <--------> | Advert fetcher worker iframe |
'-----------------------' '------------------------------'
^ ^ ^
| | '------------------------------.
| '----------------. |
v v v
.-----------------. .-----------------. .-----------------.
| Reklamní iframe | | Reklamní iframe | | Reklamní iframe |
'-----------------' '-----------------' '-----------------'
Integrace do služby
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;
Nyní stačí vložit hlavní iframe advert fetcheru do stránky:
<!-- nepovinný fallback pokud klient nepodporuje iframy na stránce --> ...
Query parametry ("veřejné" nastavení advert fetcheru) je popsáno níže.
Je doporučeno tento iframe skrýt v UI pomocí CSS:
Nastavení advert fetcheru
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, obvyklecz
, nebotest
, nebodev
workerUrl
- URL na HTML dokumentadvert-fetcher-worker.html
Vložení reklamy do stránky
Pro vložení reklamy do stránky je nutno vložit do stránky iframe odkazující na
dokument advert.html
:
<!-- nepovinný fallback pokud klient nepodporuje iframy na stránce -->