Installation

This page outlines the changes that Partners will be required to make in order to integrate with XCover Elements(XCE), including all necessary changes to the existing XCover API integration.

Via CDN

XCE is initialized by loading a Javascript module via our CDN. Add the provided script to your head tag as follows:

// production env
<script type="module" src="https://xce.xcover.com/{partner}/{version}/xcover-elements.js" async></script>


// sandbox(test) env
<script type="module" src="https://sandbox.xce.xcover.com/{partner}/{version}/xcover-elements.js" async></script>

Please make sure that the script tag is present on pages where elements are expected to be used.

{partner} and {version} will be supplied by our team.

After loading the script it will automatically load our BrightWrite (BW) client side dependency via CDN. This is used to facilitate AB Testing on our panel.

Content Security Policy (CSP)

If your site uses a CSP, add the following origins to each directive so the integration can load scripts, reach its APIs, and display assets correctly.

script-src:

xce.xcover.com
cdn.brightwrite.com

connect-src:

api.xone.xcover.com
relay.xcover.com
cdn.brightwrite.com
brightwrite-data.com

image-src:

data:
xce.xcover.com
cdn.brightwrite.com

Sandbox: If you enforce CSP in your sandbox environment, replace xce.xcover.com with sandbox.xce.xcover.com in script-src and img-src. All other origins remain the same.