Creating and publishing a pop-up
Step 1. Creating a pop-up
1. Go to "Weblayers" → "Pop-ups" and click "+ Create" at the top of the page:
2. Select pop-up type:
-
Pop-up Modal is a pop-up window that appears in the center of the screen. It attracts the user's attention as it darkens the background of the browser. Typically used to collect email addresses.
-
Floating Bar is a customizable panel that is located at the top or bottom of the page. Remains visible on the screen even when scrolling the page. Suitable for informing customers about news or limited offers.
-
Slider is a small window that appears in the lower right corner of the page. It is less intrusive and does not interfere with the visitor's viewing of the page content. Drop-down boxes can be used to display additional information, suggestions, or feedback forms.
-
Page Takeover is a pop-up window that takes up the entire browser screen. This ensures that visitors do not miss the information presented. However, full-screen windows should be used with caution, as they can be perceived as intrusive advertising and cause dissatisfaction among users.
3. Select pop-up template. The platform already has several ready-made templates. Use any of them as a base. In the next step, you can completely change the template (set text, styles, customize fields, etc.) and customize it to suit your needs.
4. Set the system name of the popup and add a description if necessary. You can also set tags for quick search and assign access groups .
Step 2. Change text and design
The appearance of the popup is set using parameters. The options contain text, image, and CSS styles for various elements. For example, the text
parameter contains the main text of the popup, the backgroundColor
parameter contains its background color.
There are two tools available for working with popup content:
-
Editing parameters in a visual editor. Suitable for users not familiar with the code. To change the appearance of the popup, just enter text, select images from the gallery, or use color palettes.
-
Change HTML, CSS and JavaScript in the code editor. Suitable for users who want to work directly with the pop-up code.
Any changes made in the editor are displayed in the preview window in real time. To check how the popup will look on different devices, use the buttons in the upper left corner:
Visual editor
To customize the text and change the appearance of the pop-up window in the visual editor, go to the "Design" section. In this section, all parameters are divided into categories:
- Copywriting
- Background
- Frame
- Form
- Actions
- Close Button
- Image
- Typography
On the "Copywriting" tab you can set the text of the popup. The following options are available:
- title — title;
- text — main text;
- <field>Label — label for form fields.
- <field>Placeholder — text tooltip inside the form field.
You can add a </>
variable to any text element to dynamically pull profile data into the pop-up. You will find a description of the variables in this article.
The following options are available on the Background tab:
- backgroundColor — background color of the popup.
- backgroundImage URL — Background image of the popup. Upload the image to platform gallery or provide a URL.
- overlay — background color of the browser page. When a popup appears, the background of the page is darkened, and using the palette you can change the color and transparency of the darkening.
The following options are available on the Background tab:
- backgroundColor — background color of the popup.
- backgroundImage URL — Background image of the popup. Upload the image to platform gallery or provide a URL.
On the "Border" tab, you can configure the borders of the pop-up window. The following options are available:
- borderRadius – rounding of popup borders in pixels. You can set the rounding for each corner separately .
- width — border thickness.
- color — border color.
On the "Form" tab, fields for data entry are configured:
- validation is set;
- indicates the error text that the user will see if he enters incorrect data;
- CSS styles of form fields are edited.
Validation:
- Required — The user must fill out this field before submitting the form. If the field is left empty, he will see the error message Allowed to enter only Cyrillic characters.
- Cyrillic characters only — only Cyrillic characters can be entered.
- Only symbols of the Latin alphabet — only Latin characters are allowed to be entered.
- Email Validation — the entered value must match the email format.
- Phone number validation — the entered value must match the phone number format.
- Validation via regular expressions — it is possible to use custom regular expressions to define your own input field validation rules.
- Limit Numeric Value — sets the minimum and maximum value for the numeric field.
- Limit the number of characters — limits the number of characters that can be entered in the field.
- Answer Options — used for fields with predefined answer options. You can specify valid answer options and the user must select one of them. If the user selects an invalid option, an error message will be displayed.
- Error message — this text will be seen by the user if he enters data that does not meet the validation conditions. The error message is specified for each field separately.
Window styles:
- paddingVertical — padding between the button and the bottom border of the popup.
- paddingHorizontal — padding between the fields and the left border of the popup.
- width — popup width
- fieldsGap — distance between form fields, incl. between field and button
- borderWidth — width of the border of the input fields
- borderColor — color of the border of the input fields
- borderRadius — rounding of the borders of input fields. You can set the rounding for each corner separately .
Field styles with type input:
- inputPaddingVertical — indentation of the placeholder text from the top and bottom borders of the input field
- inputPaddingHorizontal — indentation of the placeholder text from the left border of the input field
- inputFontSize — placeholder text font size
- inputBackgroundColor — background text of the input field
- inputColor - the color of the text that the user enters into the field
- inputHoverColor — color of the input field border when hovering the cursor
- inputActiveColor — color of the border of the input field when clicked with the mouse button
Field styles with checkbox type:
- checkboxSize — checkbox font size
- checkboxLabelFormatting - formatting the checkbox text
Error message styles:
- errorColor — error message color
- errorFontSize — font size in the error message
- inputErrorBorderColor — color of the input field border when an error message appears
- inputErrorBackgroundColor — background text of the input field when an error message appears
Note that only one form can be created in the visual editor. To add more, use the code editor.
On the "CTA" tab, you can edit the text of the button and its CSS styles. The following options are available:
- text — text of the button to submit the form.
- textFormatting — formatting the text in the button.
- borderRadius — rounding of the button borders. You can set the rounding for each corner separately
- backgroundColor — background color of the button.
- hoverBackgroundColor — background color of the button when hovered.
- color — text color in the button.
- fontSize — text size in the button.
- paddingVertical — padding of the button text from the top and bottom borders.
- paddingHorizontal — padding of the button text from the right and left borders.
This tab allows you to select the appearance of the button that allows the user to close the pop-up window. Parameter — closeButton.
On this tab, an image is added to the popup. Not all ready-made templates provide this feature.
- image URL — URL address of the image. You can download images from platform gallery .
- width — image width in pixels. The height changes in proportion to the specified width.
On the Typography tab you can change the CSS styles of all text elements:
Category | Parameter | Description |
---|---|---|
General font | fontFamily | The font family that is used in all text elements of the popup. |
Heading | titleAlign | Title alignment (left, center, right) |
titleFontSize | Title font size | |
titleFormatting | Format text in the header (underline, italic, bold, strikethrough) | |
titleColor | Text color in title | |
Body text | textFontSize | Font size in the main text of the popup |
textAlign | Body text alignment (left, center, right) | |
textFormatting | Body text formatting (underline, italic, bold, strikethrough) | |
textColor | Body text color | |
Label | labelFontSize | Font size in field label |
labelFormatting | Format text in a label (underline, italic, bold, strikethrough) | |
labelColor | Label color |
Code editor
To work directly with the code, go to the "Settings" section. Recommendations for layout of a popup in the editor are collected in this article.
Step 3. Setting up actions after filling out the pop-up form
Go to the "Actions" section. Here you can define the actions that need to be performed after the user fills out and successfully submits the popup form:
- Import profiles allows you to load the data of the user who filled out the form into one or more databases;
- Sending a form by email activates sending notifications about form completion to the specified email addresses.
The actions after filling out the popup form are similar to the actions after filling out a standard web form. You can read more about setting up actions in this article.
Step 4. Publish a pop-up on the site
There are two mechanisms available for displaying a popup on the site:
-
Adding a script to a site page manually — this method is used for direct access to popup management. The conditions for displaying a popup must be implemented independently.
-
Adding a script through Tag Manager is an easier way. It is enough to place the container code once on the site pages, and all further settings of the popup, including the conditions for its appearance, are set in the platform interface.
Adding a script manually
1. Save all the specified settings and make sure that the popup status is "Active". Then click the "Publish" button:
2. In the additional actions menu, click . On the right, a window will appear where you need to select databases to search for profiles. Matching data can be sent along with the popup data request from the server. If a profile with such data is found in one of the selected databases, its information will be updated; otherwise, a new profile will be created in the database.
3. Click the "Show Code" button at the bottom of the page. Copy the popup code and give it to the developers so that they can add it to the required pages of the site.
Please note that here you specify the databases for searching existing profiles. The data of users who filled out the form in the popup will be imported into the database specified in the "Actions" section.
Adding a script via Tag Manager
1. Save the popup using the button on the top panel. After this, the "Appearance" section will become active. Go to it.
2. Click "Bind" to bind the popup to a container in Tag Manager:
3. Select container or create a new one.
4. Enter tag name. A tag is a piece of code that is executed on a website under certain conditions. In this case, the tag is a popup display.
5. Set activation settings and limits for the tag to be executed.
6. Select triggers or create a new one. A trigger is a condition for executing a tag. Triggers track specific events on a site (such as clicks or page loads) and fire tags in response to those events. In this case, the trigger will start displaying the popup.
7. To set more specific conditions for a popup to appear, use a filter. To do this, in the "Trigger activation conditions" block, select "Some events" and configure the filter:
8. Save the tag. The specified condition for displaying the pop-up will be displayed in the "Appearance" section:
9. Save the popup and publish.
10. Go to the linked container andpublish the new version. After this, the popup will be shown to site visitors when the event specified in the trigger occurs.
Profile matching
You can independently identify a site visitor and transfer data about him to the platform using the acDataLayer.push()
method. If the system finds a profile in the database, it will update its data.
Example:
acDataLayer.push({
matching: {
matching_mode: "email",
matching: { email: "test@example.com", db_ids: [1, 2] },
},
});
- matching_mode — profile search mode; can take the following values: "email", "email_profile", "phone", "profile_id" or "custom".
- matching — an object with one or two parameters: "field to search": "field value" and "db_id": "Database ID" - databases in which to search for the profile.
Step 5. Analyze the results
You can analyze pop-up statistics and view the results of filling out the form in the "Analytics" section. To do this, click on the icon in the pop-up editing window or in the general list of popups.