Skip to content

Web placement

A placement is web content that a journey shows to a user right on your website: as a popup over the page or as an inline block inside it. Add the Web Placement element to a journey to show web content to the users who reach this step, the next time they open a page of your site or right after an event, such as adding an item to the cart.

Unlike a web popup campaign, which targets every visitor that matches its rules, a placement is personal: only the users who reach this step see it, and it is shown only within the lifetime you set.

Requirements

Anchor link to

Prepare your website

Anchor link to
  1. Use Web SDK 3.108.1 or later.
  2. When a visitor signs in, call setUserId with the same user ID the user has in Pushwoosh. Placements are delivered by user ID: without setUserId, the site gets only the placements queued for this browser itself, not those of the signed-in user.
  3. For inline placements, add the elements the blocks go into, for example <div id="cart-slot"></div>.

Add the element

Anchor link to

Drag the Web Placement element onto the canvas from Channels.

Channels list of the journey canvas with the Web Placement element boxed in red

Configure the placement

Anchor link to

Click the element to open its settings and set the following.

Choose the content

Anchor link to

In Web pop-up content, select the web content to show.

To show products from your catalog in the placement, add a Products block to the content.

Choose popup or inline block

Anchor link to

Choose whether the content opens over the page or sits inside the page itself.

PopupInline
Where it appearsOver the page.Inside an element of your page, for example a free-shipping banner in the cart.
How long it is shownOnce.On every page that has the element, until its lifetime ends, the user closes it, or the hide event happens.

For Inline, also set:

  • CSS selector of the element: the element the block goes into, for example #cart-slot. Up to 255 characters. The element must already be on your site.
  • Width: the CSS width of the block, for example 100% or 320px. Leave it empty to keep the element’s own width.
Web Placement settings with Free shipping nudge with cart items in Web pop-up content, Inline selected, #pw-cart-slot as the CSS selector, and 100% width

Set the priority

Anchor link to

Priority decides which placement the user sees when several placements target the same page element or several popups are due at once: the one with the highest priority. On a tie, the newest.

In Priority, choose High, Medium (default), or Low.

Priority set to High

Set the lifetime

Anchor link to

Lifetime is how long the placement waits for the user and stays on the site. If the user doesn’t visit your site within the lifetime, the placement isn’t shown.

In Lifetime, enter a number and choose minutes, hours, or days. The range is from 1 minute to 7 days, and the default is 1 hour.

Lifetime of 2 days

Limit popup shows per day

Anchor link to

The same user can reach this step several times, for example when they re-enter the journey or pass a Loop. To limit how often they see the popup, set a daily limit.

In Show at most, times a day, enter a number from 0 to 100. 0 means no limit. The limit counts popups from this Web Placement element. Inline blocks don’t have it.

Show at most, times a day set to 3

Choose whether users can close an inline block

Anchor link to

By default, a visitor can close an inline block with the ✕ button or with a button of the content that has the Close the popup action, for example Keep shopping.

To keep an inline block on the page, turn off The user can close it. The block then has no ✕ and doesn’t show the content’s Close the popup buttons. A popup can always be closed, whatever this setting is.

The user can close it

Choose when to show the placement

Anchor link to

In Show, choose:

  • On the next page view: the placement appears as soon as the user opens any page of your site.
  • On event: the placement waits for the event you select and appears right after the user triggers it. Optionally, click Add condition to filter the event by its attributes.
Show section with On the next page view selected and On event as the other option

Hide the placement after an event

Anchor link to

To take the placement off the site when the user does something, for example places an order, turn on Hide after an event and select the event. The placement is removed when the event happens, whether or not it was shown.

Hide section with Hide after an event turned on and PW_OrderCreated selected as the event

Placements of a user are also removed when the user leaves the journey or the journey is stopped.

Preview on a test device

Anchor link to

To see how the placement looks on your site before you launch the journey, show it on a test device:

  1. In Preview, select a test device of the application. The device must be a browser with your website open.
  2. Click Show on test device.
  3. On that device, open or reload a page of your site.

The placement appears on that page and stays for 1 hour, whatever you chose in Show.

The preview uses the settings you have in the form right now, so you can check it before you save the journey. It isn’t counted in the journey statistics.

React to shows, clicks, and closes

Anchor link to

What visitors do with a placement shows whether it worked. For example, you can send a follow-up to users who ignored a free-shipping offer, or count the users who clicked it. For this, a placement reports three events: it was shown, clicked, or closed.

Placement events

Anchor link to

A placement sends three events for the user:

EventSent when
PW_WebPlacementShowThe placement is shown. An inline block counts as shown when it scrolls into view.
PW_WebPlacementClickThe user clicks a link or button in the placement, except a close button.
PW_WebPlacementDismissThe user closes the placement with ✕ or a Close the popup button.

Each event has the content_code attribute with the code of the web content. Use it in conditions to tell placements apart.

Use the events

Anchor link to

Use the placement events to send follow-up messages depending on what the user did, and to measure results.

Branch the journey

Anchor link to

Add a Wait for Trigger element after Web Placement to send a follow-up depending on what the user did, for example a push to users who didn’t click the offer. The user moves on to the next element as soon as the placement is queued for them, not after they react.

Measure conversions

Anchor link to

Add a placement event or an order event as a conversion goal in the journey settings to count the users who reached it.

For a full example with a free-shipping offer, a follow-up push, and a conversion goal, see How to show a website offer with Web Placement.

Placement statistics

Anchor link to

To check how a placement performs, look at the Web Placement element on the canvas or in the element details of a running journey:

  • Shown: how many times the placement was shown.
  • Interactions: how many times it was clicked.