A slot is a block of section of a page (or multiple pages) configured to allow replacing the content with a personalized version. The content shown in the slot is based on visitor information including, but not limited to: visitor’s location, interests, or pages visited; and defined by a campaign’s rules. Use slots with rules to test your visitors’ reactions to customized content, and ensure your marketing strategy works.
You can create slots by either clicking the webpage, manually embedding code, or using CSS selectors.
To create a slot:
Sign in to Personalization as an administrator.
Click Campaigns.
Find the campaign you want to edit, and then click the Edit link.
Click Save and continue to go to the Add or Edit Rules page.
Select Build or Build Experience, depending on your campaign type. The website displays, and the visual builder toolbars display.
Click the New Slot button in the left side of the lower visual builder toolbar.
Click the Point & Click Slot or Manual Slot option from the menu.
Note
To use Personalization on non-Drupal websites, use the Manual Slot method.
The page display changes, and any existing slots on the page are grayed out. Mousing over different elements of the page should highlight those elements.
Manual slots are slots created when you embed the code for the slot directly into your application, or define a specific CSS selector for the slot.
Click Manual Slot in the menu. The Create New Slot dialog box displays.
Provide the following information in the slot creation form:
You can use either the Embed code or CSS selector to define the slot.
If you are planning to use the Embed code, you click the copy-to-clipboard icon to copy the slot embed code.
If you are planning to define a custom CSS selector, click CSS Selector and enter the selector of your choosing.
Click Create Slot to save the slot.
If a page element has an HTML section which can be edited, you can add an embed code to the element. For example, to add code to a block, complete the following steps:
div
correctly.The block is now available as a slot for Personalization. The embed code is HTML, and will render in the webpage, but is not visible to the user.
Your new slot is now available for content.
You can manually enter a webpage element’s CSS selector(s) into the labeled field on a slot card. Personalization can use any selector or group of selectors defined with CSS to define your slot region.
You can enter one or more selectors into the field to define the slot region on the webpage.
The selector or group of selectors entered into the field:
must be unique across all the slots on your website.
must not belong to a page element whose parent or child element is also a Personalization slot.
must target an HTML block-level element on the page, such as:
p
li
div
h1
, h2
, and others)Note
Acquia doesn’t recommend using special-use tags such as image
,
canvas
, video
, br
, or hr
. These tags are too common to
work well for slots.
These restrictions ensure slots don’t overlap with each other on your webpage, and help prevent two slots from using the same region of your website.
An example of a selector group which is usable by Personalization:
#first-line div > p
Entering this code into the slot’s CSS Selector field enables Personalization
to use a paragraph in a div
that uses the ID first-line
as a
Personalization slot. You can change the CSS selector entered into the field on
the slot card at any time, which changes where the slot renders on the webpage.
Any rules you have created for the slot aren’t affected when you change the
slot’s CSS selector.
Define one page per line. Paths may use wildcard definitions and can start with “!” to exclude a particular pattern.
Path example | Description |
---|---|
/ |
This slot exists on the home or front page of your website. |
/* |
This slot exists on all pages of your website. |
/article/* |
This slot exists on all pages prefixed by /article/ on your
website. |
!/article/news/* |
This slot does not exist on all pages prefixed by /article/news/
on your website. |
Each slot can support multiple subpages on a customer’s site. The following table lists a few example target pages and their corresponding paths that you can add to your slot:
Target page | Path example |
---|---|
https://www.acquia.com/platform/drupal-hosting | /platform/drupal-hosting |
https://www.acquia.com/products/drupal-cloud/edge | /products/drupal-cloud/edge |
https://www.acquia.com/blog | /blog |
To edit or remove a slot:
When you delete a slot, the rules associated with the slot are cleared from the cache.
Note
If a slot has a published or scheduled rule, you can’t delete the slot. You will receive an error message that you can’t perform this action.