@financial-times/o-ads

oAds

This is an Origami module that enables display advertising from Googles DFP Ad server, and provides customised demographic, behavioural (via Krux), and contextual (via Admantx) targeting.

Requirements

For basic use, a DFP account with Google is required. Each targeting/tracking supplier will require their own configuration and setup.

Demos

Demos for all ads currently served across ft.com are available in the Origami Registry.

Documentation

Includes detailed installation and set-up instructions, along with details about the module.

Developing

Install & Demos

• To install: obt install.
• To run the demos: obt demo.
• To run a demo server: npm run demo-server

Tests

See the test documentation

Releasing

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.

Migration Guide

Upgrading to v8

• Breaking change: If you use the destroy method on a slots instance, this will now properly destroy the given slots rather than just clear them
• New feature: util event 'off' - remove an event listener

Upgrading to v9

• Breaking change: o-ads now requires consent before loading Krux or adding custom targeting to the ad calls. Consent can be provided in two ways:

1. Provide a cookie with the name FTConsent and specify which consent the user has given as part of the value like this: behaviouraladsOnsite:on,programmaticadsOnsite:on
2. Initialise o-ads with the disableConsentCookie option.

Upgrading to v10

• Breaking change: o-ads now defaults to never collapsing empty ads slots following google gpt behavior.
• Breaking change: collapsing config oAds takes 3 possible options for the collapseEmpty attribute: 'before', 'after', 'never' and defaults to 'never'
• Breaking change: collapsing ads for a specific slot on the markup now uses 'before', 'after', 'never' instead of true and false previously
• Breaking change: Global collapse empty behavior is set in config.collapseEmpty instead of config.gpt.collapseEmpty previously