Articles on: Engage - Implementation
This article is also available in:

How to integrate an Engage element on my website?

Integrating an Engage element on your site is very simple. Here is how to proceed step by step.


Integrating the Engage SDK across your entire site


The Engage SDK is the foundation that allows you to display dynamic elements on your website.


To integrate the Engage SDK :


  • Add the script : Insert the following script on all pages of your site, replacing <your-app-id> with your Poool app identifier :


<script id="poool-engage" src="https://assets.poool.fr/engage.min.js" async></script>
<script>
const script = document.getElementById('poool-engage');
script.addEventListener('load', function () {
Engage
.init('<your-app-id>')
.autoCreate();
});
</script>
The autoCreate() method creates elements matching the conditions defined in the Dashboard. To take full advantage of Poool Engage's flexibility, we recommend using it in your integration.


If you want to force the display of an element manually, then the createElement() method will be appropriate. Keep in mind in this case: the conditions configured on the Dashboard side will not be applied.


  • Add your segmentation

If you want to activate specific segmentation based on your own characteristics, you need to pass custom filters in the autoCreate() method. More info on this in our article on custom filters.`


engage.autoCreate({filters:['value1', 'value2','value3']}):

Configuring the display of different formats


Once the script is integrated on your page, the Engage element activated on the Dashboard side will be displayed by default as an overlay.


For the Engage element to display in the desired location, you have several options depending on the desired final result :


Modal Format





To display the modal format, you can define its style via the parent container's CSS.


Example CSS to use for positioning and page effect :


#p3-parent-frame {
position: fixed;
margin: auto;
bottom: 0;
left: 0;
right: 0;
top:0;
overflow: hidden;
justify-content: center;
z-index: 1000;
}


Banner Format




To display it in banner format, you can define its location via the parent CSS in the Dashboard :




__Example CSS here to position it at the bottom of the page : __



#p3-parent-frame {
position: fixed;
margin: auto;
bottom: 0;
z-index: 80;
}


Tag targeting

You also have the option to choose the exact location of your element on the page via a tag present on your page.





  • In your page's HTML, integrate a div with an #id or .class attribute of your choice.


As an example, we create a div with the id "#fullscreen-widget". Here is what you need to integrate into your page's HTML :



<div id="poool-engage-banner"></div>
  • Use the condition named "Display in a target element" and insert the #ID or .class of the tag created on your site, in step 2.



Configuring the element in the Poool Engage Dashboard


Once the integration is complete, configurations can be made in the Dashboard.


Appearance


  • In the Dashboard, go to Engage > Elements > Create an element.
  • Customize the appearance of your element according to the desired format : columns, colors, button, form, etc.


More info in our dedicated section 👉 Engage - Appearances


To save time, feel free to browse the appearance templates available from your dashboard or consult our appearance catalogue. Our team can make templates available.


Display conditions


  • Define the specific conditions for displaying your element. For example, you can choose to display the element only after a certain number of visits, for visitors from a specific country, or only on mobile devices.


More info in our dedicated section 👉 Engage - Display conditions


Activating the element


  • Once the configuration is done, activate the element so that it is visible to your visitors according to the defined conditions.



By following these steps, you should be able to effectively integrate an Engage element on your site and improve the engagement, conversion, and retention of your visitors !


A question, an issue ? Contact us via chat !




Updated on: 29/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!