Manage Placements
This is a beta offering.
By using this documentation, you are agreeing to abide by the terms of the JWP Beta Program Agreement.
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 Placements list page, 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.
API
Use the following recipe to create a placement.
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 Header Method (Strongly Recommended) Site-specific embed script added to the <head>
element that locates and loads strategies into placement-specific<div>
elementsInline Method Embed script that loads a strategy into a specific placement on the page
- 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. - 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.
- Whether using a content management system (CMS), Google Ad Manager (GAM), Tag Manager, or some other method, the
-
(Optional) Provide custom data to be used when evaluating rules for a placement.
Provide custom data
Custom data can be added for a specific placement:
- Placement-level custom parameters: These parameters apply to a specific placement, such as a placement-level behavior.
Expand each of the following options to learn about the possible ways to add custom data:
Query Parameters
Custom data is added through a query string appended to the embed URL
Topic | Details |
---|---|
Parsing | Only at page load |
Supported Data Types | Strings |
Requirements |
|
Data Override Rules | Overridden by:
|
Example |
|
HTML Attributes (Required for Header Method)
Custom data is added through data attributes added to a JW placement <div>
element
Topic | Details |
---|---|
Parsing | Only at page load |
Supported Data Types | Strings |
Requirements |
|
Data Override Rules | Overrides:
|
Example |
|
jwDataStore
Custom data is added through attributes added at the page level.
Topic | Details |
---|---|
Parsing | At every rule evaluation |
Supported Data Types | All types |
Requirements |
|
Data Override Rules | Overrides:
|
Example |
|
Updated 16 days ago