@frontity/smart-adserver
API reference of `@frontity/smart-adserver` package
Smart Adserver is an ad serving network and they provide an API for displaying the ads which is described here.
The
@frontity/smart-adserver
package will load a third-party Smart Adserver library which adds certain properties on the global window
object. Then you as the developer can render the exposed <SmartAd>
component, which will use those properties to make the "ad call" (which are basically API calls to the Smart Adserver).In response, the Smart Adserver dynamically loads some code which will modify the DOM to insert the ad in the place that the
<SmartAd>
component was rendered.The package has 3 main components:
- The "Root" component. It includes the
<Head>
that loads the Smart Adserver library. When the user adds the@frontity/smart-adserver
to theirfrontity.settings.js
file, this library will be loaded automatically. - The
SmartAd
component. This component is exposed inlibraries.fills.SmartAdserver.SmartAd
. The users can just use this component directly to display ads by passing it relevant props. The component takes care of calling the Smart Adserver API and injecting the ad into the DOM in the relevant place - Ability to specify the ads in
fills
in thefrontity.settings.js
file. Ads can be placed in specific slots in a theme by using that approach.