Create and embed an outstream player

Learn how to create an outstream player from your JWP dashboard and to embed it directly on-page or via a GAM ad tag.


Outstream video ads (also referred to as native or “in-read” ads) run inside of text article pages without requiring any video content. JWP's outstream player is purposefully designed to simplify the delivery of outstream video advertising across your sites and offers the following benefits:

  • Only appears to a viewer when the player is viewable and has a successful ad request
  • Can be dismissed by the viewer
  • Can minimize to a corner of the window when a user scrolls the player out of view
  • Can display an advertisement label above the player
  • (Google Ad Manager only) Ability to embed an outstream player through an ad tag

🔑

If you are a developer or have developer resources, follow our developer instructions for embedding an outstream player.



Requirements

ItemDescription
Ad tag(VAST, IMA) You must have an ad tag from your ad server, creative agency, or advertiser.
JWP license and entitlementYou must have Outstream enabled for your account.
JWP library 8.14.0+Outstream player functionality is fully supported only from JWP 8.14.0.


Create an outstream player

  1. From the Players page, click Create Web Player.
  2. (Optional) Click Untitled Player to rename the player.
  3. Follow the steps to enable and configure advertising.

    📘

    Be sure to enable the outstream settings in step 7.



Embed an outstream player


On-page embed

  1. Create an oustream player. If you have an existing outstream player, continue to the next step.
  2. Within the <body> of your page, copy and paste the following code snippet.

    📘

    Be sure to replace {CLOUD-HOSTED_PLAYER_LIBRARY_URL} with the cloud-hosted player library URL you copied from your JW Player dashboard.

<script src="{CLOUD-HOSTED_PLAYER_LIBRARY_URL}"></script>
<!-- JW Player <div> and setup script -->
<div id="jwp-outstream-unit"></div>

<script>
    jwplayer("jwp-outstream-unit").setup({});
</script>


GAM Ad Creative Embed

If you use Google Ad Manager to manage ad campaigns, you can follow these steps to embed an outstream player:

  1. Create an oustream player. If you have an existing outstream player, continue to the next step.
  2. In a text editor, copy and paster the following code snippet.

    📘

    Be sure to replace {CLOUD-HOSTED_PLAYER_LIBRARY_URL} with the cloud-hosted player library URL you copied from your JW Player dashboard.

<script src="{CLOUD-HOSTED_PLAYER_LIBRARY_URL}"></script>
<!-- JW Player <div> and setup script -->
<div id="jwp-outstream-unit"></div>

<script>
    jwplayer("jwp-outstream-unit").setup({});
</script>
  1. In GAM, create a custom creative.
  2. When configuring the custom creative, set the Code type to Standard.
  3. Copy and paste the code from your text editor (step 2) into your GAM UI.
  4. Complete your GAM line item setup.