Web SDK

Learn how to embed an Amondo Imprint on your website using the Web SDK.

Overview

The Amondo Web SDK allows you to embed Imprints directly into your website or web application. It provides options for configuration, analytics, and event handling so you can fully control the integration.

Use the Web SDK if you want to:

• Display a published Imprint on your website

• Configure analytics and cookie consent

• Capture and respond to Amondo events

Installation

Include the SDK by adding the following script to your page:

<script async defer src="https://static.amondo.com/web-sdk/4/amondo-web-sdk.js" onload="amondo_init()"></script>

The script will always load the latest version 4 of the SDK. If you need a specific version, see Using a Specific Version.

Options

When creating an Imprint, you can pass the following options:

{
  id: "UUID",                    // required
  isCookieConsentGiven: boolean, // optional
  isAnalyticsEnabled: boolean,   // optional
  analytics: {                   // optional
    distinctId: string,          // optional
    options: Record<string, any> // optional
  }
}

General options

id The unique Imprint identifier. Required.

isCookieConsentGiven Boolean value indicating whether cookies may be set. Default: false.

isAnalyticsEnabled Boolean value enabling or disabling analytics tracking. Default: true.

Analytics options

analytics.distinctId Custom user identifier for analytics tracking.

analytics.options Additional properties sent alongside each analytics event.

Basic usage

Add a container element and initialize the SDK:

<div id="amondo-container"></div>

<script>
  function amondo_init() {
    var container = document.querySelector("#amondo-container");
    amo.imprint.create(container, {
      id: "00000000-0000-0000-0000-000000000000",
      isCookieConsentGiven: false,
      isAnalyticsEnabled: false
    });
  }
</script>

## Using a specific version

The default link always points to the latest SDK in version 4:

```javascript
https://static.amondo.com/web-sdk/4/amondo-web-sdk.js

If needed, you can lock to a specific version by editing the URL, for example:

https://static.amondo.com/web-sdk/4.2.1/amondo-web-sdk.js

Advanced configuration (optional)

• Styling with CSS variables

• Embedding multiple Imprints on one page

• Lazy loading / dynamic embedding

Troubleshooting

Common issues when using the Web SDK:

• Imprint not loading → Check the id value is correct and from the production environment.

• Analytics not working → Ensure isAnalyticsEnabled is set to true and cookie consent is given.

Related pages

• CSS Variables

• Analytics Overview

• API Reference