Installation
When using Osano CMP together with Adobe Launch you have 2 options for how to install the osano.js script.
- Direct install (recommended): place osano.js first in the <head> tag of your page so that it loads before Google Tag Manager
- Install via Adobe Launch (not recommended): Use Adobe Launch to manage your osano.js tag.
Please be aware that in order for Osano's obligations under the “No fines, No penalties” pledge (Section 4.7 of the Enterprise Terms of Service - Reimbursement of Regulatory Fines or Penalties) to apply, you must use the Direct Install method (in accordance with the documentation on this page) and be on the most up-to-date version of Osano CMP.
Direct Install
Osano.js can work on any platform and with any script manager or loader when added directly to the <head> element of a website. This means that Osano will work without having to do any additional configuration within Adobe Launch or other script management solutions, if you choose this install method.
Before you can install osano.js, you must first generate the script by creating and publishing a CMP configuration. Navigate to the "Consent Management" tab in my.osano.com and create a new Consent Configuration.
- You’ll need to provide your site’s domain name (e.g. example.com) and a URL to your privacy policy. Additional configuration is available after the initial creation.
- Click the Create Configuration button.
- Publish your new configuration by clicking the Publish button.
Once published, use the "Get Code" button to copy the osano.js script tag.
To install, simply copy and paste the osano.js code snippet into the header <head> for all pages you wish to monitor. Ensure that osano.js is the first script that loads on your site. If possible, we recommend testing in a staging/pre-production environment.
Once installed, all scripts and cookies will be discovered by the Osano cookie consent manager for classification.
Note: If your pre-production environment has different tags than your production environment, it will be beneficial to test in "Permissive" mode before switching into "Strict".
Adobe Launch contains some series of the following scripts:
- https://assets.adobedtm.com/xxx-xxx/launch-xxx.min.js = ESSENTIAL
- https://assets.adobedtm.com/extensions/xxx/AppMeasurement.min.js = ANALYTICS
- https://assets.adobedtm.com/extensions/xxx/AppMeasurement_Module_ActivityMap.min.js = ANALYTICS
These scripts must be classified individually for expected functionality.
Install via Adobe Launch
While it is possible to load osano.js via Adobe Launch, we strongly recommend loading it outside of Adobe in the site <head>. Osano cannot guarantee compliance if installed in this manner as Adobe Launch includes some standard tracking scripts that Osano cannot block when installed via Launch (see above).
To install the osano.js
In Adobe Launch, you can control the firing order of your rules and tags by using the "Load Order" feature. Here's how you can set the osano.js tag to fire first:
- Access the Adobe Launch Interface: Log in to your Adobe Launch account and navigate to the desired property.
- Go to Rules: Click on the "Rules" tab to view all the rules configured for your property.
- Edit the Rule: Locate the rule associated with the tag you want to fire first. If you haven't created a specific rule for the tag, you'll need to create one.
- Adjust the Load Order: In the rule configuration, find the "Load Order" section. Here, you can specify the load order for this rule relative to other rules. Set the load order to "First" or adjust it accordingly to ensure that this rule fires before others.
- Save Changes: Once you've adjusted the load order, save your changes to update the rule configuration.
- Publish Changes: After saving the changes, publish the updated configuration to ensure that the changes take effect on your website.
By setting the load order of the rule associated with your tag to "First," you ensure that this tag fires before any other tags associated with subsequent rules. This allows you to control the firing sequence and prioritize the execution of specific tags in Adobe Launch.
Related to