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

On the Dynamic Strategy Rules page, on the Placements tab, click Create Placement. A new placement details page appears.
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.
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.

💰

ADVERTISING: Create a placement

Open Recipe

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

Deploy a placement

Follow these steps to deploy a placement:

On the Placements list page, click the name of the placement. The placement details page appears.
Under Embed Scripts, deploy the placement with either the Header Method or Inline Method.

Integration Embed Type	Description	Usage
Header Method	(Recommended) Site-specific embed script added to the `<head>` element that locates and loads strategies into placement-specific `<div>` elements	Loading multiple placements on a specific page
Inline Method	Embed script that loads a strategy into a specific placement on the page You can also load a placement in a different location than the embed script.	Loading a single placement on a specific page

📘
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.

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

FAQ

Can a placement be loaded in a different location than the inline embed script?

Yes.

To load the placement in a different <div> element than where the (inline embed script) is located, append the divId query parameter with the <div> element ID to the embed.js URL.

The following example loads the placement into a <div> element named loading-div.

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