Manage Placements

A placement serves as the container where a visitor's video experiences occur and is linked to a strategy. A strategy uses a set of rules to determine the specific experiences displayed within that placement.

A visitor can begin interacting with a strategy when a placement is embedded on your web page.

Create a placement

🔑

If you are a developer or have developer resources, you can programmatically create placements with the Platform Management API.

Follow these steps to create a placement from your JWP dashboard:

1. On the Dynamic Strategy Rules page, on the Placements tab, click Create Placement. A new placement details page appears.
2. Click the default name (Untitled Placement Name) to rename the placement. Though not required, giving a placement a unique name allows it to be quickly distinguished from other placements.
3. Click Save.

Now that the placement has been created, you can link the placement with a strategy.

Deploy a placement

You can deploy a placement using either a standard deployment or a single page application (SPA) deployment approach.

The method you choose depends on the structure of your site.

Standard deployment

Follow these steps to deploy a placement:

1. On the Placements list page, click the name of the placement. The placement details page appears.
   

   💡

   You can also access the placement information from a strategy:

   1. On the Strategies tab, click the name of a strategy. The decision tree of the strategy appears.
   2. Click Settings. The Strategy settings panel opens.
   3. Under Linked placements, in the row of the placement, click ⋯ > View embed scripts. The placement details appear.
      

2. Under Embed scripts, deploy the placement with either the Header method or Inline method.
   

   📘

   When accessed from within a strategy, the embed scripts appear without the Embed scripts section header.

   Be mindful of the following when deploying the placement:

   • Whether using a content management system (CMS), Google Ad Manager (GAM), Tag Manager, or some other method, the <div> must be on the page on the initial DOM load. For these use cases, use the inline method.
   • A given placement ID can only be used in one <div> element per page. However, a placement ID can be used on multiple pages.
   • If the placement ID is invalid, the <div> element will remain empty.

3. (Optional) Provide custom data to be used when evaluating rules for a placement.

Single page application deployment

Follow these steps to deploy a placement:

1. On the Placements list page, click the name of the placement. The placement details page appears.
   

   💡

   You can also access the placement information from a strategy:

   1. On the Strategies tab, click the name of a strategy. The decision tree of the strategy appears.
   2. Click Settings. The Strategy settings panel opens.
   3. Under Linked placements, in the row of the placement, click ⋯ > View embed scripts. The placement details appear.
      

2. Under Embed scripts, deploy the placement with the Inline method.
   

   📘

   When accessed from within a strategy, the embed scripts appear without the Embed scripts section header.

   Be mindful of the following when deploying the placement:

   • A given placement ID can only be used in one <div> element per page. Be sure the placement <div> is destroyed and reloaded when transitioning to new pages. You can use useEffect to append or remove the script tag manually.
   • Whether using a content management system (CMS), Google Ad Manager (GAM), Tag Manager, or some other method, the <div> must be on the page on the initial DOM load.
   • If the placement ID is invalid, the <div> element will remain empty.
   • You can also load a placement in a different location than the embed script.
     

3. (Optional) Provide custom data to be used when evaluating rules for a placement.

FAQ

<script src="https://cdn.jwplayer.com/v2/sites/{site_id}/placements/{placement_id}/embed.js?divId=loading-div"></script>