VAST Tag Integration – Audiohook

To establish a VAST tag integration, please follow these steps:

Generate the VAST Tag URL: Start by generating the appropriate VAST Tag URL. Utilize the provided base_url and follow the parameter guidelines outlined below.

Complete and Sign Audiohook IO: Before proceeding with setting the VAST tag live, ensure that you complete and sign the Audiohook IO document. This document will be provided to you once the integration process is initiated.

Submit the Description of your Inventory: Fill out our form here to create a description that sells your inventory to advertisers looking to create their playlists.

Integration Activation: Once the Audiohook IO is signed, request the activation of the VAST tag integration by reaching out to publisher@audiohook.com. Our team will confirm the integration's live status and address any additional requirements.

Immediate Integration and Billable Monitoring: After the VAST tag integration is activated, impressions generated during the first week of live integration will be monitored and are billable based on their validity. Monthly reports will be sent to you, and you can subsequently send us an invoice for the provided services. Billable total impressions are derived from valid impressions received within an eight-hour window.

base_url = directvast.audiohook.com/{{publisher-id}}/vast?{{params}}

Example VAST:

https://directvast.audiohook.com/testPub/vast?feed-url=%%feed_url%%&episode-url=%%episode_url%%&ip=%%ip%%&ua=%%ua%%&vspec=4

Update macros and traffic in your ad server.

Here is a list of hosting platform support articles:

Megaphone

Art19

Omny/Triton

Recommended VAST tags:

For Megaphone users

https://directvast.audiohook.com/{{publisher-id CHANGE ME}}/vast?feed-url=%%rssurl%%&episode-url=%%mediaurl%%&placement-type=%%position%%&ip=%%ip%%&ua=%%ua%%&ord=%%cachebuster%%&vspec=4

For Art19 users

(different VASTs needed for pre, mid and post rolls)

https://directvast.audiohook.com/{{publisher-id CHANGE ME}}/vast?feed-url={{ PRIMARY FEED }}&episode-id={{ Episode ID }}&ip=header-x-device-ip&ua={{ DEVICE USER AGENT }}&vast-type=inline&placement-type=pre&hosting=art19&vspec=4

https://directvast.audiohook.com/{{publisher-id CHANGE ME}}/vast?feed-url={{ PRIMARY FEED }}&episode-id={{ Episode ID }}&ip=header-x-device-ip&ua={{ DEVICE USER AGENT }}&vast-type=inline&placement-type=mid&hosting=art19&vspec=4

https://directvast.audiohook.com/{{publisher-id CHANGE ME}}/vast?feed-url={{ PRIMARY FEED }}&episode-id={{ Episode ID }}&ip=header-x-device-ip&ua={{ DEVICE USER AGENT }}&vast-type=inline&placement-type=post&hosting=art19&vspec=4

We require ip, ua, vspec=4, feed-url (series-id for some hosts), and episode-url (episode-id for some hosts) parameters. Additional parameters depend on your hosting platform’s requirements and your desired parameters.

We require inventory-type if you have 2 or more of podcasts, streaming, radio or emerging inventory. For podcasts we recommend placement-type. For streaming and radio, placement-type=mid recommended.

Parameter	Required Field	Requires Macro	Default Value	Permitted Values	Example	Comment
ip	yes	yes	header-ip		%%IP%%	The IP Address of the User (only provided to attribution partners). If the IP address is passed in the header, please insert "header-{{key}}" where the key is the key that is used in the header (example: header-ip).
ua	yes	yes			%%USER_AGENT%%	The User Agent String of the User.
vspec	yes	no	2	4		This is the version of the VAST specification
feed-url	yes	yes		[all values]		This allows Audiohook to support brand safety integrations. Feed URLs should be URL encoded. Note that for some hosting platforms the series and episode id can be provided instead if the RSS feed is consistent
episode-url	yes	yes		[all values]		This allows Audiohook to support brand safety integrations. Episode URLs should be URL encoded. Note that for some hosting platforms the series and episode id can be provided instead if the RSS feed is consistent
series-id	no	yes		[all values]		This parameter should only be used in the case that the hosting provider does not support feed-url as a macro. Note that the hosting parameter is required when using this parameter.
episode-id	no	yes		[all values]		This parameter should only be used in the case that the hosting provider does not support episode-url as a macro. Note that the hosting parameter is required when using this parameter.
cpm	no	no			5.00	Publishers can pass an optional CPM floor. This value can also be set within Audiohook's platform but will not be dynamic.
inventory-type	no	no	podcast	[podcast,streaming,radio]		The type of content.
hosting	no	no		[all values]	art19	This parameter is required when using either the series-id or episode-id parameters.
player-domain	no	no		[all values]	domain.com	This parameter should be passed if the content is being played through a web player. It should be the domain of the website that the player is located.
vast-type	no	no	wrapper	[wrapper, inline]		Currently, by default, we serve VAST tags with wrappers. This replaces the historical inline parameter. REPLACE INLINE=1 WITH VAST-TYPE=INLINE
placement-type	no	no	post	[pre,mid,post]		If this is left blank, we will assign the inventory as post-roll.
genre	no	yes			%%SPORTS%%	Currently we support only one genre to be provided at a time.
bcat	no	no	None	[IAB1,IAB2,IAB3,IAB4,IAB5,IAB6,IAB7,IAB8,IAB9,IAB10,IAB11,IAB12,IAB13,IAB14,IAB15,IAB16,IAB17,IAB18,IAB19,IAB20,IAB21,IAB22,IAB23,IAB24,IAB25]	IAB3-2	This allows the publisher to block specific IAB advertiser categories. We support both parent categories and sub-categories. This field is not case sensitive.
badv	no	no	None	[all values]	example.com	This allows the publisher to block specific advertiser domains. Note that domains should not include http/https.
ord	no	yes			%%cachebuster%%	serves as a cachebuster, which is a unique value appended to the VAST tag URL to create a new and distinct ad request each time the VAST tag is called