Ingest and Model Digital Identifiers for JSON-based External Activation Targets

Ingest and model your digital identifier data by using the standard ContactPointDigitalId data model object (DMO). Independent Software Vendors (ISV) use the activation toolkit to build activations that query this DMO to resolve digital identities across digital media platforms.

Required Editions

Available in: Lightning Experience

Available in: Developer, Enterprise and Unlimited Editions

Note To activate anonymous digital identifiers, it's recommended to use ContactPointDigitalID DMO instead of mapping the digital identifiers to custom fields on the Individual DMO.

Before mapping your data, it’s important to understand the target blueprint. Map your source identifiers to the ContactPointDigitalId DMO. For activations to work, this DMO must have an established Many-to-One (N:1) relationship to the Individual DMO (linking ContactPointDigitalId.ssot__IndividualId__c to Individual.ssot__Id__c). You can verify or create this relationship in the Data Model tab. This mapping is mandatory when you use the activation toolkit for JSON-based external activation platforms that rely on specific digital identifiers (for example, UID2, RampID).

Note

If your activation only targets email or phone-based destinations (by using ContactPointEmail or ContactPointPhone), this DMO is optional, though it’s recommended to centralize all digital identities here.

Prepare Your Source Data

You can ingest data via multiple methods, including CSV/File ingestion, Ingestion API, or WebSDK. Regardless of the ingestion method (batch or streaming), your source data structure must support the granular mapping required by the DMO. Pivot your source data so that you have one column for the identifier's type and another for its value.

Example

Example Source Data Structure

Individual_ID	FirstName	Digital_ID_Type	Digital_ID_Value
1001	Ana	TD ID	cdcbe3dd-8fe3-44d6-a4b3-ba55e4400000
1001	Ana	GoogleID	584eb2cf-182c-409a-b1f0-9a4827179841
1002	Bob	TD ID	74e6751f-8f86-4dbb-a96e-d9123456789

Note The 'Digital ID Type' and 'Digital ID Value' are specific fields on the ContactPointDigitalId DMO. Your source data must be explicitly mapped and ingested into these fields.

Configure the ID Type Mapping

Before you begin mapping your data stream, make sure that the identifier types in your source data perfectly match the configuration in the Data 360 Setup page.

As a Data 360 Admin user, go to Data 360 Setup > External Activation Target > [Target Name] > ID Type Mapping and configure the ID type mapping.

The exact string value in your source data's Digital_ID_Type column (for example, "TD ID") must perfectly match the string configured in the ID Type column by the Data 360 administrator. Because Data 360 uses this string as a strict filter during activation, a case-sensitive mismatch (for example, a value in your data might appear as “TDID,” whereas the Data 360 setup lists it as “TD ID”) results in zero activated records.

Create and Map Your Data Stream

After preparing your source file, create your data stream and map it to the standard DMOs.

Note Data 360 doesn’t automatically link new DMOs. After you complete these mapping steps, you’ll likely need to create the relationship manually between ContactPointDigitalId and Individual.

1. Create a data stream and point it to your data source.
2. In the mapping canvas, map your profile data to the Individual DMO.
   • Map Individual_ID -> Individual.IndividualId
   • Map FirstName -> Individual.FirstName
   • If you're activating anonymous users, you don't have standard profile data like a First Name or a known Customer ID. In this case, you must use a persistent digital identifier (such as a Device ID or Cookie ID) to act as the individual's profile ID. Map this value to the ssot__IndividualId__c field to represent the anonymous individual in the data model.
3. In the mapping canvas, map your source fields from the data lake object (DLO) to the specific fields on the ContactPointDigitalId DMO. Correct field-level mapping is critical to prevent zero population errors during activation.

   Target Field (ContactPointDigitalId DMO)	Source Field Description	Notes
   ssot__Id__c (Primary Key)	Unique record ID (for example, Device ID, Event ID, or UUID)	This must be a unique key for the record itself (For Example, device_id or event_id). Don’t map the Digital ID value here.
   ssot__IndividualId__c	Individual ID	Links this digital ID to a specific profile.
   ssot__DigitalIdType__c	Type string (for example, "TDID", "GoogleID")	This identifies what kind of ID it is. This ID is case-sensitive.
   ssot__DigitalIdValueText__c	The actual ID token	The alphanumeric string used by the platform (For Example, the UID2 token).

4. Map the relationship field that links the two objects. This step is critical.
   • Map Individual_ID -> ContactPointDigitalId.IndividualId__c
   • Verify or create the Data Model relationship. Go to the Data Model tab and make sure a Many-to-One (N:1) relationship exists between ContactPointDigitalId and Individual. If it doesn’t exist, create it manually by linking ContactPointDigitalId.ssot__IndividualId__c to Individual.ssot__Id__c.

This mapping creates the correct, related data structure that is required for activations.

See Also

• Salesforce Help: Map Data Model Objects
• Salesforce Help: External Activation Platforms