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.

It is through embedding a placement on your web pages that a visitor begins to interact with a strategy.

Create a placement

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 the placement has been created, you can link the placement with a strategy.

API

Use the following recipe to create a placement.

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

Deploy a placement

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.

FAQ

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