Custom Skill Audio Ads

Audio Ads for Custom Alexa Skills

This document explains the process of integration Custom Alexa Skill with Instreamatic.AI Voice-Activated ads network. Please use this manual if your Alexa Skill is developed with node.js and alexa-app npm module.

Install Instreamatic.AI Alexa SDK

In order to use our SDK in your Alexa skill, please execute the following command in a folder containing npm modules for your skill:

bash$ npm install instreamatic-alexa-sdk

There should be node_modules/ directory to properly execute this command.

Example of integration with Instreamatic Ad Network

var manager = new Adman.Manager(app, { <br>redis: {“port”: 6667, “db”: 0},
publisherId: 777,
skillId: 777,
preview: 44
});
ad_manager.adEvent('AdComplete', function(req, res) {
... Here you can place the code you want ...
... to run when commercial is over ...
});
manager.adEvent('AdNone', function(req, res) {
... Here you can place the code you want ...
... to run when there are no ads to play ...
});
app.intent("SomeYourIntent", function(req, res) {
if (you_want_to_start_commercial) {
return ad_manager.start(req, res);
// ad_manager.start returns Promise
}
});

where:

  • publisherId <Integer> *required - our manager or support team member will provide you with this value.

  • skillId <Integer> *optional - If you operate several Skills you can use that ID to track impressions separately. Please contact our team member to receive IDs.

  • preview <Integer> *optional - use it for debugging

How to check if everything is working

  • Modify your skill accordingly.

  • Use partnerId=1017 and preview=44, do not use any skillId flag for testing.

  • Start your skill and say what you need to activate intent with the ad.