Skip to main content

Power Opt-in

The power opt-in (POI) functionality allows you to share consent between multiple domains belonging to a base domain called Hub. Below we list the steps necessary to activate this feature:

  • Establish which server is where the consent cookie is stored, e.g. dominio-a.it.
  • A hub.html page containing a script will be provided, this page must be inserted in the root of the main domain (dominio-a.it/hub.html)
  • Create a MyGroupName.json file to specify which domains will be part of the POI group. This file will be inserted in a subfolder called /poi-lists (therefore resulting in the path https://dominio-a.it/poi-lists/MyGroupName.json) in the following format:
{
   "companyList": [
       "dominio-a",
       "dominio-b",
       "dominio-c"
   ]
}

Remember to enable CORS policies for the poi-lists directory.

  • In the SaaS, in the Cookie Banner section, under the PowerOptin Management item, specify respectively in the fields:
  • POI Group name: The name of the JSON file containing the domains belonging to the POI group;
  • POI Hub URL: the URL of the domain selected as hub (in this case https://dominio-a.it/);
  • POI hub path: path of the hub.html file with respect to the hub domain (in this case, since it is in the document root, it will simply be /hub.html).

In the generated global configuration object, these fields will be mapped like this:

{
   // ...
   "poi_activate_poi": true,
   "poi_hub_origin": "https://dominio-a.it/", 
   "poi_hub_path": "/hub.html",
   "poi_group_name": "GroupName", 
   // ...
}

When this functionality is activated by the saas, domain-a will be the hub for all the other domains included within the POI group (therefore also domain-b and domain-c), therefore these domains will share a single cookie between them of consensus. It must be kept in mind that the consent cookie is third-party, so if the browser is not enabled to read these cookies (general settings or through ad blockers), the functionality will not be activated. The optin will then be carried out individually for each domain and the consent cookie will not be shared.

When the page loads, the domains of the POI group insert an iframe of http://dominio-a.it/hub.html in their pages and check whether the consent cookie is present within that frame. If it is there, they insert it on the page, otherwise the banner appears normally.

In the event that consent is provided via a domain that is part of the group but which is not the hub itself (for example from domain-b.it), the consent cookie is inserted on the domain from which the consent was given and then, via the hub, also on dominio-a.it.