Origami Frontend Components & Services

Readme: o-ads active

o-ads is not maintained by the Origami team. While this component may be used, we make no guarantees about the support status, though we will help if we can.

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

Tests

The testing setup is unlike other origami components. There are unit tests which we run with karma, and these can be run with npm run test-unit

Browser tests
We also use Nightwatch and Browserstack to run cross browser tests. To run these:

  1. npm run demo-server in your terminal. This will compile and launch the demos on http://localhost:3002. This is needed for the next step to work
  2. npm run test-browser will run a local browserstack tunnel and run the tests

Migration Guide

Upgrading to v8

Upgrading to v9

  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

Switch component view

GitHub Repository

Install o-ads

If using the Build Service, add o-ads@^10.1.2 to your script and link tags.

If running a Manual Build, run bower install --save "o-ads@^10.1.2".

Help & Support

o-ads is not supported directly by the Origami team. We make no guarantees, but will help if we can. First try contacting its maintainers at:

Slack: #advertising-dev
Email: origami.advertising.technology@ft.com