Audio experience

An audio experience allows you to combine an article audio with player and ad configurations into one experience.



Prerequisites

ItemDescription
Placement IDUnique identifier for the placement

Follow these steps to obtain the placement ID:
  1. On the Dynamic Strategy Rules page, on the Placements tab, click the name of the placement. The placement details page appears.
  2. In the row of the placement, copy the ID under the Placement ID column.
JWX StudioJWX Studio enabled on your account with an existing project
Article IDUnique identifier for the article

Follow these steps to obtain the article ID:
  1. On the Studio page, in the Projects section, click the name of a project. The project settings page appears.
  2. Under Article source, copy 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

Audio experience creation page

Follow these steps to create an audio experience:

  1. On the strategy tree, click + Add experience > Audio experience. The audio experience creation page appears.
  2. Under Configure your Audio Experience, enter a Name. This will appear as the identifier of the node in the decision tree.
  3. (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.

  4. 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 jwDataStore code, 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;
PlaceholderDescription
<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

© 2007- Longtail Ad Solutions, Inc.