This is an Origami module that enables advertising from Google's DFP Ad Server (part of Ad Manager), and provides customised demographic, behavioural (via Krux), and contextual (via Admantx) targeting.
For basic use, a DFP (DoubleClick for Publishers) account with Google is required.
Each targeting/tracking supplier will require their own configuration and setup.
Demos for all ads currently served across ft.com are available in the Origami Registry.
Includes detailed installation and set-up instructions, along with details about the module.
To build the documentation locally, from the docs
directory, run:
bundle install
jekyll build
It will generate a _site
directory where generated site will be compiled
You can then run the jekyll local server by executing jekyll serve
.
See the test documentation
You will need a GITHUB_TOKEN
environment variable with access to the repository in your .env file
Get a github token with "repo" access and make it accessible as an environment variable.
Run npm run release (patch|minor|major|x.y.z)
in master
then follow the interactive steps.
This will bump version numbers in the source and commit them, push to github and create a new release.
The command uses release-it under the hood as well as genversion to automatically bump version numbers in the source.
This release removes integration with Krux for behavioural targeting.
The origami component o-permutive can be used for behavioural tracking instead.
This release introduces the following changes:
o-ads
is now recording a performance mark for every event that it dispatches. The performance mark will have the same name as the event that originated it plus, in some cases, a suffix that helps determine the circumstances that triggered the event. This is all being used internally by o-ads
to provide new metrics functionality.
o-ads
exposes a new setupMetrics
method that simplifies obtaining performance metrics. setupMetrics
accepts two parameters:A guide can to the new names can also be found in this two diagrams:
As of version 11, o-ads has been updated to use ES modules. Unfortunately, this means it is not backwards compatible with CJS modules and clients cannot require('o-ads')
anymore.
import oAds from 'o-ads'
collapseEmpty
attribute: 'before'
, 'after
', 'never'
and defaults to 'never'
'before'
, 'after
', 'never'
instead of true
and false
previouslyconfig.collapseEmpty
instead of config.gpt.collapseEmpty
previouslyFTConsent
and specify which consent the user has given as part of the value like this: behaviouraladsOnsite:on,programmaticadsOnsite:on
disableConsentCookie
option.