Demandbase Partner Tag

Define the global window.DemandbasePartnerTag object before loading the Partner Tag script. Add the authentication key as the top-level auth property and add optional feature settings inside config.

<script>
window.DemandbasePartnerTag = {
  auth: "YOUR_PARTNER_KEY_HERE",
  config: {
    enableLR: true,
    enableIX: true
  }
};
</script>

<script src="https://tag.demandbase.com/partnertag.min.js" async></script>

<script>
window.DemandbasePartnerTag.fire();
</script>

The Demandbase Partner Tag is available through the global `window.DemandbasePartnerTag object.

The object contains:

The auth property contains the required partner authentication key.

Configure auth according to these requirements:

• Add auth as a top-level priority of window.DemandbasePartnerTag.
• Define auth before the Partner Tag script loads.
• Do not add auth inside config.
• Do not provide auth as a scriptdata-* attribute.

If the authentication key is missing or incorrectly configured, the Partner Tag fails to initialize.

window.DemandbasePartnerTag = {
  auth: "YOUR_PARTNER_KEY_HERE"
};

Add optional feature settings directly inside the config object. Property names are case-insensitive.

The following configuration options are supported:

Unsupported or nested configuration properties are ignored.

Example:

window.DemandbasePartnerTag = {
  auth: "YOUR_PARTNER_KEY_HERE",
  config: {
    enableLR: true,
    enableIX: true,
    enableEmailDomainReporter: false

By default, all advertising integrations are enabled, along with Smart Pixel and Email Domain Reporter.

The following rules determine how configuration changes affect these defaults:

Advertising options include enableLR, enableIX, enableMCTV, and enableRP.

For example, if you specify only enableLR: true, the other advertising options default to false.

Configure the Partner Tag with JavaScript

Use the config object to define feature configuration in JavaScript:

window.DemandbasePartnerTag = {
  auth: "YOUR_PARTNER_KEY_HERE",
  config: {
    enableLR: true
  }
};

Configure the Partner Tag with HTML Data Attributes

Use data-* attributes to configure Partner Tag features directly on the script element:

<script
  async
  src="https://tag.demandbase.com/partnertag.min.js"
  data-enable-lr="true"
  data-enable-mctv="true"
  data-enable-email-domain-reporter="false">
</script>

The authentication key cannot be provided with a data-* attribute. Define the required auth property on window.DemandbasePartnerTag before the script loads.

If configuration is supplied in multiple locations, the Partner Tag applies values in the following order:

1. window.DemandbasePartnerTag.config
2. Script data-* attributes
3. Default values

The Demandbase Partner Tag exposes a single public method:

fire() : Executes the Partner Tag and returns the raw IP API response as a Promise.

The Partner Tag initializes automatically after the script loads. After initialization, call:

window.DemandbasePartnerTag.fire();`

To access the raw IP API response returned by the Promise:

window.DemandbasePartnerTag.fire()
  .then(response => {
    console.log(response);
  });

No additional methods or internal objects are publicly accessible.

You can load the Partner Tag dynamically instead of including the script directly in your HTML.

Define authentication and configuration before adding the script to the page:

window.DemandbasePartnerTag = {
  auth: "YOUR_PARTNER_KEY_HERE",
  config: {
    enableLR: true,
    enableIX: true
  }
};

const script = document.createElement("script");
script.src = "https://tag.demandbase.com/partnertag.min.js";
script.async = true;
document.head.appendChild(script);

script.onload = () => {
  window.DemandbasePartnerTag.fire()
    .then(response => {
      console.log(response);
    });
};