ÃÛ¶¹ÊÓƵ

DocumentationAudience ManagerAudience Manager User Guide

Audience Manager Identifiers (IDs) aam-ids

Last update: Tue Apr 13 2021 00:00:00 GMT+0000 (Coordinated Universal Time)

When submitting data privacy requests to ÃÛ¶¹ÊÓƵ Audience Manager, you must include one of the identifiers (IDs) listed below. You can find more information on the ID formats in our Index of Audience Manager IDs.

ÃÛ¶¹ÊÓƵ Audience Manager Unique User ID

  • User ID: aam_uuid
  • Definition: ÃÛ¶¹ÊÓƵ Audience Manager Unique User ID
  • Namespace ID: 0

JSON Example:

 "users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace": "0",
        "type": "namespaceId",
        "value": "85302821933904870272023537812382806531"
      },
      {
        "namespace": "0",
        "type": "namespaceId",
        "value": "85690090981158357332062532910972162921"
      }
    ]
  }
]
NOTE
You can also use the CORE namespace.
 "users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace": "CORE",
        "type": "standard",
        "value": "85302821933904870272023537812382806531"
      },
      {
        "namespace": "CORE",
        "type": "standard",
        "value": "85690090981158357332062532910972162921"
      }
    ]
  }
]

ÃÛ¶¹ÊÓƵ Experience Cloud ID

  • User ID: mid
  • Definition: ÃÛ¶¹ÊÓƵ Experience Cloud ID, formerly known as Visitor ID or Marketing Cloud ID
  • Namespace ID: 4
NOTE
You can also use the ECID namespace. See the second JSON example.

JSON Example:

 "users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace": "4",
        "type": "namespaceId",
        "value": "54893990981158357332062532910972162921"
      },
      {
        "namespace": "4",
        "type": "namespaceId",
        "value": "46990090981158357332062532910972162921"
      }
    ]
  }
]

 "users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace": "ECID",
        "type": "standard",
        "value": "54893990981158357332062532910972162921"
      },
      {
        "namespace": "ECID",
        "type": "standard",
        "value": "46990090981158357332062532910972162921"
      }
    ]
  }
]

Customer ID

User ID: cid

Definition: Customer ID, such as a cookie you set for anonymous site visitors or a CRM ID from an offline system or a hashed username.

Namespace ID: Customer-specific. Please find it from your Audience Manager instance.

JSON Example:

"users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace":"1234567",
        "type": "namespaceId",
        "value": "unique-user-id-for-datasource-1234567"
      },
      {
        "namespace": "1234567",
        "type": "namespaceId",
        "value": "another-unique-user-id-for-datasource-1234567"
      },
      {
        "namespace":"54321",
        "type": "namespaceId",
        "value": "unique-user-id-for-datasource-54321"
      }
    ]
  }

Mobile advertising ID

User ID: d_cid

Definition: Mobile advertising IDs.

Namespace ID:

  • IDFA: 20915
  • GAID: 20914

See Global Data Sources for more details.

IMPORTANT
If you are using the Mobile SDK, then you should also send the Experience Cloud ID (MID) along with mobile advertising IDs for complete Access and Delete responses.

JSON Example:

"users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace":"20914",
        "type": "namespaceId",
        "value": "e4fe9bde-caa0-47b6-908d-ffba3fa184f2"
      },
      {
        "namespace":"20915",
        "type": "namespaceId",
        "value": "AEBE52E7-03EE-455A-B3C4-E57283966239"
      }
    ]
  }
]

Integration code

User ID: d_cid_ic

Definition: An integration code for the data source. This can be used instead of data source ID / namespace ID in the API request to ÃÛ¶¹ÊÓƵ Experience Cloud Privacy Core Service.

Namespace ID: Not applicable

JSON Example:

"users": [
  {
    "key": "Example user 1",
    "action": [
      "access"
    ],
    "userIDs": [
      {
        "namespace": "loyaltyCard",
        "type": "integrationCode",
        "value": "272023537812"
      },
      {
        "namespace":"offlineCampaign",
        "type": "integrationCode",
        "value": "9546673332"
      }
    ]
  }
]
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695