Skip to content

AgencyPMG/pmg-criteo-api

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Criteo API Node.js Client

Features

  • Promise and Callback compatible
  • Authentication retry system
  • Inline documentation (JSDoc specification)
  • Save reporting results to file

Installation

$ npm install criteo-api

Basic Code Examples 

Initialization
const Criteo_API = require( 'criteo-api' );

const criteo = new Criteo_API( 'key', 'secret' );
A Basic Request (Promise / then-able)

Results from an API request can be returned as a settled Javascript Promise:

criteo.getAudiencesByAdvertiser( '12345' )
	.then( (response) => console.log(response.data) )
	.catch ( (err) => console.log(err) )
A Basic Request (Callback)

Alternately, data can be returned via a standard callback function if one is provided as the final parameter:

criteo.getAudiencesByAdvertiser( '12345', (err, response) => {
	if (!err){
		console.log(response.data);
	}
});

Authentication Retry

Oauth2 Tokens retrieved from the /oauth2/token endpoint are valid for 15 minutes.

For the first request after initialization, the Criteo API Client will request an authentication token based on the app key and secret provided and proceed with the request.

First Request (No Stored Auth)

API Authentication Retry

For subsequent requests, the stored token may have become invalid for long-running processes. The Criteo API Client will automatically detect the need for a refreshed token and retry a request that fails once because of a 401 Unauthorized error.

Request with Expired or Invalid Token

API Authentication Retry

Other Features

Saving Reports to File

For Statistics API calls, a filepath can be provided to optionally save results to a local path.

const query = {
    'advertiserIds': '12345',
    'startDate': '2020-09-10T04:00:00.000Z',
    'endDate': '2020-09-14T04:00:00.000Z',
    'format': 'csv',
    'dimensions': ['AdsetId','Day'],
    'metrics': ['Displays','Clicks'],
    'timezone': 'PST',
    'currency': 'USD'
};

criteo.getStatsReport(query, './reports/results.csv')
	.then( (res) => console.log(res) )
	.catch( (err) => console.log(err) )

Further Documentation

Full Technical Documentation - JSDoc

Criteo Developer Portal

License

MIT

About

A NodeJS Client For Criteo API Requests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%