{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Integrations","type":"markdown"},"seo":{"title":"SAP Marketing Cloud Export Integration","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","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-export-integration","__idx":0},"children":["SAP Marketing Cloud Export 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. This allows brands to deliver consistent, contextual, and relevant experiences throughout a customer journey, regardless of the marketing channel or device. Some of the features of this solution are"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data Management — provides a 360 degree view of people interacting with your brand, enabling you to target them in the right context in real-time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recommendations — deliver timely and highly relevant recommendations to your customers, helping you translate customer interest into conversion."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segmentation — offers high-performing audience segmentation in real-time enabling you to personalized campaigns across multiple channels."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-can-you-do-with-this-integration","__idx":1},"children":["What can you do with this Integration?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As SAP Marketing Cloud strictly follows the Open Data Protocol (OData) principles with multiple services in their ecosystems, you can build a flexible solution which can"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Export, update, and delete data to SAP Marketing Cloud products using the OData Protocol."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support custom use cases offered by SAP Marketing Cloud ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_MARKETING_CLOUD/0f9408e4921e4ba3bb4a7a1f75f837a7/672a497c82154a84bae6f62d63906339.html"},"children":["SAP Marketing Cloud - Integration APIs"]},". For example, you could",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign an Interaction Contact to a specific target group: e.g.  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_MARKETING_CLOUD/0f9408e4921e4ba3bb4a7a1f75f837a7/aeff53478fc648ac817e5330e12b44d8.html"},"children":["SAP Marketing Cloud - Structure of OData Service API_MKT_TARGET_GROUP_SRV"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update or create contact relationship data: e.g.  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_MARKETING_CLOUD/0f9408e4921e4ba3bb4a7a1f75f837a7/95f2c87395bb4dda905010423029c23e.html"},"children":["SAP Marketing Cloud - Structure of OData Service API_MKT_CONTACTS"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incorporate any related interaction listed in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://api.sap.com/package/SAPS4HANAMarketingCloud/all"},"children":["SAP Marketing Cloud - API Hub"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"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":["Basic Knowledge of SAP Marketing Cloud."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic Knowledge of Open Data Protocol."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements-and-limitations","__idx":3},"children":["Requirements and Limitations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SAP communication user account"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"static-ip-address-of-treasure-data-integration","__idx":4},"children":["Static IP Address of Treasure Data Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your security policy requires IP whitelisting, you must add Treasure Data's IP addresses to your allowlist to ensure a successful connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please find the complete list of static IP addresses, organized by region, at the following ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/endpoints/ip-addresses-integrations-result-workers"},"children":["document"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-treasure-console-to-create-a-connection","__idx":5},"children":["Use the Treasure Console to Create a 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":"Heading","attributes":{"level":3,"id":"create-a-new-authentication","__idx":6},"children":["Create a New Authentication"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure Console"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","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":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAP Marketing Cloud"]},"and select it."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-11-55.1582dca8722f3a6cd89167963bf76dfe31eacd3556fcaa6cd88745a4db929c77.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Authentication"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-12-44.39756d395b1e53bfa81cf3c33f205e498b4197364d73eb3f660c958d7b1ca68d.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the credentials to authenticate:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-7-21_5-12-0.f1f046ae02457ce5615b5871d68336069a0651061b59733a3b3240b0f43bfe3b.e4797ce9.png","alt":"image2022-7-21_5-12-0.png"},"children":[]}]},{"$$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":["Username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud communication username"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Password"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud communication user's password"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tenant ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud tenant id"]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter a name for your connection."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"define-your-query","__idx":7},"children":["Define your Query"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Workbench > Queries"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Query"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter your query."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run"]}," to perform the query and to validate the result set."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-21-50.123f940068e5d49a4d72e3600c65ddee494506182c6cfb9e82d94246125e3aa2.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-the-result-export-target","__idx":8},"children":["Specify the Result Export Target"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Export Results"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-23-9.0ebf8dca9d15729528ea8782bc26c178939fb4e4a4e119418caf17244915781f.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can select an existing authentication or create a new authentication for the external service to be used for output. Choose one of the following:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use Existing Integration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-7_15-28-30.d271866c7c3cea4dab234b61bea815a69b186746c80435855b4b86d1f77cc30e.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a New Integration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-24-10.0a73fe3171b094e28f7eb3a3dce6feae830d49d76089768c845ec18b9ac8bded.e4797ce9.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-9-27_11-26-3.73ab0f9461f044bbeaae35e0169cf83631c3d7bf8e3ead636c697ab6b325bb7e.e4797ce9.png","alt":""},"children":[]}]},{"$$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":{"width":"25%","data-label":"Field"},"children":["Field "]},{"$$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":["Target SAP Marketing Cloud service name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service Version"]},{"$$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":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Target Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Target Type you would like to use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Entity name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom path"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This will affect how the URL is built for the chosen action. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/sap-marketing-cloud-export-integration#appendix"},"children":["Appendix"]}," for more detail."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity which you would like to export data to"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom Path URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom Path URL template for resource.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","This is required for complicated paths which could not be handled by a standard OData entity. This option follows the format of screen-shot{{name}}—screen-shot which means that the name will be replaced by the actual data row you transferred to the integration.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","For example, screen-shotTargetGroups(guid'{{TargetGroupUUID}}')/TargetGroupInteractionContactsscreen-shot"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Action"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The action will be applied to data",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Full Update"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Partial Update"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delete"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upsert"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch Size"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of records to egest per API call."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-schedule-query-export-jobs","__idx":9},"children":["(Optional) Schedule Query Export Jobs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use Scheduled Jobs with Result Export to periodically write the output result to a target destination that you specify."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Data's scheduler feature supports periodic query execution to achieve high availability."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When two specifications provide conflicting schedule specifications, the specification requesting to execute more often is followed while the other schedule specification is ignored."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, if the cron schedule is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 1 * 1'"]},", then the 'day of month' specification and 'day of week' are discordant because the former specification requires it to run every first day of each month at midnight (00:00), while the latter specification requires it to run every Monday at midnight (00:00). The latter specification is followed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"scheduling-your-job-using-treasure-console","__idx":10},"children":["Scheduling your Job Using Treasure Console"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Workbench > Queries"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new query or select an existing query."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schedule"]},", select None."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the drop-down, select one of the following schedule options:"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png","alt":""},"children":[]}]},{"$$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":"Drop-down Value"},"children":["Drop-down Value"]},{"$$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":["Custom cron..."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#custom-cron-details"},"children":["Custom cron... details"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["@daily (midnight)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run once a day at midnight (00:00 am) in the specified time zone."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["@hourly (:00)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run every hour at 00 minutes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No schedule."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"custom-cron-details","__idx":11},"children":["Custom cron... Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png","alt":""},"children":[]}]},{"$$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":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cron Value"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0 * * * *"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run once an hour."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0 0 * * *"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run once a day at midnight."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0 0 1 * *"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run once a month at midnight on the morning of the first day of the month."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a job that has no scheduled run time."]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":" *    *    *    *    *\n -    -    -    -    -\n |    |    |    |    |\n |    |    |    |    +----- day of week (0 - 6) (Sunday=0)\n |    |    |    +---------- month (1 - 12)\n |    |    +--------------- day of month (1 - 31)\n |    +-------------------- hour (0 - 23)\n +------------------------- min (0 - 59)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following named entries can be used:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Day of Week: sun, mon, tue, wed, thu, fri, sat."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A single space is required between each field. The values for each field can be composed of:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"fixed-table"},"children":[{"$$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":{"width":"35%","data-label":"Field Value"},"children":["Field Value "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Example"},"children":["Example "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"45%","data-label":"Example Description"},"children":["Example Description "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A single value, within the limits displayed above for each field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A wildcard ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'*'"]}," to indicate no restriction based on the field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 1 * *'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configures the schedule to run at midnight (00:00) on the first day of each month."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A range ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'2-5'"]},", indicating the range of accepted values for the field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 1-10 * *'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configures the schedule to run at midnight (00:00) on the first 10 days of each month."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A list of comma-separated values ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'2,3,4,5'"]},", indicating the list of accepted values for the field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 1,11,21 * *'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configures the schedule to run at midnight (00:00) every 1st, 11th, and 21st day of each month."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A periodicity indicator ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'*/5'"]}," to express how often based on the field's valid range of values a schedule is allowed to run."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'30 */2 1 * *'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configures the schedule to run on the 1st of every month, every 2 hours starting at 00:30. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 */5 * *'"]}," configures the schedule to run at midnight (00:00) every 5 days starting on the 5th of each month."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A comma-separated list of any of the above except the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'*'"]}," wildcard is also supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'2,*/5,8-10'"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'0 0 5,*/10,25 * *'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configures the schedule to run at midnight (00:00) every 5th, 10th, 20th, and 25th day of each month."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) You can delay the start time of a query by enabling the Delay execution."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"execute-the-query","__idx":12},"children":["Execute the Query"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the query with a name and run, or just run the query. Upon successful completion of the query, the query result is automatically exported to the specified destination."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scheduled jobs that continuously fail due to configuration errors may be disabled on the system side after several notifications."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["(Optional) You can delay the start time of a query by enabling the Delay execution."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activate-a-segment-in-audience-studio","__idx":13},"children":["Activate a Segment in Audience Studio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also send segment data to the target platform by creating an activation in the Audience Studio."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audience Studio"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a parent segment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the target segment, right-mouse click, and then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Activation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]}," panel, enter an Activation name and configure the activation according to the previous section on Configuration Parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customize the activation output in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output Mapping"]}," panel."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Attribute Columns",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Export All Columns"]}," to export all columns without making any changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add Columns"]}," to add specific columns for the export. The Output Column Name pre-populates with the same Source column name. You can update the Output Column Name. Continue to select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add Columns"]},"to add new columns for your activation output."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["String Builder",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add string"]}," to create strings for export. Select from the following values:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["String: Choose any value; use text to create a custom value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timestamp: The date and time of the export."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segment Id: The segment ID number."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Segment Name: The segment name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audience Id: The parent segment number."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schedule"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the values to define your schedule and optionally include email notifications."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need to create an activation for a batch journey, review ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation"},"children":["Creating a Batch Journey Activation"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-configure-export-results-in-workflow","__idx":14},"children":["(Optional) Configure Export Results in Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Within Treasure Workflow, you can specify the use of this integration to export data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tools/cli-and-sdks/api#workflow-commands"},"children":["Using Workflows to Export Data with the TD Toolbelt"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-export-integration-using-the-cli","__idx":15},"children":["(Optional) Export Integration Using the CLI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also use the TD Toolbelt for Result Export to SAP Marketing Cloud. You need to specify the information for export to SAP Marketing Cloud as screen-shot--resultscreen-shot option of screen-shottd queryscreen-shot command. For more information about screen-shottd queryscreen-shot see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tools/cli-and-sdks/api#query-commands"},"children":["Query Commands"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The format of the option is JSON and the general structure is as follows."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"sap_marketing_cloud\",\n  \"username\": \"user\",\n  \"password\": \"pass}HrNAJE\",\n  \"tenant_id\": \"mytenant\",\n  \"service_name\": \"API_MKT_INTERACTION_SRV\",\n  \"target_type\": \"entity_name\",\n  \"api_version\": null,\n  \"entity_name\": \"InteractionTags\",\n  \"action\": \"create\",\n  \"batchSize\": 1000\n}\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parameters","__idx":16},"children":["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":{"width":"20%","data-label":"Name"},"children":["Name "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"35%","data-label":"Description"},"children":["Description "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Value"},"children":["Value "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"10%","data-label":"Default Value"},"children":["Default Value "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"15%","data-label":"Required"},"children":["Required "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud communication username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["password"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud communication user's password"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["tenant_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your SAP Marketing Cloud tenant id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["service_name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Target SAP Marketing Cloud service name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["api_version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The version of service you would like to use"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["target_type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Target Type you would like to use"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["entity_name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["custom_path"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["entity_name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["custom_path_url"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom path URL template for resource required complicated path"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For example:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TargetGroups(guid'{{TargetGroupUUID}}')/TargetGroupInteractionContacts"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes if ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["target_type"]}," is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom_path"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["entity_name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity which you would like to export data to"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes if ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["target_type"]}," is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["entity_name"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["action"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The action will be applied to data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["create"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["update"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["partial_update"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["delete"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["upsert"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["batch_size"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of records to flush per API call"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1000"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["skip_invalid_records"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether invalid records should be ignored"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["true"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["false"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["true"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$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":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["initial_retry_wait"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait time for the first retry (in seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["60"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["max_retry_wait"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum wait time for an API call before it gives up (in seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["120"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["connection_timeout_secs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max connection timeout per API call (in seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["120"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["read_timeout_secs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max read timeout per API call (in seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["120"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["write_timeout_secs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max write timeout per API call (in seconds)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numeric value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["120"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"screen-shotentity_namescreen-shot-case","__idx":17},"children":["screen-shotentity_namescreen-shot Case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["entity_name"]}," as target_type."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td query \\\n  --result '{\n    \"type\": \"sap_marketing_cloud\",\n    \"username\": \"user\",\n    \"password\": \"pass\",\n    \"tenant_id\": \"mytenant\",\n    \"service_name\": \"API_MKT_INTERACTION_SRV\",\n    \"api_version\": null,\n    \"entity_name\": \"InteractionTags\",\n    \"action\": \"create\",\n    \"batchSize\": 1000\n  }' \\\n  -d sample_datasets \\\n  \"SELECT * FROM interactiontags\" \\\n  -T presto\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"screen-shotcustom_pathscreen-shot-case","__idx":18},"children":["screen-shotcustom_pathscreen-shot Case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom_path"]},"as target_type."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td query \\\n  --result '{\n    \"type\": \"sap_marketing_cloud\",\n    \"username\": \"user\",\n    \"password\": \"pass\",\n    \"tenant_id\": \"mytenant\",\n    \"service_name\": \"API_MKT_TARGET_GROUP_SRV\",\n    \"action\": \"create\",\n    \"target_type\": \"custom_path\",\n    \"custom_path_url\": \"TargetGroups(guid'\\''{{TargetGroupUUID}}'\\'')/TargetGroupInteractionContacts\",\n    \"batch_size\": 1000\n  }' \\\n  -d sample_datasets \\\n  \"SELECT * FROM targetGroupinteractioncontacts\" \\\n  -T presto\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"appendix","__idx":19},"children":["Appendix"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-determine-entity-name","__idx":20},"children":["How To Determine Entity Name"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entity Namecan be retrieved in various ways. Here are two examples"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using Integration APIs Document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using Integration APIs"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, API_MKT_CONTACT_SRV is used as the target service."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integrations-apis-document","__idx":21},"children":["integrations APIs Document"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve data using Integration APIs Document:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_MARKETING_CLOUD/0f9408e4921e4ba3bb4a7a1f75f837a7/672a497c82154a84bae6f62d63906339.html"},"children":["SAP Marketing Cloud - Integration APIs"]}," to find public APIs available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to OData Service Structure for the corresponding service (e.g.  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.sap.com/docs/SAP_MARKETING_CLOUD/0f9408e4921e4ba3bb4a7a1f75f837a7/95f2c87395bb4dda905010423029c23e.html"},"children":["Structure of OData Service API_MKT_CONTACTS"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Related information about the structures, entity sets, and supports operations is available here."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integrations-apis","__idx":22},"children":["Integrations APIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve data using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration APIs"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call the screen-shot$metadatascreen-shot endpoint of target service."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location --request GET \\\n  'https://{tenant}.s4hana.ondemand.com/sap/opu/odata/sap/API_MKT_CONTACT_SRV/$metadata' \\\n  --header 'x-csrf-token: Fetch' \\\n  --header 'Authorization: Basic {encode_base_64(username:password)}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the response documents, find the screen-shotEntityContainer Name=\"{TARGET_SERVICE}_Entities\"screen-shot . In this example, this will be screen-shotEntityContainer Name=\"API_MKT_CONTACT_SRV_Entities\".screen-shot"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"<EntityContainer\n  Name=\"API_MKT_CONTACT_SRV_Entities\"\n  m:IsDefaultEntityContainer=\"true\"\n  sap:supported-formats=\"atom json xlsx pdf\">\n  <EntitySet\n    Name=\"MarketingAreas\"\n    EntityType=\"API_MKT_CONTACT_SRV.MarketingArea\"\n    sap:creatable=\"false\"\n    sap:deletable=\"false\"\n    sap:content-version=\"4\"/>\n  <EntitySet\n    Name=\"MarketingLocations\"\n    EntityType=\"API_MKT_CONTACT_SRV.MarketingLocation\"\n    sap:creatable=\"false\"\n    sap:deletable=\"false\"\n    sap:content-version=\"4\"/>\n  <EntitySet\n    Name=\"Contacts\"\n    EntityType=\"API_MKT_CONTACT_SRV.Contact\"\n    sap:creatable=\"false\"\n    sap:updatable=\"false\"\n    sap:deletable=\"false\"\n    sap:content-version=\"4\"/>\n  <EntitySet\n    Name=\"ContactOriginData\"\n    EntityType=\"API_MKT_CONTACT_SRV.ContactOriginData\"\n    sap:creatable=\"false\"\n    sap:deletable=\"false\"\n    sap:content-version=\"4\"/>\n</EntityContainer>\n","lang":"xml"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the screen-shotEntitySetscreen-shot you would like to ingest."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the text inside the screen-shotName=screen-shot quotations marks.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This name will be used in the GUI: e.g. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MarketingAreas"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MarketingLocations"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ContactOriginData"]},", etc."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"target-type","__idx":23},"children":["Target Type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Target types affect how the URL is built for chosen action. There are two options for Target Type:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Entity name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom path."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the entity name option, the prefix of the URL will be built based on screen-shottenant_idscreen-shot, screen-shotservice_namescreen-shot, and screen-shotentity_namescreen-shot with following template:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://{{tenant_id}}.s4hana.ondemand.com/sap/opu/odata/sap/{{service_name}}/{{entity_name}}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the custom path option, the prefix of the URL will be built based on screen-shottenant_idscreen-shot, screen-shotservice_namescreen-shot, and screen-shotcustom_path_urlscreen-shot, and exported data*.* The custom path is built by expanding tags in a screen-shotcustom_path_urlscreen-shot using values provided from the exported data. Then, it is combined with the common prefix."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://{{tenant_id}}.s4hana.ondemand.com/sap/opu/odata/sap/{{service_name}}/{{custom path}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, with the following custom_path configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"target_type: custom_path\ntenant_id: my_tenant\nservice_name: API_MKT_CONTACT_SRV\ncustom_path_url: TargetGroups(guid'{{TargetGroupUUID}}')/TargetGroupInteractionContacts\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["And using the following exported data:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"InteractionContactUUID,TargetGroupUUID\n00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The URL endpoint for the custom path would be:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://my_tenant.s4hana.ondemand.com/sap/opu/odata/sap/API_MKT_CONTACT_SRV/TargetGroups(guid'00000000-0000-0000-0000-000000000001')/TargetGroupInteractionContacts\n"},"children":[]}]},"headings":[{"value":"SAP Marketing Cloud Export Integration","id":"sap-marketing-cloud-export-integration","depth":1},{"value":"What can you do with this Integration?","id":"what-can-you-do-with-this-integration","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Requirements and Limitations","id":"requirements-and-limitations","depth":2},{"value":"Static IP Address of Treasure Data Integration","id":"static-ip-address-of-treasure-data-integration","depth":2},{"value":"Use the Treasure Console to Create a Connection","id":"use-the-treasure-console-to-create-a-connection","depth":2},{"value":"Create a New Authentication","id":"create-a-new-authentication","depth":3},{"value":"Define your Query","id":"define-your-query","depth":3},{"value":"Specify the Result Export Target","id":"specify-the-result-export-target","depth":3},{"value":"(Optional) Schedule Query Export Jobs","id":"optional-schedule-query-export-jobs","depth":3},{"value":"Scheduling your Job Using Treasure Console","id":"scheduling-your-job-using-treasure-console","depth":4},{"value":"Custom cron... Details","id":"custom-cron-details","depth":4},{"value":"Execute the Query","id":"execute-the-query","depth":3},{"value":"Activate a Segment in Audience Studio","id":"activate-a-segment-in-audience-studio","depth":2},{"value":"(Optional) Configure Export Results in Workflow","id":"optional-configure-export-results-in-workflow","depth":2},{"value":"(Optional) Export Integration Using the CLI","id":"optional-export-integration-using-the-cli","depth":2},{"value":"Parameters","id":"parameters","depth":3},{"value":"screen-shotentity_namescreen-shot Case","id":"screen-shotentity_namescreen-shot-case","depth":3},{"value":"screen-shotcustom_pathscreen-shot Case","id":"screen-shotcustom_pathscreen-shot-case","depth":3},{"value":"Appendix","id":"appendix","depth":2},{"value":"How To Determine Entity Name","id":"how-to-determine-entity-name","depth":3},{"value":"integrations APIs Document","id":"integrations-apis-document","depth":3},{"value":"Integrations APIs","id":"integrations-apis","depth":3},{"value":"Target Type","id":"target-type","depth":3}],"frontmatter":{"seo":{"title":"SAP Marketing Cloud Export Integration"}},"lastModified":"2026-06-01T11:27:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/int/sap-marketing-cloud-export-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}