Skip to content
Advertising framework for DFP
Branch: master
Clone or download
Latest commit cba6c8b Jun 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Temporarily shut off snyk monitor (#269) Jun 6, 2019
demos/src Remove console log for dev and adjust indentation Apr 29, 2019
docs Temporarily shut off snyk monitor (#269) Jun 6, 2019
src Release 12.5.0 Jun 11, 2019
test new slotCollapsed event and added creativeId to metrics (#271) Jun 11, 2019
.eslintignore Remove snyk check on CircleCI (#209) Dec 3, 2018
.eslintrc-complexity.js Added new lint-complexity task (#175) Oct 8, 2018
.eslintrc.js Removed specific firefox-safari test Sep 7, 2018
.gitignore Cypress for testing ad requests (#191) Dec 3, 2018
.release-it.json
.snyk Update Snyk (#265) Jun 5, 2019
.travis.yml refactoring old desktop lib to be origami style Oct 6, 2014
Procfile Add procfile May 3, 2016
README.md Update README.md (#266) Jun 6, 2019
bower.json Allow version 2 or 3 of ftdomdelegate. Apr 9, 2019
cypress.json Cypress for testing ad requests (#191) Dec 3, 2018
karma.conf.js New slot level events (#248) Apr 24, 2019
main.js add consent events (#257) May 9, 2019
main.mustache Clean up Jun 1, 2015
main.scss AT-2106: Added a consistent way to add a label with borders Aug 31, 2018
origami.json update description (#258) May 13, 2019
package-lock.json Include browser and version in nightwatch output (#273) Jun 11, 2019
package.json Release 12.5.0 Jun 11, 2019
secret-squirrel.js Add demo for infinite scrolling using button Apr 26, 2019

README.md

oAds CircleCI Status

This is an Origami module that enables advertising from Google's 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.

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.

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

Upgrading to v11

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.

  • Breaking change: if importing o-ads in your build, you must now do it as follows: import oAds from 'o-ads'

Upgrading to v12

This release introduces the following changes:

  1. 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.

  2. o-ads exposes a new setupMetrics method that simplifies obtaining performance metrics. setupMetrics accepts two parameters:

  • An array of objects containing the configuration of the different metrics that need to be tracked.
  • A callback function to be called whenever any of the trigger events of any of those configuration objects is dispatched.
  1. Several custom events fired by o-ads have been renamed for different reasons. This is the list of events whose name has changed:
Old event name New event name
startInitialisation initialising
moatIVTcomplete IVTComplete
apiRequestsComplete adsAPIComplete
adServerLoadSuccess serverScriptLoaded
ready slotReady
render slotCanRender
gptDisplay slotGoRender
rendered slotRenderStart
complete slotExpand
adIframeLoaded slotRenderEnded

A guide can to the new names can also be found in this two diagrams:

Event renaming pt. 1

event renaming 1

Event renaming pt. 2

event renaming 2

You can’t perform that action at this time.