Integrating the CDP

The Customer Data Platform supports direct integrations with several platform enabling your sales and marketing team to execute campaigns targeting your customers and prospects. These integrations will continue to grow over time, but there will always be a need to integration with a system that is not yet directly supported by the CDP. This document is meant to be a guide to help partners or integration teams to develop integrations from the CDP to any system.

What's covered in this article

• Accessing campaign launch data
• Including IFrame component in application to render CDP functionality seen in BIS (Buyer Insights) such as Talking Points, Spend Analytics, Company Profile etc.

Step 1: Accessing Campaign Launch Data

The platform supports launching campaigns to AWS S3. AWS S3 is a cloud file storage service from Amazon. Each customer has a dedicated & secure folder in AWS S3 that is only accessible to users who have the permissions to access it.

See this article for more details on launching a campaign to S3.

The folder is secured and requires access token to access the data. See this article for details on getting the access token.

There are multiple options to access this data programmatically

• Access data using a script. This can use S3 REST API from Amazon.
• Use ETL tools (Tray.io, Dell Bhoomi, Tibco, Informatica) to automate copying data from the CDP to your system.

Step 2: Generate OAUTH token

Generating OAUTH token is a two step process

1. Generate a one time password (OTP)
2. Use the OTP to generate an OAUTH access token

Step #2A: Generate OTP

1. Login to https://app.lattice-engines.com
2. Navigate to "Connections"
3. Select System Type as Salesforce and click on Create

   

4. Click on "Email Token"
5. This will send out an email with "Tenant Name" and "One-time Authentication token" that is needed for oAuth api (Step #2b)

Step #2B: Use the OTP to generate an OAUTH access token

Use the API as shown below to generate and Refresh Access token. Access tokens are required for using Latice API.

NOTE: Access tokens will be valid for 6 months.

API Request
curl --request POST 'https://oauth.lattice-engines.com/oauth/token' \
    -H 'Authorization: Basic bHA6' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'grant_type=password' \
    -d 'username=<tenantID.tenantID.Production>' \
    -d 'app_id=<hosting>.<tenantID>.<application>' \
    -d 'password=<OTP>'

API Response

{
 "access_token": "a8a7a1c3-de25-4530-9642-5ceb4f71bbcd",
 "token_type": "bearer",
 "refresh_token": "7a2aa402-2b1a-4ee0-a213-cab9af57bde3",
 "expires_in": 43199,
 "scope": "read write"
}

Request Parameters

Response Content

Step #3: Using CDP Visual (IFrame) Components

Lattice provides two visual components that can be made available as iFrame components

Talking Points

Helps marketers provide contextual talking points (insights) about their Accounts to field sales reps

Spend Analytics

Provide a holistic view of an account and their spending on products and services. This can help sales team have a better understanding of the customer and offer the right incentives and products in their conversation.

iframe URL

Use this form to generate and copy properly formatted and encoded iframe urls for Talking Points or Spend Analytics.

• All parameters are case-sensitive. A change will result in the CDP not recognizing the URL and result in a page not found error.
• Custom Settings value is a JSON string and should be URL encoded. URL Encoding is a process of escaping special characters in the URL. There are several online URL encoding tools. Here is one of the tools you can use.
• The URL will not automatically render both Talking points and Spend Analytics. As a developer, you have the choice to either render one of these tabs. If you want both of these tabs in your application, you should render these as separate tabs one with "DefaultTab":"TalkingPoints" and the other one with "DefaultTab":"spendAnalytics".