Audio experience
An audio experience allows you to combine an article audio with player and ad configurations into one experience.
Prerequisites
| Item | Description |
|---|---|
| Placement ID | Unique identifier for the placement Follow these steps to obtain the placement ID:
|
| JWX Studio | JWX Studio enabled on your account with an existing project |
| Article ID | Unique identifier for the article Follow these steps to obtain the article ID:
|
Set up an audio experience
To set up an audio experience, you must create an audio experience and define the key for retrieving Studio media.
Create an audio experience

Audio experience creation page
Follow these steps to create an audio experience:
- On the strategy tree, click + Add experience > Audio experience. The audio experience creation page appears.
- Under Configure your Audio Experience, enter a Name. This will appear as the identifier of the node in the decision tree.
- (Optional) Under Media retrieval key, enter the Key for retrieving Studio media.
This field is prepopulated and should always be set to external_id, unless explicitly instructed otherwise by your JWX representative.
Changing or removing this value will prevent JWX Studio media from being correctly associated with the corresponding article on your site.
- Click Done.
Define the key for retrieving Studio media
To learn more about adding custom data to a placement, see Provide custom data to a placement.
On the article page (on your site), set a key-value pair in either the embed script or jwDataStore.
If you use the
jwDataStorecode, this client-side code must occur before the placement embed script loads the player.
// Append the following query parameter to the placement embed script.
?&custom.<placement-id>.<key>=<value>
const jwDataStore = window.jwDataStore || { custom: {} };
jwDataStore.custom.<placement-id> = { <key>: "<value>" };
window.jwDataStore = jwDataStore;
| Placeholder | Description |
|---|---|
<placement‑id> | Unique identifier for the placement |
<key> | Key for retrieving a JWX Studio media This value should always be external_id, unless explicitly instructed otherwise by your JWX representative. |
<value> | JWX Studio article ID Example: my-article-123456 |
Updated about 4 hours ago
