Salesforce Marketing Cloud (formerly Exact Target) is a multi-tool marketing platform designed to effectively manage a brand's interactions with current (and potential) customers across multiple channels.
The technology behind the platform allows for more efficient and effective management of marketing activities. The platform allows the creation of multichannel experiences, contacting customers in the right channel, at the right time (email, SMS, push, social media advertisements, etc.) and increasing customer acquisition and sales.
Kondado's integration with Salesforce Marketing Cloud makes it easier than ever to plan, monitor, analyze and make decisions by bringing lots of data into your Data Warehouse and Data Lake.
Adding the data source
To automate Salesforce Marketing Cloud ETL with Kondado for your database, follow the steps below:
2) You will be redirected to the login page specific to the user account selected in step (1). Copy the URL that will be generated:
3) With the URL in hand, you must obtain your company's subdomain by searching for the value before “.login”. In the example in step (2), this value will be mcx1072k138f919oowzqewciw06, which is obtained as follows:
https://mcx1072k138f919oowzqewciw06.login.exacttarget.com
4) Save the subdomain obtained in step (3), as it will be used to create the data source in Kondado;
5) Continue with your login and access the Salesforce Marketing Cloud platform;
6) Once logged in, locate your username on the right of the top bar, click on it and then on “Setup”;
7) On the new page, locate in the left sidebar the route Apps > Installed Packages;
8) On the Installed Packages page, you will see the list of connected applications. To create the Kondado integration, click on the “New” button located at the top right of the listing;
9) After clicking on the button, enter a name and a description (for example Kondado and kondado.com.br) and click on “Save”;
10) After creating the Installed Package, in the “DETAILS” tab, locate the “Components” section and click on the “Add Component” button;
11) In the first step of the popup, select the “API Integration” option and click “Next”;
12) In the next step, select the “Server-to-Server” option and click “Next”;
13) Now is the time to select the permissions/properties of the Kondado integration. Mark the Data > Data Extensions category as Read and Write and the categories listed below as Read only. After checking the permissions, click on “Save”:
Email, OTT, Push, SMS, Social, Web, Documents and Images, Saved Content, Automations, Journeys, Audiences, List and Subscribers, Marketing Cloud Connect, File Locations, Tracking Events, Approvals, Calendar, Campaign, Tags, Workflows, Accounts, OTT Channels, Users e Webhooks
14) After adding the Component, copy the values of “Client Id” and “Client Secret” located in the tab “DETAILS” > Components > API Integration:
16) Fill in the values as follows:
- Subdomain: The value obtained in step (3)
- Client ID and Client Secret: The values obtained in step (14)
Now just click on SAVE and everything will be ready for you to start replicating your Salesforce Marketing Cloud data to your Data Warehouse!
Pipelines
Relationship Chart
Subscribers
Main object
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
client__id | text | [en] Specifies the account ownership and context of an object. |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
createddate | timestamp | [en] date and time of the objects creation |
objectid | text | [en] System-controlled, read-only text string identifier for object |
emailaddress | text | [en] Contains the email address for a subscriber. Indicates the data extension field contains email address data |
subscriberkey | text | [en] Identification of a specific subscriber |
status | text | [en] Defines status of object. Status of an address. |
emailtypepreference | text | [en] The format to use when sending an email to a subscriber. Valid values include: HTML, Text |
Attributes
Field | Type | |
---|---|---|
subscriber_id | text | |
name | text | [en] Specifies attributes associated with an object |
value | text | [en] Value of the attribute associated with an object |
Emails
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
status | text | [en] Defines status of object. Status of an address. |
name | text | [en] Name of the object or property |
customerkey | text | [en] User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object in Marketing Cloud. |
emailtype | text | [en] Defines preferred email type |
characterset | text | [en] Indicates encoding used in an email message. Valid values include |
preheader | text | [en] Contains text used in preheader of email message on mobile devices |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
modifieddate | timestamp | [en] Indicates the last time object information was modified |
hasdynamicsubjectline | boolean | [en] Indicates whether email message contains a dynamic subject line |
createddate | timestamp | [en] Read-only date and time of the object's creation |
contentcheckstatus | text | [en] Indicates whether content validation has completed for this email message |
folder | text | [en] Specifies folder information |
ishtmlpaste | boolean | [en] Indicates whether email message was created via pasted HTML |
objectid | text | [en] System-controlled, read-only text string identifier for object |
categoryid | text | [en] Specifies the identifier of the folder containing the email |
isactive | boolean | [en] Specifies whether the object is active |
subject | text | [en] Contains subject area information for a message |
Events
Main object
Field | Type | |
---|---|---|
sendid | text | [en] Contains identifier for a specific send |
subscriberkey | text | [en] Identification of a specific subscriber |
eventtype | text | [en] The type of tracking event |
eventdate | timestamp | [en] Date when a tracking event occurred |
url | text | [en] Indicates URL included in an event or configuration |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
correlationid | text | [en] Identifies correlation of objects across several requests |
objectid | text | [en] System-controlled, read-only text string identifier for object |
batchid | text | [en] Ties triggered send sent events to other events (like clicks and opens that occur at a later date and time) |
triggeredsenddefinitionobjectid | text | [en] Identifies the triggered send definition associated with an event. This value also appears in tracking events to allow you to tie those events to a specific triggered send |
PartnerProperties
Field | Type | |
---|---|---|
sendid | text | |
subscriberkey | text | |
eventtype | text | |
eventdate | timestamp | |
partnerproperties__name | text | [en] Name of the metadata record supplied by the client and stored by the system |
partnerproperties__value | text | [en] Value of the metadata record supplied by the client and stored by the system |
Folders
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
name | text | [en] Name of the object or property |
allowchildren | boolean | [en] Specifies whether a data folder can have child data folders |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__enterpriseid | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__modifiedby | text | |
client__id | text | |
client__createdby | text | |
iseditable | boolean | [en] Indicates if the property can be edited by the end-user in the profile center |
contenttype | text | [en] Defines the type of content contained within a folder |
description | text | [en] Describes and provides information regarding the object |
customerkey | text | [en] User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object in Marketing Cloud |
parentfolder__partnerkey | text | |
parentfolder__contenttype | text | |
parentfolder__description | text | |
parentfolder__customerkey | text | |
parentfolder__name | text | |
parentfolder__iseditable | boolean | |
parentfolder__objectid | text | |
parentfolder__id | text | |
parentfolder__isactive | boolean | |
parentfolder__allowchildren | boolean | |
modifieddate | timestamp | [en] Indicates the last time object information was modified |
createddate | timestamp | [en] Read-only date and time of the object's creation |
objectid | text | [en] System-controlled, read-only text string identifier for object |
isactive | boolean | [en] Specifies whether the object is active |
List Sends
Field | Type | |
---|---|---|
list__id | text | [en] ID of the list associated with an object |
sendid | text | [en] Contains identifier for a specific send |
forwardedemails | float | [en] Number of emails forwarded for a send |
existingunsubscribes | float | [en] Indicates whether unsubscriptions occurred on previous send |
unsubscribes | float | [en] Indicates the number of unsubscribe events associated with a send |
uniqueopens | float | [en] Indicates number of unique opens resulting from a triggered send |
uniqueclicks | float | [en] Indicates number of unique clicks on message |
objectid | text | [en] System-controlled, read-only text string identifier for object |
duplicates | float | [en] Represent the number of duplicate email addresses associated with a send (exists only when a send occurs to multiple lists) |
list__listname | text | [en] Name of the list associated with an object |
list__objectid | text | [en] ObjectID of the list associated with an object |
list__partnerkey | text | [en] PartnerKey of the list associated with an object |
existingundeliverables | float | [en] Indicates whether bounces occurred on previous send |
otherbounces | float | [en] Specifies number of Other-type bounces in a send |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
previewurl | text | [en] Indicates URL used to preview the message associated with a send |
numberdelivered | float | [en] Number of sent emails that did not bounce |
invalidaddresses | float | [en] Specifies the number of invalid addresses associated with a send |
softbounces | float | [en] Indicates number of soft bounces associated with a specific send |
numbersent | float | [en] Number of emails actually sent as part of an email send. This number reflects all of the sent messages and may include bounced messages |
missingaddresses | float | [en] Specifies number of missing addresses encountered within a send |
hardbounces | float | [en] Indicates number of hard bounces associated with a send |
List Subscribers
Main object
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
status | text | [en] Defines status of a subscriber's address. Valid values include: Active, Bounced, Held, Unsubscribed, Deleted |
listid | text | [en] Defines identification for a list the subscriber resides on |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
modifieddate | timestamp | [en] Indicates the last time object information was modified |
objectid | text | [en] System-controlled, read-only text string identifier for object |
createddate | timestamp | [en] Read-only date and time of the object's creation |
subscriberkey | text | [en] Identification of a specific subscriber |
PartnerProperties
Field | Type | |
---|---|---|
id | text | |
partnerproperties__name | text | [en] Name of the metadata record supplied by the client and stored by the system |
partnerproperties__value | text | [en] Value of the metadata record supplied by the client and stored by the system |
Lists
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
category | text | [en] ID of the folder that an item is located in |
listclassification | text | [en] Specifies the classification for a list. Valid values include: ExactTargetList, PublicationList, SuppressionList |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
type | text | [en] Indicates type of specific list. Valid values include Public, Private, Salesforce, GlobalUnsubscribe, and Master. Indicates the type of email to send to the address. Valid values include Text and HTML |
listname | text | [en] Name of a specific list |
description | text | [en] Describes and provides information regarding the object |
customerkey | text | [en] User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object in Marketing Cloud |
modifieddate | timestamp | [en] Indicates the last time object information was modified |
createddate | timestamp | [en] Read-only date and time of the object's creation |
objectid | text | [en] System-controlled, read-only text string identifier for object |
Sends
Main object
Field | Type | |
---|---|---|
id | text | [en] Read-only identifier for an object. Some objects use the ObjectID property as the Marketing Cloud unique ID |
status | text | [en] Defines status of object. Status of an address |
unsubscribes | float | [en] Indicates the number of unsubscribe events associated with a send |
uniqueopens | float | [en] Indicates number of unique opens resulting from a triggered send |
additional | text | [en] The ID for a send that customers use as a campaign ID |
numbererrored | float | [en] Number of emails not sent as part of a send because an error occurred while trying to build the email |
subject | text | [en] Contains subject area information for a message |
fromname | text | [en] Specifies the default email message From Name. Deprecated for email send definitions and triggered send definitions |
isalwayson | boolean | [en] Indicates whether the request can be performed while the system is is maintenance mode. A value of true indicates that the system processes the request |
previewurl | text | [en] Indicates URL used to preview the message associated with a send |
partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
client__id | text | [en] Specifies the account ownership and context of an object |
numberdelivered | float | [en] Number of sent emails that did not bounce |
invalidaddresses | float | [en] Specifies the number of invalid addresses associated with a send |
ismultipart | boolean | [en] Indicates whether the email is sent with Multipart/MIME enabled |
missingaddresses | float | [en] Specifies number of missing addresses encountered within a send |
email__partnerkey | text | [en] Unique identifier provided by partner for an object. This property is accessible only via API |
email__id | text | [en] Default email address for object. Indicates if subscriber information can be used for email sends |
email__objectid | text | |
forwardedemails | float | [en] Number of emails forwarded for a send |
existingunsubscribes | float | [en] Indicates whether unsubscriptions occurred on previous send |
otherbounces | float | [en] Specifies number of Other-type bounces in a send |
numbersent | float | [en] Number of emails actually sent as part of an email send. This number reflects all of the sent messages and may include bounced messages |
senddate | timestamp | [en] Indicates the date on which a send occurred. CST (Central Standard Time) value |
objectid | text | [en] System-controlled, read-only text string identifier for object |
duplicates | float | [en] Represent the number of duplicate email addresses associated with a send (exists only when a send occurs to multiple lists) |
uniqueclicks | float | [en] Indicates number of unique clicks on message |
existingundeliverables | float | [en] Indicates whether bounces occurred on previous send |
hardbounces | float | [en] Indicates number of hard bounces associated with a send |
emailname | text | [en] Specifies the name of an email message associated with a send |
modifieddate | timestamp | [en] Indicates the last time object information was modified |
createddate | timestamp | [en] Read-only date and time of the object's creation |
softbounces | float | [en] Indicates number of soft bounces associated with a specific send |
numbertargeted | float | [en] Indicates the number of possible recipients for an email send. This number does not include unsubscribed or excluded subscribers for a given list or data extension |
fromaddress | text | [en] Indicates From address associated with a object. Deprecated for email send definitions and triggered send definitions |
numberexcluded | float | [en] Indicates the number recipients excluded froman email send because of a held, unsubscribed, master unsubscribed, or global unsubscribed status |
PartnerProperties
Field | Type | |
---|---|---|
id | text | |
partnerproperties__name | text | [en] Name of the metadata record supplied by the client and stored by the system |
partnerproperties__value | text | [en] Value of the metadata record supplied by the client and stored by the system |
Data Extension
Field | Type | |
---|---|---|
__kdd_rowkey | text | |
col_x | text | |
col_y | boolean | |
col_z | timestamp |
This pipeline can be integral or incremental. For it to be incremental, it is necessary that: (i) there is a column of type timestamp (or Date for SFMC) that marks when the record was updated or inserted that is selected to be sent to the integration (if there are timestamp columns, but that do not have this behavior, the ideal is to leave the integration as integral) ; (ii) the records are not deleted from the table (if they are, the ideal is to leave the integration as integral);. Once both these conditions are met, you can mark the integration as incremental in the last step when creating the integration, also selecting the incremental column. Incremental updates will always read data from the savepoint date minus 1 day backwards.