CDP Integration

This page contains integration guides with various CDP solutions, of how to pass martechpass as declared ID.

Why Integrate Utiq martechpass with CDPs?

The martechpass enables CDPs to identify and unify user profiles more accurately, even across sessions, devices, and browsers. As a declared ID, it provides a reliable anchor for user data, enhancing personalization and activation potential.

Primary Use Cases

Audience Building & Activation: Collect traits and behaviors tied to martechpass, and activate audiences across owned media, AdTech platforms, or via data clean rooms.
First-Party Data Activation: Empower brands to activate customer insights without relying on third-party cookies or shared identifiers.

Learn more: Utiq Use Cases

Vendor Integrations

For each integration, Utiq recommends retrieving the mtid using onIdsAvailable via the addEventListener API, especially when embedding via third-party scripts.

Permutive

JS

window.Utiq ||= {};
window.Utiq.queue ||= [];

const handleIdsAvailable = ({ mtid }) => {
  // Callback action for onIdsAvailable
  if (window.permutive && typeof window.permutive.identify === 'function') {
    window.permutive.identify([
      {
        id: mtid,
        tag: 'utiq', // Ensure it's a registered identifier in Permutive CDP
        priority: 1
      }
    ])
  } else {
    console.error('Permutive is not available.');
  }
};

window.Utiq.queue.push(() => {
  window.Utiq.API.addEventListener('onIdsAvailable', handleIdsAvailable);
});

Ensure that ‘utiq’ is a registered identifier in Permutive CDP.

Documentation:

https://support.permutive.com/hc/en-us/articles/360010090580-Syncing-User-Identities

Testing: Look for localStorage permutive-data-misc containing utiq in identities. Also filter network for identify and check if mtid is part of the aliases object.

Adobe CDP

JS

window.Utiq ||= {};
window.Utiq.queue ||= [];

const handleIdsAvailable = ({ mtid }) => {
  // Callback action for onIdsAvailable
  if (typeof alloy === 'function') {
    alloy("sendEvent", {
      xdm: {
        "identityMap": {
          "utiq": [ // Ensure it's a registered identity namespace in Adobe CDP
            {
              "id": mtid,
              "authenticatedState": "ambiguous",
              "primary": false
            }
          ]
        }
      }
    });
  } else {
    console.error('Adobe CDP is not available.');
  }
};

window.Utiq.queue.push(() => {
  window.Utiq.API.addEventListener('onIdsAvailable', handleIdsAvailable);
});

Ensure that ‘utiq’ is a registered identity namespace in Adobe CDP.

Documentation:

Testing: Filter Network for interact and check attribute events.0.xdm.identityMap.utiq

ADEX

JS

window.Utiq ||= {};
window.Utiq.queue ||= [];

// Define your ADEX variables here
const adexCustomerId = <customerId>; // Replace <customerId> with your real Customer ID
const adexTagId = <tagId>; // Replace <tagId> with your real Tag ID

const handleIdsAvailable = ({ mtid }) => {
  // Callback action for onIdsAvailable
  window._adexc = window._adexc || [];
  const instancePath = `/${adexCustomerId}/${adexTagId}/`;
  window._adexc.push([instancePath, "cm", "_cm", [308, mtid]]) // '308' is Utiq's partner ID
};

window.Utiq.queue.push(() => {
  window.Utiq.API.addEventListener('onIdsAvailable', handleIdsAvailable);
});

Replace <customerId> and <tagId> with your real Customer ID and Tag ID.

'308' is Utiq's partner ID.

Documentation:

https://api.theadex.com/collector/v1/docs/index.html

Testing: Filter Network for 2.gif?axd_pid=308 and check attribute axd_fuid