Salesforce Data 360 Connector Setup Guide

Demo

Requirements

This connector requires the following Salesforce Data 360 resources:

• An Ingestion API source configured with the objects and fields you want to receive from Tealium
• A data stream for the Ingestion API source
• A Connected App or External Client App with access to the Data 360 Ingestion API

For more information, see Salesforce: Connect an ingestion source.

API information

This connector uses the following vendor API:

• API Name: Salesforce Data 360 Ingestion API
• API Version: v1
• API Endpoint: Salesforce Data Cloud Ingestion API

Configuration

Go to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

• Salesforce Domain
  • (Required) The My Domain URL for your Salesforce organization, for example, https://company.my.salesforce.com. The client credentials flow requires a My Domain URL. Other Salesforce hosts return a request not supported on this domain error.
• Client ID
  • (Required) The Consumer Key from your Salesforce Connected App or External Client App.
  • The app must have the client credentials flow enabled, a Run As user configured, and the cdp_ingest_api and api OAuth scopes.
  • Set the callback URL for the connected app or external client app to https://my.tealiumiq.com/oauth/salesforce/callback.html.
  • If Salesforce returns no client credentials user enabled, verify that a Run As user is configured. This error doesn’t indicate that the Client Secret is incorrect.
• Client Secret
  • (Required) The Consumer Secret from your Salesforce Connected App or External Client App.
• Source API Name
  • (Required) The Source API Name of the Ingestion API source in Salesforce Data 360.

Actions

Send Ingestion API Records

Batch limits

This action uses batched requests to support high-volume data transfers to the vendor. With parallel processing, events can reach the vendor out of sequence. If event order is important, add a sequence value to the events. For more information, see Batched Actions.

Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 200
• Max time since oldest request: 10 minutes

Parameters

Record Data

Map Tealium attributes to the destination fields for the selected Salesforce Data 360 object. Follow these requirements when configuring mappings:

• If a field requires a nested object or array, define a template on the Templates tab and enter the template name as the mapped value.
• Include the Data Stream’s primary key and any other fields marked as required in the Salesforce ingestion schema.
• For partial updates, include the configured Record Modified field. For Engagement objects, also include the configured Event Time field.
• Ensure that mapped values match the data types and formats expected by Salesforce, such as ISO 8601 timestamps, numbers, and boolean values.
• If a source contains multiple objects, such as SalesCustomer and Order, create a separate action for each Object API Name so that each Record Data mapping corresponds to a single object schema.

Salesforce processes ingestion requests asynchronously. A successful response confirms that Salesforce accepted the request for processing, but doesn’t confirm that every record was ingested. Missing required values, invalid data types, or other schema mismatches can cause records to fail during downstream processing without returning an error to Tealium.

Templates