@adapt-retail/banner-data (alpha)

JavaScript api for communicating with Adapt retail api.

🚧🚧 Warning: This project is in alpha stage. Use with caution. 🚧🚧

Install

NPM

npm install @adapt-retail/banner-data

YARN

yarn add @adapt-retail/banner-data

API

Create object

Provide the adapt data when creating the AdaptData.

Note: When creating your first Adapt Banner or InstoreTV We recommend that you use a collection production instead of a Banner or InstoreTV production. This is because you cannot generate preview of a Banner or InstoreTV production that do not have template assign to it. And usually you do not have that when creating your Adapt Template.

// Import Adapt DataimportAdaptDatafrom'@adapt-retail/banner-data';// Create instancevaradapt=newAdaptData({account: 'priceco58c12436f20b4',// Account keyproject: 1,// Project IDcampaign: 1,// Campaign IDproduction: 1,// Production IDsource: null,// optional preview: false,// optional});

Live vs Preview

Setting preview preview: true will use the slower but faster reloading of data. For live sites, make sure to use the preview: false to use our fast CDN with cache reload in 5 minutes.

Set custom datasource

Setting the source property of the Adapt data will overwrite any data requested by api. This is nice for developing when you are offline.

varadapt=newAdaptData({source: {data: [{id: 1234,name: 'Product',price: 199}]}});

Start

After setting up the object, you can call .start to start retrieving the content.

varadapt=newAdaptData({ ... });// Via promiseadapt.start().then(function(adapt_data){
... Adaptdataisloadedandready ...
});// Via function parameteradapt.start(function(adapt_data){
... Adaptdataisloadedandready ...
});

Asset

Get the asset in the adapt folder.

adapt.start(function(adapt_data){adapt.asset('my-image.png');});

LightAdaptData

Light adapt data is a super light version for adapt data. It cannot request data from external source, but it can read source.

This class is meant for Adapt banner productions.

When using webpack you can set this setting when running production script.

if(process.env.NODE_ENV==='production'){module.exports.resolve={alias: {'@adapt-retail/banner-data': '@adapt-retail/banner-data/dist/LightAdaptData.js',}};}