Salesforce Marketing Cloud Connector Reference

49 metrics85 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 134 fields (49 metrics, 85 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.

IDTypeNameDescription
campaign_codeTEXTSend Campaign CodeCampaign Code.
campaign_created_dateTIMESTAMPCampaign Created DateCampaign created date.
campaign_descriptionTEXTCampaign DescriptionCampaign Description.
campaign_idTEXTCampaign IDCampaign ID.
campaign_modified_dateDATECampaign Modified DateCampaign modified date.
campaign_nameTEXTCampaign NameCampaign Name.

Salesforce Marketing Cloud Journey_Email fields

The Journey_Email report of the Salesforce Marketing Cloud connector includes 22 fields.

IDTypeNameDescription
journey_email_activity_idTEXTJourney Email Activity IDID of the email activity inside the journey.
journey_email_activity_keyTEXTJourney Email Activity KeyExternal key of the email activity inside the journey.
journey_email_activity_nameTEXTJourney Email Activity NameName of the email activity inside the journey.
journey_email_bouncesNUMERICJourney Email BouncesNumber of bounces of the journey email on this date.
journey_email_clicksNUMERICJourney Email ClicksNumber of clicks in the journey email on this date, including repeat clicks by the same subscriber.
journey_email_email_idTEXTJourney Email Email IDID of the email sent by the journey email activity.
journey_email_email_nameTEXTJourney Email Email NameName of the email sent by the journey email activity.
journey_email_journey_idTEXTJourney Email Journey IDID of the journey, which stays the same across all of its versions.
journey_email_journey_keyTEXTJourney Email Journey KeyExternal key of the journey.
journey_email_journey_nameTEXTJourney Email Journey NameName of the journey.
journey_email_journey_statusTEXTJourney Email Journey StatusStatus of the journey version, such as Published, Paused or Stopped.
journey_email_journey_versionTEXTJourney Email Journey VersionVersion number of the journey.
journey_email_journey_version_idTEXTJourney Email Journey Version IDID of the journey version that owns the email activity.
journey_email_opensNUMERICJourney Email OpensNumber of opens of the journey email on this date, including repeat opens by the same subscriber.
journey_email_sentNUMERICJourney Email SentNumber of sends of the journey email on this date. A subscriber re- entering the journey is counted for every send.
journey_email_subjectTEXTJourney Email Email SubjectSubject line of the email sent by the journey email activity.
journey_email_triggered_send_customer_keyTEXTJourney Email Triggered Send Customer KeyExternal key of the triggered send definition behind the journey email activity.
journey_email_triggered_send_nameTEXTJourney Email Triggered Send NameName of the triggered send definition behind the journey email activity.
journey_email_triggered_send_object_idTEXTJourney Email Triggered Send Object IDSystem-controlled identifier of the triggered send definition behind the journey email activity.
journey_email_unique_clicksNUMERICJourney Email Unique ClicksNumber of subscribers who clicked in the journey email on this date. Summing this across dates or activities overstates unique subscribers.
journey_email_unique_opensNUMERICJourney Email Unique OpensNumber of subscribers who opened the journey email on this date. Summing this across dates or activities overstates unique subscribers.
journey_email_unsubscribesNUMERICJourney Email UnsubscribesNumber of unsubscribes resulting from the journey email on this date.

Salesforce Marketing Cloud List fields

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

IDTypeNameDescription
list_categoryTEXTList CategoryID of the folder that an item is located in.
list_classificationTEXTList ClassificationSpecifies the classification for a list. Valid values include: ExactTargetList, PublicationList, SuppressionList.
list_descriptionTEXTList DescriptionDescribes and provides information regarding the list.
list_idTEXTList IDList ID
list_nameTEXTList NameList Name
list_typeTEXTList TypeIndicates 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.

IDTypeNameDescription
list_subscriber_keyTEXTList Subscriber KeyUnique identifier of the subscriber, often the email address.
list_subscriber_list_idTEXTList Subscriber List IDID of the list the subscriber resides on.
list_subscriber_statusTEXTList Subscriber StatusSubscription 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.

IDTypeNameDescription
send_bcc_emailTEXTSend Bcc EmailIndicates email addresses to receive blind carbon copy of a message.
send_bounce_ratePERCENTEmail Bounce rateEmails bounced divided by emails sent.
send_bouncesNUMERICEmail BouncesNumber of times when an email bounced as soft bounce, hard bounce or other bounce.
send_click_ratePERCENTEmails Click RateUnique email clicks divided by emails delivered.
send_created_dateDATESend Created DateDate and time of the object's creation.
send_dateDATESend Send DateThe date and time when a send occurred. Set this value to have a CST (Central Standard Time) value.
send_delivery_ratePERCENTEmails Delivery RateEmails delivered divided by emails sent.
send_duplicatesNUMERICEmail DuplicatesRepresent the number of duplicate email addresses associated with a send (exists only when a send occurs to multiple lists).
send_email_nameTEXTSend Email NameSpecifies the name of an email message associated with a send.
send_existing_undeliverablesTEXTSend Existing UndeliverablesIndicates whether bounces occurred on previous send.
send_existing_unsubscribesTEXTSend Existing UnsubscribesIndicates whether unsubscriptions occurred on previous send.
send_forwarded_emailsNUMERICForwarded EmailsNumber of emails forwarded for a send.
send_from_addressTEXTSend From AddressIndicates From address associated with a object. Deprecated for email send definitions and triggered send definitions.
send_from_nameTEXTSend From NameSpecifies the default email message From Name. Deprecated for email send definitions and triggered send definitions.
send_hard_bouncesNUMERICEmail Hard BouncesIndicates number of hard bounces associated with a send.
send_idTEXTSend IDSend ID
send_invalid_addressesNUMERICEmail Invalid AddressesSpecifies the number of invalid addresses associated with a send.
send_is_always_onBOOLEANSend Is Always OnIndicates 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_multipartBOOLEANSend Is MultipartIndicates whether the email is sent with Multipart/MIME enabled.
send_limitNUMERICSend LimitIndicates limit of messages to send as part of a send definition within a predefined send window.
send_missing_addressesNUMERICEmail Missing AddressesSpecifies number of missing addresses encountered within a send.
send_modified_dateDATESend Modified DateIndicates the last time object information was modified.
send_number_deliveredNUMERICEmails DeliveredNumber of sent emails that did not bounce.
send_number_erroredNUMERICEmail Number ErroredNumber of emails not sent as part of a send because an error occurred while trying to build the email.
send_number_excludedNUMERICSend Number ExcludedIndicates the number recipients excluded froman email send because of a held, unsubscribed, master unsubscribed, or global unsubscribed status.
send_number_sentNUMERICSend Number SentNumber 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_targetedNUMERICSend Number TargetedIndicates 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_rateNUMERICEmails Open RateUnique email opens divided by emails delivered.
send_other_bouncesNUMERICEmail Other BouncesSpecifies number of Other-type bounces in a send.
send_partner_keyTEXTSend Partner KeyUnique identifier provided by partner for an object.
send_preview_urlTEXTSend Preview UrlIndicates URL used to preview the message associated with a send.
send_soft_bouncesNUMERICEmail Soft BouncesIndicates number of soft bounces associated with a specific send.
send_statusTEXTSend StatusDefines status of object. Status of an address.
send_subjectTEXTSend SubjectContains subject area information for a message.
send_unique_clicksNUMERICSend Unique ClicksIndicates number of unique clicks on message.
send_unique_opensNUMERICEmails Unique OpensIndicates number of unique opens resulting from a triggered send.
send_unsubscribesNUMERICSend UnsubscribesIndicates the number of unsubscribe events associated with a send.
send_window_closeTEXTSend Window CloseDefines the end of a send window for a send definition.
send_window_openTEXTSend Window OpenDefines the beginning of a send window for a send definition.
sent_dateDATESend Sent DateIndicates 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 14 fields.

IDTypeNameDescription
triggered_send_bcc_emailTEXTTriggered Send BCC EmailIndicates email addresses to receive blind carbon copy of a message.
triggered_send_created_dateDATETriggered Send Created DateDate and time of the object's creation.
triggered_send_customer_keyTEXTTriggered Send Customer KeyExternal key of the triggered send definition. Journey Builder email activities use it to reference their triggered send.
triggered_send_descriptionTEXTTriggered Send DescriptionDescription of the triggered send definition.
triggered_send_email_idTEXTTriggered Send Email IDID of the email sent by the triggered send definition.
triggered_send_email_subjectTEXTTriggered Send Email SubjectContains subject area information for a message.
triggered_send_is_multipartBOOLEANTriggered Send Is MultipartIndicates whether the email is sent with Multipart/MIME enabled
triggered_send_limitNUMERICTriggered Send LimitIndicates limit of messages to send as part of a send definition within a predefined send window.
triggered_send_modified_dateDATETriggered Send Modified DateIndicates the last time object information was modified.
triggered_send_nameTEXTTriggered Send NameName of the triggered send definition.
triggered_send_object_idTEXTTriggered Send Object IDSystem-controlled identifier of the triggered send definition.
triggered_send_statusTEXTTriggered Send StatusDefines status of object. Status of an address.
triggered_send_window_closeDATETriggered Send Window CloseDefines the end of a send window for a send definition.
triggered_send_window_openDATETriggered Send Window OpenDefines 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.

IDTypeNameDescription
triggered_send_bouncesNUMERICTriggered Send BouncesIndicates number of bounces resulting from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_clicksNUMERICTriggered Send ClicksIndicates the number of clicks resulting from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_conversionsNUMERICTriggered Send ConversionsIndicates the number of conversions results from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_ftaf_emails_sentNUMERICTriggered Send FTAF Emails SentIndicates Forward To A Friend emails sent as a result of a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_ftaf_opt_insNUMERICTriggered Send FTAF Opt InsIndicates number of subscribers opting in to receiving messages as a result of a Forward To A Friend action from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_ftaf_requestsTEXTTriggered Send FTAF RequestsIndicates number of Forward To A Friend requests received as part of a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_not_sent_due_to_errorNUMERICTriggered Send Not Sent Due To ErrorIndicates number of triggered send messages not sent due to error. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_not_sent_due_to_opt_outNUMERICTriggered Send Not Sent Due To Opt OutIndicates number of sends not completed due to a subscriber's decision to opt out of receiving messages. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_not_sent_due_to_undeliverableNUMERICTriggered Send Not Sent Due To UndeliverableIndicates number of sends not completed due to a subscriber's undeliverable status. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_opensNUMERICTriggered Send OpensIndicates number of opens from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_opt_outsNUMERICTriggered Send Opt OutsIndicates number of subscribers who opted out of receiving messages after receiving a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_queuedNUMERICTriggered Send QueuedIndicates number of messages queued for sending. Current queue count of the triggered send definition, which falls as the queue drains and is not limited to the requested date range.
triggered_send_sentNUMERICTriggered Send SentIndicates number of messages sent. Indicates the message was sent to a subscriber. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_survey_responsesNUMERICTriggered Send Survey ResponsesIndicates number of responses to a survey question contained in a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_unique_clicksNUMERICTriggered Send Unique ClicksIndicates number of unique clicks on message. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_unique_conversionsNUMERICTriggered Send Unique ConversionsIndicates number of unique conversions resulting from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.
triggered_send_unique_opensNUMERICTriggered Send Unique OpensIndicates number of unique opens resulting from a triggered send. Lifetime total of the triggered send definition, not limited to the requested date range.

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.

IDTypeNameDescriptionReport
data_fetched_atTIMESTAMPData fetched atUTC 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.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateDate of the object's creation.General
day_of_monthTEXTDay of monthDay of the month
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20