Salesforce Marketing Cloud Connector Reference

42 metrics65 dimensions

The Salesforce Marketing Cloud connector retrieves data from Salesforce Marketing Cloud on campaign level.

https://connectors.windsor.ai/salesforce_marketing?api_key=[your API key]&date_preset=last_7d&fields=send_id,send_status,sent_date,send_created_date,send_modified_date,send_from_address,send_from_name,send_bcc_email,send_subject,send_email_name,send_limit,send_is_always_on,send_is_multipart,send_preview_url,send_window_close,send_window_open,send_number_delivered,send_unique_opens,send_unique_clicks,send_soft_bounces,send_hard_bounces,send_other_bounces,send_number_errored,send_forwarded_emails,send_duplicates,send_missing_addresses,send_invalid_addresses,send_existing_unsubscribes,send_unsubscribes,send_number_excluded,send_existing_undeliverables,send_number_sent,send_number_targeted,send_partner_key,send_delivery_rate,send_open_rate,send_click_rate,send_bounces,send_bounce_rate,link_id,link_url,link_alias,link_total_clicks,link_unique_clicks,link_shown,link_click_rate,list_id,list_name,list_category,list_classification,list_type,list_name,list_description

The Salesforce Marketing Cloud connector exposes 107 fields (42 metrics, 65 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Salesforce Marketing Cloud Fields

Salesforce Marketing Cloud Campaign fields

The Campaign report of the Salesforce Marketing Cloud connector includes 6 fields.

ID Type Name Description
campaign_code TEXT Send Campaign Code Campaign Code.
campaign_created_date TIMESTAMP Campaign Created Date Campaign created date.
campaign_description TEXT Campaign Description Campaign Description.
campaign_id TEXT Campaign ID Campaign ID.
campaign_modified_date DATE Campaign Modified Date Campaign modified date.
campaign_name TEXT Campaign Name Campaign Name.

Salesforce Marketing Cloud List fields

The List report of the Salesforce Marketing Cloud connector includes 6 fields.

ID Type Name Description
list_category TEXT List Category ID of the folder that an item is located in.
list_classification TEXT List Classification Specifies the classification for a list. Valid values include: ExactTargetList, PublicationList, SuppressionList.
list_description TEXT List Description Describes and provides information regarding the list.
list_id TEXT List ID List ID
list_name TEXT List Name List Name
list_type TEXT List Type 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.

Salesforce Marketing Cloud List_Subscriber fields

The List_Subscriber report of the Salesforce Marketing Cloud connector includes 3 fields.

ID Type Name Description
list_subscriber_key TEXT List Subscriber Key Unique identifier of the subscriber, often the email address.
list_subscriber_list_id TEXT List Subscriber List ID ID of the list the subscriber resides on.
list_subscriber_status TEXT List Subscriber Status Subscription status of the subscriber on the list. Valid values include Active, Bounced, Held, Unsubscribed, and Deleted.

Salesforce Marketing Cloud Send fields

The Send report of the Salesforce Marketing Cloud connector includes 40 fields.

ID Type Name Description
send_bcc_email TEXT Send Bcc Email Indicates email addresses to receive blind carbon copy of a message.
send_bounce_rate PERCENT Email Bounce rate Emails bounced divided by emails sent.
send_bounces NUMERIC Email Bounces Number of times when an email bounced as soft bounce, hard bounce or other bounce.
send_click_rate PERCENT Emails Click Rate Unique email clicks divided by emails delivered.
send_created_date DATE Send Created Date Date and time of the object's creation.
send_date DATE Send Send Date The date and time when a send occurred. Set this value to have a CST (Central Standard Time) value.
send_delivery_rate PERCENT Emails Delivery Rate Emails delivered divided by emails sent.
send_duplicates NUMERIC Email Duplicates Represent the number of duplicate email addresses associated with a send (exists only when a send occurs to multiple lists).
send_email_name TEXT Send Email Name Specifies the name of an email message associated with a send.
send_existing_undeliverables TEXT Send Existing Undeliverables Indicates whether bounces occurred on previous send.
send_existing_unsubscribes TEXT Send Existing Unsubscribes Indicates whether unsubscriptions occurred on previous send.
send_forwarded_emails NUMERIC Forwarded Emails Number of emails forwarded for a send.
send_from_address TEXT Send From Address Indicates From address associated with a object. Deprecated for email send definitions and triggered send definitions.
send_from_name TEXT Send From Name Specifies the default email message From Name. Deprecated for email send definitions and triggered send definitions.
send_hard_bounces NUMERIC Email Hard Bounces Indicates number of hard bounces associated with a send.
send_id TEXT Send ID Send ID
send_invalid_addresses NUMERIC Email Invalid Addresses Specifies the number of invalid addresses associated with a send.
send_is_always_on BOOLEAN Send Is Always On Indicates whether the request can be performed while the system is in maintenance mode. A value of true indicates that the system processes the request.
send_is_multipart BOOLEAN Send Is Multipart Indicates whether the email is sent with Multipart/MIME enabled.
send_limit NUMERIC Send Limit Indicates limit of messages to send as part of a send definition within a predefined send window.
send_missing_addresses NUMERIC Email Missing Addresses Specifies number of missing addresses encountered within a send.
send_modified_date DATE Send Modified Date Indicates the last time object information was modified.
send_number_delivered NUMERIC Emails Delivered Number of sent emails that did not bounce.
send_number_errored NUMERIC Email Number Errored Number of emails not sent as part of a send because an error occurred while trying to build the email.
send_number_excluded NUMERIC Send Number Excluded Indicates the number recipients excluded froman email send because of a held, unsubscribed, master unsubscribed, or global unsubscribed status.
send_number_sent NUMERIC Send Number Sent Number of emails actually sent as part of an email send. This number reflects all of the sent messages and may include bounced messages.
send_number_targeted NUMERIC Send Number Targeted 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.
send_open_rate NUMERIC Emails Open Rate Unique email opens divided by emails delivered.
send_other_bounces NUMERIC Email Other Bounces Specifies number of Other-type bounces in a send.
send_partner_key TEXT Send Partner Key Unique identifier provided by partner for an object.
send_preview_url TEXT Send Preview Url Indicates URL used to preview the message associated with a send.
send_soft_bounces NUMERIC Email Soft Bounces Indicates number of soft bounces associated with a specific send.
send_status TEXT Send Status Defines status of object. Status of an address.
send_subject TEXT Send Subject Contains subject area information for a message.
send_unique_clicks NUMERIC Send Unique Clicks Indicates number of unique clicks on message.
send_unique_opens NUMERIC Emails Unique Opens Indicates number of unique opens resulting from a triggered send.
send_unsubscribes NUMERIC Send Unsubscribes Indicates the number of unsubscribe events associated with a send.
send_window_close TEXT Send Window Close Defines the end of a send window for a send definition.
send_window_open TEXT Send Window Open Defines the beginning of a send window for a send definition.
sent_date DATE Send Sent Date Indicates date on which a send took place. (This field might have the value 'null' and it is not clearly documented. 'Send Send Date' can also be used if that fits better the requirements.)

Salesforce Marketing Cloud Triggered_Send_Definition fields

The Triggered_Send_Definition report of the Salesforce Marketing Cloud connector includes 9 fields.

ID Type Name Description
triggered_send_bcc_email TEXT Triggered Send BCC Email Indicates email addresses to receive blind carbon copy of a message.
triggered_send_created_date DATE Triggered Send Created Date Date and time of the object's creation.
triggered_send_email_subject TEXT Triggered Send Email Subject Contains subject area information for a message.
triggered_send_is_multipart BOOLEAN Triggered Send Is Multipart Indicates whether the email is sent with Multipart/MIME enabled
triggered_send_limit NUMERIC Triggered Send Limit Indicates limit of messages to send as part of a send definition within a predefined send window.
triggered_send_modified_date DATE Triggered Send Modified Date Indicates the last time object information was modified.
triggered_send_status TEXT Triggered Send Status Defines status of object. Status of an address.
triggered_send_window_close DATE Triggered Send Window Close Defines the end of a send window for a send definition.
triggered_send_window_open DATE Triggered Send Window Open Defines the beginning of a send window for a send definition.

Salesforce Marketing Cloud Triggered_Send_Summary fields

The Triggered_Send_Summary report of the Salesforce Marketing Cloud connector includes 17 fields.

ID Type Name Description
triggered_send_bounces NUMERIC Triggered Send Bounces Indicates number of bounces resulting from a triggered send.
triggered_send_clicks NUMERIC Triggered Send Clicks Indicates the number of clicks resulting from a triggered send.
triggered_send_conversions NUMERIC Triggered Send Conversions Indicates the number of conversions results from a triggered send.
triggered_send_ftaf_emails_sent NUMERIC Triggered Send FTAF Emails Sent Indicates Forward To A Friend emails sent as a result of a triggered send.
triggered_send_ftaf_opt_ins NUMERIC Triggered Send FTAF Opt Ins Indicates number of subscribers opting in to receiving messages as a result of a Forward To A Friend action from a triggered send.
triggered_send_ftaf_requests TEXT Triggered Send FTAF Requests Indicates number of Forward To A Friend requests received as part of a triggered send
triggered_send_not_sent_due_to_error NUMERIC Triggered Send Not Sent Due To Error Indicates number of triggered send messages not sent due to error.
triggered_send_not_sent_due_to_opt_out NUMERIC Triggered Send Not Sent Due To Opt Out Indicates number of sends not completed due to a subscriber's decision to opt out of receiving messages
triggered_send_not_sent_due_to_undeliverable NUMERIC Triggered Send Not Sent Due To Undeliverable Indicates number of sends not completed due to a subscriber's undeliverable status.
triggered_send_opens NUMERIC Triggered Send Opens Indicates number of opens from a triggered send.
triggered_send_opt_outs NUMERIC Triggered Send Opt Outs Indicates number of subscribers who opted out of receiving messages after receiving a triggered send
triggered_send_queued NUMERIC Triggered Send Queued Indicates number of messages queued for sending.
triggered_send_sent NUMERIC Triggered Send Sent Indicates number of messages sent. Indicates the message was sent to a subscriber.
triggered_send_survey_responses NUMERIC Triggered Send Survey Responses Indicates number of responses to a survey question contained in a triggered send.
triggered_send_unique_clicks NUMERIC Triggered Send Unique Clicks Indicates number of unique clicks on message.
triggered_send_unique_conversions NUMERIC Triggered Send Unique Conversions Indicates number of unique conversions resulting from a triggered send.
triggered_send_unique_opens NUMERIC Triggered Send Unique Opens Indicates number of unique opens resulting from a triggered send.

Salesforce Marketing Cloud other fields

The Salesforce Marketing Cloud connector has 19 fields that do not belong to a named report, or belong to a report with only one or two fields.

ID Type Name Description Report
data_fetched_at TIMESTAMP Data fetched at UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasource TEXT Data Source The name of the Windsor connector returning the row
date DATE Date Date of the object's creation. General
day_of_month TEXT Day of month Day of the month
month TEXT Month Number of the month
now TIMESTAMP Now Current timestamp
source TEXT Source The name of the Windsor connector returning the row
today DATE Today Today's date
week TEXT Week Week (Sun-Sat).
week_day TEXT Day of week and day number Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_iso TEXT Day of week and day number, ISO Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_iso TEXT Week ISO Week, ISO format (Mon-Sun).
year TEXT Year Year
year_month TEXT Yearmonth Year and month, e.g. 2024|3
year_month_name TEXT Year month name Year and month with the month name written out, e.g. "Jan 2025".
year_of_week TEXT Year of week The year that contains first day of the week (Sun-Sat).
year_of_week_iso TEXT Year of week, ISO The year that contains first day of the ISO week (Mon-Sun).
year_week TEXT Year week Year and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_iso TEXT Year week ISO Year and week for ISO weeks (Mon-Sun), e.g. 2024|20