{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Integrations","type":"markdown"},"seo":{"title":"SAP Marketing Cloud Import Integration","description":"Comprehensive guide to integrating SAP Marketing Cloud with Treasure AI, covering data import, segmentation, and incremental loading techniques for unified customer data management.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"sap-marketing-cloud-import-integration","__idx":0},"children":["SAP Marketing Cloud Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SAP Marketing Cloud (previously Hybris Marketing) is a marketing solution that provides real-time context-based data about individual customers and anonymous visitors by unifying user data into a centralized hub."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This allows brands to deliver consistent, contextual, and relevant experiences throughout a customer journey, regardless of the marketing channel or device."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data Management: provides you with a 360 view of people interacting with your brand, enabling you to target them within the right context, in real-time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recommendation: delivers timely and highly relevant recommendations to your customers, helping you translate interest into conversion."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segmentation: offers high-performing audience segmentation in real-time, enabling you to personalize campaigns across multiple channels."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic Knowledge of Treasure Data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Communication user"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"about-incremental-data-loading","__idx":2},"children":["About Incremental Data Loading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When incremental loading is enabled, the query issued to SAP Marketing Cloud contains the $filter statement. The $filter queries data for desired criteria",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["$filter is generated based on the filter_column, start_time, and end_time configurations."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The first value received will be kept as a reference for the next job filter. The next job $filter excludes previous job data and fetches new data only."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The process repeats for subsequence executions."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-4-6_18-43-24.86d03abace4ca184c72b6857a6cc454f40bca56d8884edae922267e2da2e50bd.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the end_timevalue is empty when incremental loading is enabled, it will automatically be set to the time job is executed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The filter_column should satisfy the following conditions in metadata:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contain Type Edm.DateTimeOffset or Edm.DateTime"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contain Nullable=\"false\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Does not contain sap:sortable=\"false\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Does not contain sap:filterable=\"false\""]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incremental loading only supports Timestamp columns(Edm.DateTimeOffset and Edm.DateTime)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["All record containing empty value for filter_column field will be ignored."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtaining-communication-user","__idx":3},"children":["Obtaining Communication User"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Communication User is defined in the SAP Marketing Cloud system (for example, INTEGRATION_TREASURE_DATA is the username, and the password is xxxx). The username and password here will be used as basic authentication to get x-csrf-token."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/e55bc95f-dfd8-45e9-af3a-ff9ec6845c48.5d1e50463268a02e6b56ecd4559337e8ad070b048adf3e0f994c0449bf1f965f.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Communication System is created and set up for this Communication User. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Learn more about SAP's Communication System setup."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/6835ee0a-a724-490c-9556-c0f752f7ad40.b00037b436aa2b72a9733f50de6411bbcd48e0957f2df5e49a2aa6117f4563a3.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn about setting up communication with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.sap.com/cxworks/article/2589632510/how_to_set_up_communication_to_other_systems_for_sap_marketing_cloud"},"children":["Other Systems for SAP Marketing Cloud"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-treasure-console-to-create-your-connection","__idx":4},"children":["Use the Treasure Console to Create Your Connection"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-new-connection","__idx":5},"children":["Create a New Connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Treasure Data, you must create and configure the data connection prior to running your query. As part of the data connection, you provide authentication to access the integration."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure Console"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations Hub"]}," >  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catalog"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP Marketing Cloud"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_4-48-16.aad25859a6f44036debcad92a3948b56c07906718cae97397724e24403da2888.01d5f7cb.png","alt":""},"children":[]}," ","4. Select Create Authentication."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-11-5.1511d3671ddc0effe38ab473541ce573bc06e8cadcc78db89b2c4eeafa26b3d3.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Input Authentication data:"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]},": Your SAP Marketing Cloud communication username"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]},": Your SAP Marketing Cloud communication user's password"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tenant ID"]},": Your SAP Marketing Cloud tenant id"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-12-0.f1f046ae02457ce5615b5871d68336069a0651061b59733a3b3240b0f43bfe3b.01d5f7cb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Input the name for this authentication."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_4-50-30.c2e32f45d0a1daa2a0f463eed8382b4153bdee193d01e06f25ab8dfe6d944e82.01d5f7cb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transfer-your-data-to-treasure-data","__idx":6},"children":["Transfer Your Data to Treasure Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creating the authenticated connection, you are automatically taken to Authentications."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for the connection you created."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select New Source."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Type a name for your Source in the Data Transfer field.",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_4-52-41.7bc1c4f1c0ed09c214e70ec7dba21ec2f1911630888261e94212debef5b39369.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"; the Source Table dialog opens.",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_4-54-12.c4365d12e371162a89725c66f8ad19d758c4ffe46c40b76a151fdd6db96c74a8.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Edit the following parameters."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Configuration Name"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configuration Name"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Target SAP Marketing Cloud service name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API Version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The version of service you would like to use"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The entity from which you would like to ingest data from"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incremental"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When run repeatedly, attempt to only import new data since the last import"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter Column"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime/DateTimeOffset column for incremental load or filtering (Case sensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start Time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Import data since this time"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["End Time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Import data until this time"]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next,"]}," The Data Settings page can be modified for your needs, or you can skip the page.",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-0-6.c00c9b45efdfb34e4e83455b16b6c306d987ea8fd5d927ed8f6467ca7c687ee8.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally, edit the following parameters:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch Size"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of records to ingest per API call"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry Limit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum retry times for each API call"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Initial retry time wait in millis"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait time for the first retry (in milliseconds)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max retry wait in mills"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum wait time for an API call before it gives up"]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":8},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next,"]}," Data Preview dialog opens"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click Generate Preview to preview data or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Skip this step"]}," to move to the next page."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-1-45.8428dadf3dd46a8e198aaade8438e971d2e91c1d2bc3c4e7b67892e327835730.01d5f7cb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next,"]}," Data Placement dialog opens."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-7-14.b6e17c49ce3d400ca08000a0c0bca2e845d3355d219d5d43fdd2e81daa9a3cc2.01d5f7cb.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create & Run Now"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"import-via-workflow","__idx":7},"children":["Import via Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can import data from MS Dynamics 365 Sale by using td_load>: operator of workflow. If you have already created a SOURCE, you can run it."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify your source."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To obtain a unique ID, open the Source list and then filter bySAP Marketing Cloud."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the menu and select Copy Unique ID.",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-10-12_12-26-58.09d9b84b0f1f752c7c95b0bc1c2d8e8b7302e5b91c6a3cb5f01309dadf53a604.01d5f7cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Define a workflow task using td_load> operator."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"+load:\n  td_load>: unique_id_of_your_source\n  database: ${td.dest_db}\n  Table: ${td.dest_table}\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run a workflow."]}]}]},"headings":[{"value":"SAP Marketing Cloud Import Integration","id":"sap-marketing-cloud-import-integration","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"About Incremental Data Loading","id":"about-incremental-data-loading","depth":2},{"value":"Obtaining Communication User","id":"obtaining-communication-user","depth":2},{"value":"Use the Treasure Console to Create Your Connection","id":"use-the-treasure-console-to-create-your-connection","depth":2},{"value":"Create a New Connection","id":"create-a-new-connection","depth":3},{"value":"Transfer Your Data to Treasure Data","id":"transfer-your-data-to-treasure-data","depth":3},{"value":"Import via Workflow","id":"import-via-workflow","depth":2}],"frontmatter":{"seo":{"title":"SAP Marketing Cloud Import Integration","description":"Comprehensive guide to integrating SAP Marketing Cloud with Treasure AI, covering data import, segmentation, and incremental loading techniques for unified customer data management."}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/int/sap-marketing-cloud-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}