loiof8d62f4cb1a6434bb0ff3109c04acb6a
loiof8d62f4cb1a6434bb0ff3109c04acb6a
loiof8d62f4cb1a6434bb0ff3109c04acb6a
1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5 Change from Replication of Business Partner with OData to Replication with SOAP. . . . . . . . . 10
6 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
6.1 Required Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
6.2 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
7 Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
7.1 Configuration in SAP Marketing Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Create Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Authorizations for Users in SAP Marketing Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Setting up Communication Arrangements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Adapt Business Configuration for Interaction Contacts in SAP Marketing Cloud. . . . . . . . . . . . . . 27
Filter for Campaigns to be Replicated to SAP Cloud for Customer (Optional) . . . . . . . . . . . . . . . 28
Determine Target System Type (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
SAP Application Interface Framework Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.2 Configuration in SAP Cloud for Customer (C4C). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Scoping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Fine Tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Communication Language for Data Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Set Up Communication System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Configure Communication Arrangements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Filter Communication Arrangements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Change the Assignment of Categories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Assigning Involved Parties for Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Create Attribute and Attribute Set (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Code List Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Create and add an URL Mash-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
7.3 Configuration in SAP Cloud Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Deploy Technical Communication User Data with a Credential Artifact. . . . . . . . . . . . . . . . . . . . 60
Deployment of the Artifacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
2 PUBLIC Content
Configure and Deploy iFlows from SAP Cloud for Customer to SAP Marketing Cloud. . . . . . . . . . 62
Configure and Deploy the iFlows from SAP Marketing Cloud to SAP Cloud for Customer. . . . . . . 65
Maintain Value Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
7.4 Data Loading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Initial Load of Account/ Contact/ Individual Customer to SAP Marketing Cloud. . . . . . . . . . . . . . 75
Initial Load of Business Partner Relationship to SAP Marketing Cloud. . . . . . . . . . . . . . . . . . . . . 76
Initial Load of Business Attribute Set and Assignment to SAP Marketing Cloud (Optional).
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
7.5 Service Ticket Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
8 Status Mapping of Data of SAP Cloud for Customer to Data of SAP Marketing Cloud. . . . . . . 80
10 Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
10.1 Maintain Organizational Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
10.2 Finding Required Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
How to get SAP Marketing Cloud Service URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
How to get SAP Marketing Cloud Client Certificate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
How to get SAP Marketing Cloud System ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
How to get SAP Cloud for Customer System ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
How to get the Integration Flow endpoints in SAP Cloud Integration. . . . . . . . . . . . . . . . . . . . . . 85
How to get the SAP Cloud Integration Runtime URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
How to Get the SAP Cloud Integration Client Certificate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
10.3 Monitoring Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Monitoring Messages in SAP Cloud Integration WebUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Monitor messages in SAP Cloud for Customer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Monitoring Messages in SAP Marketing Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
10.4 Ticket Component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Content PUBLIC 3
1 Purpose
This document describes the configuration steps necessary to integrate SAP Cloud for Customer with SAP
Marketing Cloud using SAP Cloud Integration. It is important that the individual systems being integrated are
already set up and that the connection between the systems is fine.
The document is intended as a guide to help you prepare and apply the necessary steps for successful
integration.
Mapping of Data of SAP Cloud for Customer to Data of SAP Marketing Cloud
The following table provides you with a mapping overview: Correlated objects in SAP Cloud for Customer, and
SAP Marketing Cloud.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
4 PUBLIC Purpose
Opportunity Interaction of type OPPORTUNITY, including product and
interest information
• TELEPHONE_OUTBOUND
• TELEPHONE_INBOUND
• TELEPHONE_UNSUCCESSFL
Note
The replicated information, which is stored in the interactions, and interaction contacts can be used as
attributes in segmentation within SAP Marketing Cloud.
In SAP Marketing Cloud, the replicated business partner information is displayed on contact, and/or
account profile.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Purpose PUBLIC 5
2 Document History
The following table provides an overview of the most important document changes.
Document History
Date Description
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
6 PUBLIC Document History
3 Replicating Business Partner with SOAP
Business partner are replicated using iflows. The graphic shows how business partners are mapped and
transferred.
Note
In the following graphics, the replication of business partners from SAP Cloud for Customer to SAP
Marketing Cloud is illustrated. However, it is also possible to replicate business bartners from SAP
Marketing Cloud to SAP Cloud for Customer. When you trigger a lead transfer for a new interaction contact
in MKT, a marketing-generated lead is generated in SAP Cloud for Customer.
For a detailed description of these iFlows, see Overview of Communication Arrangements and iFlows [page
8].
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Replicating Business Partner with SOAP PUBLIC 7
4 Overview of Communication
Arrangements and iFlows
SAP_COM_0017 Campaign Header MKT to Replicate Campaign from Campaign Replication from
C4C SAP Marketing SAP Business Suite
Request Campaign Data C4C Request Campaign Interac- Request Campaign Interac-
to MKT tions from SAP Marketing tions from SAP Business
Suite
Lead from MKT to C4C Replicate Lead with Business Lead Replication from SAP
Business Suite
Partner Address Information
from SAP Marketing
Lead from C4C to MKT Replicate Marketing Lead to Lead Replication to SAP
SAP Marketing Business Suite
Note
If your integration is al-
ready set up, please use
V1.
Ticket from C4C to MKT Replicate Service Ticket to Service Ticket Replication to
SAP Marketing SAP Business Suite
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
8 PUBLIC Overview of Communication Arrangements and iFlows
Communication Arrange-
Communication Arrange- iFlows SAP Cloud ment SAP Cloud for Cus-
ment SAP Marketing Cloud Scenario Integration tomer
Marketing Attributes from Replicate Business Attribute Business Attribute and As-
C4C to MKT signment Replication with
Set to SAP Marketing
SAP Marketing
Replicate Business Attribute
Assignment to SAP Market-
ing
none Value Mapping used in iFlows Value Mapping for SAP Cloud none
for Customer and SAP Mar-
keting Integration
SAP_COM_0003 Marketing Permissions from Replicate Marketing Permis- Marketing Permission Repli-
C4C to MKT (initial load sion to SAP Marketing cation to SAP Business Suite
only!)
SAP_COM_0475 Account, Individual Cus- Replicate Business Partner to Business Partner Replication
tomer and Contact Person to SAP Business Suite
SAP Marketing via Business
from C4C to MKT
Partner Web Services
SAP_COM_0539 ID Mapping from C4C to MKT Replicate Key Mapping to ID Mapping Replication to
SAP Marketing SAP Business Suite
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Overview of Communication Arrangements and iFlows PUBLIC 9
5 Change from Replication of Business
Partner with OData to Replication with
SOAP
You have set up and introduced an integration between SAP Cloud for Customer and SAP Marketing Cloud to
replicate accounts, individual customers and contacts making use of OData services.
With the introduction of the new SOAP-based business partner services, consider an update of your integration
scenarios according to the following guidelines:
You need to update to SOAP-based integration if one of the following cases apply:
• You want to make use of Contact-to-Account Relationships in SAP Marketing Cloud (for more information,
see the SAP Marketing Cloud application help at Contact-to-Account Relationships).
• You want to connect more than one SAP Cloud for Customer tenant with one SAP Marketing Cloud tenant
(for more information, see the SAP Community blog How To Integrate Multiple SAP Cloud for Customer
Systems with SAP Marketing Cloud ).
Note
The SOAP integration does not allow you to merge 2 or more business partners from SAP Cloud for
Customer into 1 interaction contact in SAP Marketing Cloud.
If you have already merged business partners into one interaction contact before, you cannot migrate
those business partners to the SOAP integration. We recommend that you delete these merged interaction
contacts in SAP Marketing Cloud, before you start to migrate to SOAP.
You can skip the update to SOAP-based integration and keep your already implemented OData-based
integration if the following applies:
You are happy with your current scenario and do not plan to change anything in future. The pure OData-based
data integration between SAP Cloud for Customer and SAP Marketing Cloud will continue to be supported in
maintenance mode.
Procedure:
1. In SAP Cloud for Customer, configure the Filter Communication Arrangements. For more information, see
Filter Communication Arrangements [page 51].
2. In SAP Cloud for Customer, do the scoping for the ID Mapping service. For more information, see Code
List Mapping [page 55]. Also, create the related communication arrangement. For more information, see
Configure Communication Arrangements [page 47].
3. In SAP Cloud for Customer, the following iFlows have to be changed. Undeploy the old iFlows, and deploy
the new ones.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
10 PUBLIC Change from Replication of Business Partner with OData to Replication with SOAP
Old iFlow New iFlow
Replicate Marketing Lead to SAP Marketing Replicate Marketing Lead to SAP Marketing V2 Interface
Confirm Lead Replication to SAP Marketing Confirm Lead Replication to SAP Marketing V2 Interface
Replicate Business Partner Relationship to SAP Marketing Replicate Business Partner Relationship to SAP Marketing
via Business Partner Web Services
Replicate Business Partner to SAP Marketing Replicate Business Partner to SAP Marketing via Business
Partner Web Services
Value Mapping for SAP Cloud for Customer and SAP New values are needed:
Marketing Cloud • BusinessPartnerRoleCode
• BusinessPartnerRelationshipCategoryCode
5. In SAP Marketing Cloud, create the new communication scenarios, Communication Arrangement
SAP_COM_0475 [page 26] and Communication Arrangement for SAP_COM_0539 [page 25].
6. Remember
Please note, that the SOAP integration does not allow you to merge 2 or more business partners from
SAP Cloud for Customer into 1 interaction contact in SAP Marketing Cloud.
If you have already merged business partners into one interaction contact before, you cannot migrate
those business partners to the SOAP integration. We recommend that you delete these merged
interaction contacts in SAP Marketing Cloud, before you start to migrate to SOAP.
Replicate all accounts, individual customers and contacts via the initial load reports on SAP Cloud for
Customer side. Newly replicated business partner data will be stored under the origin SAP_MKT_BUPA.
For more information, see Initial Load of Account/ Contact/ Individual Customer to SAP Marketing Cloud
[page 75].
7. Business partner data from the old integration setup with OData, is still stored under origin SAP_C4C_BUPA
and must be deleted. To delete the old business partner data, and to finalize the migration, please open a
ticket on the component CEC-MKT-DM-IC and reference this guide.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Change from Replication of Business Partner with OData to Replication with SOAP PUBLIC 11
6 Preparation
During the activities described in this guide, you will be required to enter or provide system-specific
information. To ensure a smooth and efficient integration to SAP Marketing Cloud, we recommend that you
have the information listed in the table below at hand prior to starting the integration process.
Information Required:
Note
To know more about the release notes with regards to SAP Cloud Integration content information for
Marketing integration refer to the SAP note:2432847 .
6.2 Prerequisites
It is mandatory that scope item SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9) is active.
You can check this in the App Manage Your Solution under View Solution Scope. If the scope item is not active,
please request the activation via BCP – Ticket Component: XX-S4C-OPR-SRV.
You should have access to your SAP Marketing Cloud tenant. This includes:
• Initial user and access information for your SAP Marketing Cloud.
You should have access to SAP Cloud Integration system. This includes:
• Initial user and access information for your SAP Cloud Integration tenant.
You should have access to SAP Cloud for Customer system. This includes:
• Initial user and access information for your SAP Cloud for Customer tenant.
Optionally, you can download the SAP Cloud Integration certificate from Operations View Keystore , then
choose Select and download certificate sap_cloudintegrationcertificate.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
12 PUBLIC Preparation
7 Configuration
The following sections describe all settings required for this scope item. These can be divided into groups:
• Prerequisite settings that should be checked and which are delivered by SAP
• Communication Arrangement set-up
7.1.1 Prerequisites
Before doing the configuration in SAP Marketing Cloud, you need to have the administrator business user,
which contains the business catalog SAP_CORE_BC_COM (Communication Management), for example the
business role SAP_BR_ADMINISTRATOR (Administrator).
If you use the administrator to log on to the system, you can find these three applications in Communication
Management.
Note
SAP Marketing Cloud scope item JC0 - Marketing Lead Management and Activities for Sales is a
prerequisite for running the business processes for integrations.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 13
7.1.2 Create Users
Overview
The key user in SAP Marketing Cloud system is used for creating campaigns, leads, and monitoring, and so on.
Note
If you have integrated SAP SuccessFactors Employee Central with SAP Marketing Cloud, you can assign an
existing employee as a business user and continue with the next chapter.
Procedure
Note
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
14 PUBLIC Configuration
Note
All users details maintained in the file imported during Import Employee steps above will have same
initial password (Initial1!) which needs to be changed during the first logon to the SAP Marketing Cloud
system.
Procedure
3. Search your KEYUSER (Example: MARKETINGEXPERT) in the Search tab and choose to open it.
Depending on your scenario, you need to activate different communication arrangements in SAP Marketing
Cloud.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 15
1. Create a technical communication user.
2. Define communication systems for SAP Cloud Integration and SAP Cloud for Customer.
3. Maintain all the communication arrangements that you need for your scenario.
Overview
The communication user defined in the SAP Marketing Cloud system is used for inbound communication and
for the processing of messages in the system. Technically the user is needed to call SOAP services in SAP
Marketing Cloud from SAP Cloud Integration.
Prerequisites
As an administrator, your user should have the catalog role ID SAP_CORE_BC_COM assigned in the SAP
Marketing Cloud tenant.
Procedure
3. Choose New.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
16 PUBLIC Configuration
4. On the next screen, maintain the following values and choose Create.
User Data
Password <password>
5. If you want to use the certificate-based authentication in the direction of SAP Cloud Integration to SAP
Marketing Cloud (inbound communication messages to SAP Marketing Cloud), select Upload and upload
the SAP Cloud Integration client certificate here.
6. Choose Create.
Use
The communication system is used to define the host name of the SAP Cloud Integration tenant and to
assign users for the inbound (from SAP Cloud Integration to SAP Marketing Cloud) and outbound (from SAP
Marketing Cloud to SAP Cloud Integration) communication.
A second communication system with the host name of the SAP Cloud for Customer system is needed to
enable the navigation from SAP Marketing Cloud to SAP Cloud for Customer. No communication user is
needed here.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 17
7.1.4.2.1 Communication System for SAP Cloud
Integration (SAP Cloud for Customer Integration)
Procedure
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
18 PUBLIC Configuration
7.1.4.2.2 Communication system for SAP Cloud for
Customer (UI Navigation)
Procedure
1. Choose New.
2. Enter a new System ID and relevant System Name and choose Create.
3. Maintain the Host Name in section Technical Data of the fully qualified SAP Cloud for Customer UI server.
4. Choose Save.
The communication system defined in the SAP Marketing Cloud system is used as the source or target system.
Procedure
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 19
4. 4. Enter the System ID. Optionally, you can enter the ID to recognize the integration system, which is
connected with the SAP Marketing Cloud system. Enter a descriptive name in the System Name field.
5. Choose Create.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
20 PUBLIC Configuration
6. In the Host Name field, enter the SAP Runtime URL without HTTPS://
7. As Logical System ID, enter the SAP tenant ID.
8. As Business System ID, enter the SAP tenant ID.
9. Under User for Inbound Communication, choose Add.
10. Choose an Authentication Method as per your requirements and specify a relevant user name. Choose OK.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 21
11. Under User for Outbound Communication, choose the user name and Authentication Method as per your
requirements.
Use
For SAP Marketing Cloud to communicate with SAP Cloud for Customer and SAP Cloud Integration, you must
set up several communication arrangements.
Depending on your scenario, you need to activate different communication arrangements in SAP Marketing
Cloud.
Prerequisites
In the SAP Marketing Cloud system, the administrator user has the catalog role ID SAP_CORE_BC_COM.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
22 PUBLIC Configuration
7.1.4.3.1 Communication Arrangement SAP_COM_0017 for
SAP Cloud Integration (SAP Cloud for Customer
Integration)
For more information about the corresponding iFlows, see Overview of Communication Arrangements and
iFlows [page 8].
Procedure
1. Log on to the SAP Fiori Launchpad as an administrator and open the app Communication Arrangements.
2. Click New.
3. Choose the scenario SAP_COM_0017 from the value help.
4. Enter an Arrangement Name.
5. Click Create.
6. Maintain Common Data.
1. Select the communication system you created earlier. For more information, see Communication
System for SAP Cloud Integration (SAP Cloud for Customer Integration) [page 18].
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 23
8. Verify the entries for Inbound Communication. The communication user maintained in the communication
system is entered according to your Communication System.
9. Verify the entries for Outbound Communication. The communication user maintained in the
communication system is entered according to your Communication System.
10. Maintain Outbound Services.
1. Verify that the Service Status is flagged as Active and the Port has the value 443.
2. To export the following objects, enter the paths to the service endpoints of the services you want to
use:
Activity Path
Procedure
1. Log on to the SAP Fiori Launchpad as an administrator and open the app Communication Arrangements.
2. Click New.
3. Choose the scenario SAP_COM_0045 from the value help.
4. Enter an Arrangement Name.
5. Click Create.
6. Maintain Common Data.
1. Enter the communication system that you created earlier. For more information, see Communication
system for SAP Cloud for Customer (UI Navigation) [page 19].
7. The outbound communication can be left out.
8. Maintain outbound services.
1. Verify that the Service Status is flagged as Active, the Port is filled with vaule 443 and the Path is filled
with /.
9. Choose Save .
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
24 PUBLIC Configuration
7.1.4.3.3 Communication Arrangement for SAP_COM_0539
The communication arrangement SAP_COM_0539 (Key Mapping Hub Integration) allows to create mappings
between object instances by connecting their object IDs. This enables the identification of objects from SAP
Marketing Cloud and SAP Cloud for Customer during data replication.
For more information about the corresponding iFlows, see Overview of Communication Arrangements and
iFlows [page 8].
The Communication Arrangement defined in SAP Marketing Cloud systems enables key users to create and
edit communication arrangements that your company has set up with a communication partner.
Note
When setting up the communication arrangement, please make sure your user has authorization for both
SAP_COM_0539 and SAP_COM_0475.
If the user does not have both authorization for SAP_COM_0539 and SAP_COM_0475, the key mapping
import will not work.
Procedure
1. Log on to the SAP Fiori Launchpad as an administrator and open the app Communication Arrangements.
2. Click New.
3. Choose the scenario SAP_COM_0539 from the value help.
4. Enter an Arrangement Name.
5. Click Create.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 25
6. Enter the communication system that you created earlier. For more information, see, Communication
System for SAP Cloud Integration (SAP Cloud for Customer Integration) [page 18].
7. Under Inbound Communication, choose a User.
8. Under Outbound Communication, choose a User.
Note
9. Choose Save.
The communication arrangement SAP_COM_0475 (Marketing - Business Partner Integration) allows the
replication of core business partner and complex business partner relations from SAP Cloud for Customer
to SAP Marketing Cloud.
For more information about the corresponding iFlows, see Overview of Communication Arrangements and
iFlows [page 8].
Note
When setting up the communication arrangement, please make sure your user has authorization for both
SAP_COM_539 and SAP_COM_475.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
26 PUBLIC Configuration
If the user does not have both authorization for SAP_COM_539 and SAP_COM_475, the key mapping
import will not work.
1. Log on to the SAP Fiori Launchpad as an administrator and open the app Communication Arrangements.
2. Click New.
3. Choose the scenario SAP_COM_0475 from the value help.
4. Enter an Arrangement Name.
5. Click Create.
6. Enter the communication system that you created earlier. For more information, see, Communication
System for SAP Cloud Integration (SAP Cloud for Customer Integration) [page 18].
7. Under Additional Properties, set the Property Value X for Integration with C4C enabled.
8. Under Outbound Services, overwrite the Path for Business Partner - Send Confirmation from SAP S/4HANA
Cloud to Client with /cxf/yMKT/C4C/BusinessPartnerSUITEBulkReplicateConfirmation_Out.
9. Under Outbound Services, overwrite the Path for BP Relationship -
Send Confirmation from SAP S/4HANA Cloud to Client with /cxf/yMKT/C4C/
BusinessPartnerRelationshipSUITEBulkReplicateConfirmation_Out.
10. Choose Save.
The communication arrangement SAP_COM_0003 (Marketing - Master Data Integration) allows the replication
of permission data from SAP Cloud for Customer to SAP Marketing Cloud (initial load only!).
For more information about the corresponding iFlows, see Overview of Communication Arrangements and
iFlows [page 8].
1. Log on to the SAP Fiori Launchpad as an administrator and open the app Communication Arrangements.
2. Click New.
3. Choose the scenario SAP_COM_0003 from the value help.
4. Enter an Arrangement Name.
5. Click Create.
6. Enter the communication system that you created earlier. For more information, see Communication
System for SAP Cloud Integration (SAP Cloud for Customer Integration) [page 18].
7. Choose Save.
Note
This activity is just needed if you are using the SOAP-based integration scenarios for Business Partner and
Business Partner Relationship replication.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 27
Log on as SAP Business Configuration Expert in you SAP Marketing Cloud System.
Open the application ‘Manage your Solution’, select ‘Configure your Solution’ and open Item Name ‘Contacts
and profiles’ with step ‘OriginContactID-configure’.
For this integration scenario it is necessary that the Source Business System of the Business Partner and the
Object ID Type are maintained for the Origin ID of the Interaction Contact. Please ensure that for the following
Interaction Origin IDs the Business System and the Object type are maintained as mentioned below:
SAP_C4C_BUPA SAP C4C - Business Enter the system ID Enter the system ID 888
Partner of the SAP Cloud for of the SAP Cloud for
Customer quality sys- Customer productive
tem system
Note
Please make sure, that you maintain these settings both for your productive tenant and your quality tenant.
Note
This step only applies if you set up the replication of campaigns from SAP Marketing Cloud to SAP
Cloud for Customer in the Communication Arrangement SAP_COM_0017. For more information, see
Communication Arrangement SAP_COM_0017 for SAP Cloud Integration (SAP Cloud for Customer
Integration) [page 23].
Overview
To strengthen B2B-specific collaboration between Marketing and Sales, the sales representative needs to know
about campaigns for which the assigned contacts are part of the target group assigned to this campaign.
The sales representative can display marketing campaigns in SAP Cloud for Customer, which are created and
executed in SAP Marketing Cloud.
To reach this goal, basic campaign information is sent from SAP Marketing Cloud to SAP Cloud for Customer in
order to create a proxy campaign.
The default implementation of the Business Add-In (BAdI) CUAN_LM_CAMPAIGN_REPLICATION checks if the
campaigns shall be replicated and follows the logic below.
If the campaign is a Blank Campaign, Email Campaign, or a Mobile Campaign, and its life cycle status is
either released or stopped, the campaign will be replicated to SAP Cloud for Customer. In all other cases, the
campaign is not replicated to the SAP Cloud for Customer system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
28 PUBLIC Configuration
Procedure
If you want to enhance or change this behavior follow the steps below:
Note
This step only applies if more than one sales system is connected toSAP Marketing Cloud.
Overview
You can connect multiple sales systems to your SAP Marketing Cloud system. These systems can be an
external sales system, a SAP Cloud for Customer (SAP_C4C) system and a SAP Customer Relationship
Management (SAP_CRM) system. In such set-up, a Business Add-In (BAdI) is used to determine to which
sales system the marketing data has to be transferred.
Example
This Business Add-In (BAdI) checks the contact for which the leads and activities are to be created and follows
the logic below.
If a facet with origin SAP_CRM_BUPA exists, but no facet with origin SAP_C4C_BUPA, the marketing data will
be send to the SAP Customer Relationship Management System. In all other cases, the marketing data will be
sent to the SAP Cloud for Customer system.
Procedure
If you want to enhance or change this behavior, please follow these steps:
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 29
4. In the pop-up New Enhancement Implementation, use the value help of field Business Context and choose
Marketing: Campaign
5. In field Enhancement Option, use the value help and choose Lead Management: Determine Target System
Type
6. In field Name, enter a name for your enhancement, Click on Create
7. Select the tab Description and choose the link View Details to get a detailed description of this
enhancement option, its parameters, its fallback implementation and its example implementation
Note
To know more about SAP CRM Integration with SAP Marketing Cloud, check Setting Up SAP CRM
Integration with SAP Marketing Cloud (1NP).
The SAP Application Interface Framework enables you to monitor the inbound and outbound messages in the
SAP Marketing Cloud system. First, you need to assign recipients to the namespace and then users to the
recipients.
Prerequisites
You must create a business role by using the template SAP_BR_CONF_EXPERT_BUS_NET_INT, and assign
the role to the administrator in the SAP S/4HANA system. To enable forward navigation to the Campaigns
and Interactions apps from lead transfer messages, you must also assign the SAP_BR_MARKETING_EXPERT
authorization to the role.
Procedure
Assign Recipients
The AIF Message Monitoring app enables you to configure recipients.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
30 PUBLIC Configuration
3. Select the user who is responsible for message monitoring from the Users assigned to recipients panel and
perform the following steps:
1. Select the following:
• Namespace /MDMKM and Recipient Name MDM_KEY_MAPPING.
• Namespace /CMDBP and Recipient Name CMD_BP.
• Namespace CUAN and Recipient Name ALL_INTERFACES.
• Namespace /MKTLT and Recipient Name LEADTR_OUT.
• Namespace /MKTLT and Recipient Name CPGREP_OUT.
• Namespace /MKTLT and Recipient Name LTACT_OUT.
2. Click Assign.
Monitor Messages
This procedure describes how to monitor the inbound and outbound messages in the SAP S/4HANA system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 31
3. The Interface Monitor launches.
4. Use the Calendar Monitor to select the date range to view the triggered messages and choose Search.
5. In the Result List, you can view the messages and check for the log details.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
32 PUBLIC Configuration
7.2 Configuration in SAP Cloud for Customer (C4C)
7.2.1 Scoping
7.2.1.1 First Log in with Initial User
Procedure
1. Access the tenant URL for SAP Cloud for Customer that you received from SAP in the provisioning email.
2. Enter your initial user and password.
3. Select your logon language, by default it is English.
4. Choose Log On and change the password in the dialog box.
5. Choose OK.
6. Choose Yes.
Procedure
2. Select the title First Implementation project, choose Open Activity List
3. On the Prepare tab, choose Define Administrators for Project Team
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 33
4. Choose Create Service Agents and maintain the following values:
Field Value
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
34 PUBLIC Configuration
9. Go to below work center and choose Go.
Example
PROJECTADMIN7000000
11. Go to Edit Attributes , maintain the following values.
Field Value
Password Password
12. Choose Edit Access Rights from bottom right corner. Choose Yes to save the attributes change.
13. In the EDIT ACCESS RIGHTS screen, select tab WORK CENTER AND VIEW ASSIGNMENT and make below
assignment by selecting the checkbox.
SEODADMINWCF Administrator
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 35
Work Center/ View ID Work Center / View Name
CODACCOUNTWC Customers
CODPARTNERWC Partners
CODPEOPLE People
COD_PRODUCTDATA Products
15. Choose Sign Out on the top right corner and choose Yes.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
36 PUBLIC Configuration
7.2.1.3 Scoping with Admin User
Procedure
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 37
6. Add US to the Selected Countries and choose OK.
7. Choose Next.
8. In the Implementation Focus step, The Implementation Focus, SAP Cloud for Customer is Selected. Choose
Next
9. In the Scoping step, maintain the following values and choose Next:
Communication and Information Ex- Integration with External Applications Integration of Master Data
change and Solutions
Communication and Information Ex- Integration with External Applications Integration into Sales, Service, and
change and Solutions Marketing Process
Communication and Information Ex- Integration with External Applications Integration with SAP Marketing
change and Solutions
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
38 PUBLIC Configuration
Scoping Element L1 Scoping Element L2 Scoping Element L3
Activity Management
Products
Note
Scoping depends on the business needs. Some of the elements are selected automatically due to
business logic. This is needed for Communication and Information Exchange.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 39
Scoping Element Business Option
Integration of Master Data Do you want to replicate business partner from your cloud
solution to an external application or solution?
Integration into Sales, Service, and Marketing Processes Do you want to replicate activities from your cloud solu-
tion to an external application?
Integration with SAP Marketing Do you want to replicate business attributes to SAP Mar-
keting?
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
40 PUBLIC Configuration
17. On the Confirmation step, choose Close.
Procedure
Caution
System may take 30 minutes to complete this task in the background. Wait until the Confirm Milestone
status will change to Confirmed with updated values for Confirmed On and Confirmed By.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 41
7.2.1.5 Lock Initial User with the Newly Created
Administrator
Procedure
Field Value
Password Password
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
42 PUBLIC Configuration
7.2.2 Fine Tuning
Procedure
6. Choose OK.
7. Choose the tab Work Center and View Assignments
.
8. Select below assignment.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 43
Tab Work Center/ View ID Work Center/ View Name
Field Value
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
44 PUBLIC Configuration
6. Under section Users, choose Business Users.
7. Select the User ID of the employee you have just created, for example, MARKETINGSALESREP.
8. On the next screen, choose Edit Attributes from the bottom right corner and enter the following
values:
Field Value
User ID SALES_REP_MARKETING
9. Choose Edit Access Rights. Then choose Yes to save your changes.
10. Assign the role to the user:
SALES_REP_MARKETING Checked
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 45
3. Choose Communication Systems in the Integration division
System Instance ID My System ID of Marketing Cloud sys- Refer chapter How to get SAP Market-
tem ing Cloud System ID [page 85] to
get My system ID of Marketing Cloud
system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
46 PUBLIC Configuration
Field Value Comment
5. Maintain the person responsible for system maintenance in the Technical Contact section.
6. Save and then choose Actions Set to Active .
7. Choose Close.
Communication scenarios mentioned in the table below are relevant for your project scope, create them one
after the other. The communication scenarios that are not mentioned in the below table/ chapters can be
disabled.
Procedure
Business Activity Replication from • Business Activity Replication to • Confirm Business Activity Replica-
SAP Business Suite SAP BusinessReplicate Business tion to SAP Business Suite - Select
Activity from SAP Business Suite -
Select
• Replicate Business Activity Attach-
ment from SAP Business Suite -
Unselect
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 47
Communication Scenarios Communication Services Inbound Communication Services Outbound
Business Partner Replication to SAP • Confirm Business Partner Replica- • Replicate Business Partner to SAP
Business Suite tion from SAP Business Suite - Business Suite - Select
Select
• Replicate Business Partner Rela-
• Confirm Business Partner Rela-
tionship to SAP Business Suite -
tionship Replication from SAP
Select
Business Suite - Select
• Replicate Business Partner Attach-
ments to SAP Business Suite -
Unselect
Lead Replication from SAP Business • Replicate Lead with Business Part- • Confirm Lead Replication to SAP
Suite ner Address Information from SAP Business Suite - Select
Business Suite - Select
• Notify Lead Status Change to the
• Replicate Lead Attachment from SAP Business Suite - Unselect
SAP Business Suite - Unselect
Lead Replication to SAP Business • Confirm Lead Replication from • Replicate Lead Attachment to SAP
Suite SAP Business Suite - Unselect Business Suite - Unselect
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
48 PUBLIC Configuration
Communication Scenarios Communication Services Inbound Communication Services Outbound
Opportunity Replication to SAP Busi- • Confirm Opportunity Replication • Replicate Opportunity to SAP Busi-
ness Suite from SAP Business Suite - ness Suite - Select
Unselect
• Replicate Opportunity Attachment
to SAP Business Suite - Unselect
Note
In case you do not see any of the configuration scenarios, recheck the project scoping to add the necessary
scoping elements.
8. Choose Next
9. Choose the Application Protocol as Web Service and Authentication method as SSL Client Certificate
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 49
Note
Basic authentication with user name and password is also possible, but not recommended in a
productive environment for security reasons.
Note
This certificate has to be uploaded while configuring SAP Cloud for Customer to SAP Cloud Integration
inbound iFlow.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
50 PUBLIC Configuration
Note
Example for PATH field: Log in to SAP Cloud Integration Web UI and go to corresponding SAP Cloud
Integration iFlow for your package content. On Configure tab copy the Address path. Add prefix /cxf
and suffix?sap-client= (Client number) to the copied path.
Ex: /cxf/C4C/yMKT/ActivityReplicationConfirmation?sap-client=XXX
It is possible to send business partner with status “In Preparation” to SAP Marketing Cloud. The use case is as
following: You create Leads in SAP Cloud for Customers without existing accounts and contact persons. With
the active filter for sending business partner in preparation status, not just the lead object gets replicated also
the two business partners: account and contact person get send to SAP Marketing Cloud.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 51
Procedure
5. Add Row for the Filters and select Send Business Partners with In Preparation status.
Procedure
Note
If you do not find the activity, choose the All Activities filter, search for Leads, mark the corresponding
line and select Add to Project.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
52 PUBLIC Configuration
7. Once added to the project, choose Activities.
8. Choose the task for which the determination has to be maintained.
For example: Involved Parties for Appointments
9. Choose Employee Responsible in the resulting screen and Choose Maintain Determinations.
10. In the resulting screen, activate the Employee Responsible determination by assigning Employee
responsible of Account Team and choose OK.
11. Choose Save and Close.
Purpose
Marketing Attributes assigned to contacts and individual accounts are now transferred from SAP Cloud for
Customer to SAP Marketing Cloud. Marketing Attributes and Attribute Set need to be available in SAP Cloud
for Customer before it is assigned to the contacts or individual accounts.
Procedure
1. Log onto the SAP Cloud for Customer system and navigate to the Administrator workcenter and choose
Sales and Campaign Settings workcenter view.
2. Under the Sales Campaign settings, choose Maintain Attributes
3. Under Attributes page, select New and add details for New Attribute.
4. Enter Details as Example below table
ID Example: HD_PRODUCT_KNOWLEDGE
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 53
Description Example: Product Knowledge
ID Example: HD_EMPLOYEE_SINCE
9. Under the sales Campaign Settings, choose Maintain Attribute Sets Select New to create a new attribute
set. Maintain the details as per example Below
ID Example: HD_CONTACT_BASIC
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
54 PUBLIC Configuration
7.2.10 Code List Mapping
Use
The codes used in SAP Marketing Cloud and SAP Cloud for Customer are not always the same. They must,
therefore, be mapped inSAP Cloud for Customer using the Code List Mapping Tool.
Procedure
Note
If you are unable to find the Upload Code List, add the following work centers and views to your user.
Note
If you want to add work centers and views, you need to go to Administrator Business Users . Then
select your user ID and go to Edit Access Rights. In the Edit Access Rights screen, select Work Center
and View Assignment and assign by selecting the checkbox.
Check the status of Code List Mapping upload in the Application Log
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 55
1. In the Business Configuration work center, choose the Implementation Projects view.
2. Choose the project and select Open Activity List.
3. Choose Fine-Tune and search for the activity Code List Mapping for Integration with External Applications
and Solutions and select it.
4. Choose Maintain Code List Mapping.
Note
The code list mapping UI contains the following three tables, which are hierarchical:
1. Local data type: This shows the data types available in the SAP Cloud for Customer system relevant for
Code List Mapping. Select the data type for which you want to view the Code List Mapping.
2. Code list mapping rule: Here we set the code list mapping rules for the data type selected in the table
above. There are two possible rules
Local and Remote codes are equal: This rule is used when the values in the SAP Cloud for Customer
system and the ones in the SAP Marketing Cloud system are the same. If this rule is selected, there is
no need to do any mapping for the code values.
Map Individual values: This rule is used when the codes in the SAP Cloud for Customer system and the
ones in the SAP Marketing Cloud system are different. If this rule is selected, the individual code values
must be mapped.
3. Code List mapping: Map each code value (only those required) for the local data type in the SAP Cloud
for Customer system with the corresponding values in the SAP Marketing Cloud system.
Purpose
You can manage marketing permissions and subscriptions in the SAP Marketing Cloud system using this URL
Mash-up. The SAP Marketing Cloud system can be accessed from the SAP Cloud for Customer system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
56 PUBLIC Configuration
Procedure
URL Provide a URL as per the integrated Fill any dummy value in the URL for
SAP Marketing Cloud system. InteractionContactID in the URL
https://
<server>:<port>/sap/bc/
ui5_ui5/ui2/ushell/shells/
abap/
FioriLaunchpad.html#Marketing
Contact-displayFactSheet?
InteractionContactID=<ID>&Ori
ginID=<OriginID>
Example
https://xxx-
yyy.wdf.sap.corp/sap/bc/
ui5_ui5/ui2/ushell/shells/abap/
FioriLaunchpad.html#Marketing-
Contact-displayFactSheet?Inter-
actionContactID=1006696&Ori-
ginID=SAP_C4C_BUPA
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 57
7. Choose Activate and Save the Mashup.
Note
8. To add the URL Mashup to the Customer Marketing Permission screens, navigate to Customers
Contacts .
9. Open any contact from the list and navigate to the Marketing Permissions tab.
10. Click your profile on the top right corner of your screen, and select Start Adaptation.
11. Click the blue Edit icon for the General section. The system highlights the area with a red border to indicate
that changes can be made. In the right adaptation pane for General view, drill down from Pane Form
Pane Section .
12. Check Personalize and Set as Visible are selected and Hide is unselected.
13. Click Add Mashup to open a new window.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
58 PUBLIC Configuration
14. Mashup window opens up with the list of mashups. Choose the mashup that was created in the earlier
steps.
15. The URL Mashup link appears in the General section. Check the Set as Visible flag for this new field is
selected.
16. To save your settings, click your profile and select End Adaptation. The URL is added successfully in the
screen.
Related Information
Integrate with SAP Marketing for Sales Campaign > Configure Mashup for Editing SAP Marketing Permissions
Note
SAP provides prepackaged, generic integration content called integration flows (iFlows) for the integration
of SAP Marketing Cloud with SAP Cloud for Customer.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 59
The name of the integration package in SAP Cloud Integration is SAP Cloud for Customer Integration
with SAP Marketing.
Prerequisites
To be able to import and deploy iFlows, you need the AuthGroup.IntegrationDeveloper role assigned in your
tenant. For more information, see Persona.
Note
Due to security reasons, user/ password based authentication is not recommended. In the case of
certificate based authentication for the SAP Marketing Cloud system, this section can be skipped.
In Create Technical Communication User [page 16] a technical user in your SAP Marketing Cloud system was
created. These user credentials need to be stored in your SAP Cloud Integration tenant as User Credential.
Procedure
Description optional
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
60 PUBLIC Configuration
Field Name Entry Value
Enter the user name created in Create Technical Communication User [page
16].
Description Optional
Example
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 61
7.3.3 Configure and Deploy iFlows from SAP Cloud for
Customer to SAP Marketing Cloud
Procedure
iFlows to Configure
Replicate Business Partner to SAP Marketing via Business Partner Replication to SAP Marketing
Business Partner Web Services
Note
The iFlow supports the End of Purpose for
business partners. Whenever a business part-
ner is blocked in SAP Cloud for Customer, the
iFLow transfers this information to the corre-
sponding interaction contact in SAP Marketing
Cloud.
Value Mapping for SAP Cloud for Customer and Replicate Key Mapping to SAP Marketing
SAP Marketing Integration
Replicate Business Partner Relationship to SAP Business Partner Relationship Replication to SAP Marketing
Marketing via Business Partner Web Services
Confirm Business Activity Replication to SAP Business Activity Replication to SAP Marketing
Marketing
Confirm Lead Replication to SAP Marketing V2 Lead Replication from SAP Marketing
Interface
Replicate Business Activity to SAP Marketing Business Activity Replication to SAP Marketing
Replicate Business Attribute Assignment to SAP Business Attribute and Assignment Replication with SAP Market-
Marketing ing
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
62 PUBLIC Configuration
Name of the iFlow Description of the iFlow
Replicate Business Attribute Set to SAP Market- Business Attribute and Assignment Replication with SAP Market-
ing ing
Replicate Marketing Permission to SAP Market- Marketing Permission Replication to SAP Marketing
ing (Deprecated as of 2102)
Request Campaign Interactions from SAP Mar- Request Campaign Interactions from SAP Marketing
keting
Request Marketing Permissions and Subscrip- Request Marketing Permissions and Subscriptions from SAP
tions from SAP Marketing Marketing
Note
Sender: C4C
For Client Certificate Authentication Choose Select and select the C4C certificate. For more
information about how to download the certificate, see
Configure Communication Arrangements [page 47].
6. Provide the relevant details on the Receiver tab page for receiver SAP Marketing:
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 63
Field Name Entry Value
8. Choose Save.
9. In the Actions column for the relevant artifact, choose Deploy.
Note
Ensure that the iFlows are in state - Started and the correct endpoint URLs are configured. To see the status
of the deployed artefacts, navigate to Monitor → Manage Integration Content→ All started.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
64 PUBLIC Configuration
7.3.4 Configure and Deploy the iFlows from SAP Marketing
Cloud to SAP Cloud for Customer
iFlows to Configure
Replicate Business Activity from SAP Marketing Business Activity Replication from SAP Marketing
Replicate Campaign from SAP Marketing Campaign Replication from SAP Marketing
Replicate Lead with Business Partner Address In- Lead Replication from SAP Marketing
formation from SAP Marketing
4. For the iFlows, provide the relevant details on the Sender tab page:
Note
Sender: yMKT
For Client Certificate Authentication Choose Select and select the SAP Marketing Cloud certifi-
cate. For more information about downloading the client
certificate, see How to get SAP Marketing Cloud Client
Certificate [page 84].
5. Provide the relevant details on the Receiver tab page for receiver SAP Cloud for Customer:
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 65
Field Name Entry Value
Receiver C4C
Address https://<s4_yMkt_host>:<s4_yMkt_port>
Host *.crm.ondemand.com
Port 443
Principal Propagation
7. Choose Save.
8. In the Actions column for the relevant artifact, choose Deploy.
Note
Ensure that the iFlows are in state - Started and the correct endpoint URLs are configured. To see the status
of the deployed artefacts, navigate to Monitor → Manage Integration Content→ All started.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
66 PUBLIC Configuration
7.3.5 Maintain Value Mapping
Use
The value mappings listed in the table below are delivered as part of the pre-packaged SAP Cloud Integration
content.
Note
The value mapping can only be deployed once per SAP Cloud Integration tenant. When several SAP Cloud
for Customer integration packages are required, maintain the values in the value mapping in one of the
integration packages for all systems and deploy this value mapping.
Procedure
The following procedure explains how to do value mapping in SAP Cloud Integration Web UI.
1. Access the Web UI URL from the provisioning e-mail. It should be in the format: https://
<cpitenant>.hana.ondemand.com/itspaces.
2. In the Design tab, choose Artifacts.
3. Navigate to the package, and choose the Actions icon in Value Mapping .
4. Select the Configure option.
5. Maintain the value based on the requirement. For more information see Mandatory Mappings [page 68]
and Optional Mappings [page 72].
6. Then choose Deploy.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 67
7.3.5.1 Mandatory Mappings
Mapping between SAP Marketing Cloud System and SAP Cloud for Customer System
This is the SAP Marketing Cloud tenant ID that you noted See section How to get SAP Cloud for Customer System ID
down. [page 85]. This is the short tenant ID of the SAP Cloud for
Customer system.
Tip
In order to get the system tenant ID, go to
Communication Systems app and the ID associated with
the system name Own System is the ID that you need.
Mapping between SAP Marketing Cloud Logical System and SAP Cloud for Customer
Communication Language
This is the SAP Marketing Cloud tenant ID that you noted This is the communication language used in SAP Cloud for
down. Customer. Whatever language is given in this Value Map-
ping also needs to be added in the fine-tuning for Commu-
Tip nication Language for Data Replication. By default, it is set
to EN.
In order to get the system tenant ID, go to
Communication Systems app and the ID associated with
the system name Own System is the ID that you need.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
68 PUBLIC Configuration
Mapping of Business Partner Roles between SAP Marketing Cloud and SAP Cloud for
Customer
This is the SAP Marketing Cloud business partner role. This is the business partner role code which is used in
SAP Cloud for Customer, e.g. BUP001 - Contact Person,
Expand the following table for a complete list of available
CRM000 - Customer.
business partner roles in SAP Marketing Cloud.
If an interaction contact has This mapping is just used for the Business Partner integra-
this role, they will be flagged tion via SOA-web services (Replicate Business Partner to
BUP002 Prospect
BUP003 Employee
FLCU01 Customer
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 69
CUAN, MapBusinessPartnerRole COD, BusinessPartnerRoleCode
ROLE Description
FLVN01 Supplier
Tip
In order to get the role codes, open your SAP
Marketing Cloud system as an configuration expert, go to
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
70 PUBLIC Configuration
CUAN, MapBusinessPartnerRelationship COD, BusinessPartnerRelationshipCategoryCode
This is the SAP Marketing Cloud relationship category role. This is the business partner relationship code which is used
in SAP Cloud for Customer, e.g. BUR001 - Contact Person
Note Rel.ship, BUR002 – Act. Partner Relationship
Expand the following table for a complete list of available This mapping is just used for the Business Partner Relation-
relationship category roles. ship integration via SOA-web services (Replicate Business
Partner Relationship to SAP Marketing via Business Partner
Available Business Partner Relationship Categories in SAP Web Services).
Marketing Cloud
RELTYP Description
CRMH07 Wholesaler
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 71
CUAN, MapBusinessPartnerRelationship COD, BusinessPartnerRelationshipCategoryCode
RELTYP Description
CRMS01 Carrier
Note
Please note that the configuration of codes for business partner functions, departments and industries
also needs to be in sync with the codes defined in your Sales Cloud system. To configure functions,
departments and industries for business partners, use the Manage Your Solution app. Therefore, log on
as SAP Business Configuration Expert to your SAP Marketing Cloud system, go to Configure Your Solution
and choose application area Database and data management with sub-application area Business Partner,
respectively Contact Person. Now select the configuration steps Define Departments for Contact Person,
Define functions for Contact Person and Define Industries.
For more information about configuring functions and departments for interaction contacts in Marketing,
see Settings for Functions, Departments, and Industries.
The optional mappings are only relevant for special usage cases. For example, where data from an SAP CRM or
SAP ERP system is imported intoSAP Marketing Cloud.
Mapping between SAP Cloud for Customer Business System and SAP Marketing Cloud System ID
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
72 PUBLIC Configuration
COD, BusinessSystemID CUAN, SystemID
This is the short tenant ID of the SAP Cloud for Customer This is a system ID that is used as a namespace inside of
system. the SAP Marketing Cloud System, especially for ID originat-
ing from external systems.
Mapping between SAP Marketing Cloud CallLeadGroupCode and SAP Cloud for Customer
CallLeadGroupCode
For SAP Marketing Cloud, this must be set to the constant You can map any value that has been defined in SAP Cloud
CALL_QUALIFICATION. for Customer configuration for lead categories.
For SAP Marketing Cloud, this must be set to the constant You can map any value that has been defined in SAP Cloud
CALL_QUALIFICATION. for Customer configuration for lead sources.
Mapping between SAP Marketing Cloud AttributeValueDescLanguageCode and SAP Cloud for Customer
AttributeValueDescLanguageCode
CUAN-AttributeValueDescLanguageCode COD-AttributeValueDescLanguageCode
For SAP Marketing Cloud, this must be set to the constant In SAP Cloud for Customer, you can maintain the desired
LanguageCode. language for this field.
Note
It offers the possibility to maintain one language code to map descriptions for marketing attribute
assignment values. The logic is as follows:
2. If a value is maintained and a description exists in the corresponding language, the description is
mapped.
3. If a value is maintained and no description exists in the corresponding language, the value is mapped.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 73
Mapping between SAP Marketing Cloud Category Code and SAP Cloud for Customer
ActivityGroupCode
There is a fixed value mapping for the delivered configuration. You can change or enhance this value mapping
as follows:
These are the values in yMkt: You can map values that have been defined in SAP Cloud for
Type Category Text Customer configuration for activity categories.
01 05 Preparation The categories you are using should be assigned to the ac-
tivity types under Assignment of categories.
01 09 Marketing
02 01 Customer Visit
02 06 Meeting
02 07 Workshop
02 08 Product Presenta-
tion
02 09 Marketing
02 10 Annual Visit
03 02 Telephone Call
03 09 Marketing
03 12 Sales Call
01 Activity Task
02 Appointment
03 Phone Call
04 Visit
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
74 PUBLIC Configuration
7.4.1 Overview
After your system setup is completed, you can execute the initial data load of from your SAP Cloud for
Customer system to SAP Marketing Cloud system.
Procedure
Business System ID SAP Cloud for Customer Logical Sys- <Logical system name of
tem the Cloud for Customer>
Category 1-Person
Test run No
5. Choose Execute.
Note
The same steps can be followed to replicate Leads and Opportunities to SAP Marketing Cloud system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 75
7.4.3 Initial Load of Business Partner Relationship to SAP
Marketing Cloud
Procedure
Business System ID SAP Cloud for Customer Logical Sys- <Logical system name of
tem the Cloud for Customer>
Test run No
5. Choose Execute.
Prerequisites
Before you can start with the business attribute assigment, please make sure that you have transferred the
following master data:
• Accounts
• Contacts
• Relationships
• Marketing Attributes
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
76 PUBLIC Configuration
Procedure
Business System ID SAP Cloud for Customer Logical Sys- Replicate Business
tem Attribute Assignment
to<Logical system name of
the Cloud for Customer>
Test run No
5. Choose Execute.
Replicate service tickets from SAP Service Cloud to SAP Marketing Cloud.
The replication of service tickets helps you to understand a customers' business needs better. You can use this
information to alter campaigns, hand out awards or compensation and thereby improve customer satisfaction.
The service ticket is replicated to SAP Marketing Cloud as an interaction record. You can see this information in
SAP Marketing Cloud in the app Data Stewardship Browse Interaction Data .
Alternatively, you can go to Data Stewardship Corporate Accounts open an account and see Interactions.
The mapping of fields between the two systems is as follows:
Mapping of Service Ticket Attributes from SAP Service Cloud to Properties of OData Service
CUAN_BUSINESS_DOCUMENT_IMP_SRV of SAP Marketing Cloud
CUAN_BUSINESS_DOCUMENT_IMP_SRV
Service Ticket Attribute in SAP Service Cloud Property in SAP Marketing Cloud
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 77
CUAN_BUSINESS_DOCUMENT_IMP_SRV
Service Ticket Attribute in SAP Service Cloud Property in SAP Marketing Cloud
Ticket ID External ID
The Internal Object Type is not mapped to an attrib- Internal Object Type
ute in SAP Service Cloud. It has the hard-coded value
SERVICE_TICKET. In the integration scenario SAP Cloud
for Customer Integration with SAP Marketing Cloud, this
value can be adapted in the corresponding iFlow Replicate
Service Ticket to SAP Marketing.
The External Object Type is not mapped to an attrib- External Object Type
ute in SAP Service Cloud. It has the hard-coded value
C4S_SERVICE_TICKET.
A service ticket is replicated when it’s created in SAP Service Cloud and any subsequent updates are also
transferred to SAP Marketing Cloud.
Technical Information
The existing campaign outbound interface in SAP Service Cloud is extended with additional fields for this
integration. Also, a new PI mapping and Cloud Integration iFlow are available.
Prerequisite: Service Categories from SAP Service Cloud must be manually uploaded to SAP Marketing Cloud
before replication.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
78 PUBLIC Configuration
Scoping Entries
In SAP Service Cloud, navigate to Communication and Information Exchange Integration with External
Applications and Solutions Integration into Sales, Service, and Marketing Processes Service Tickets .
Do you want to replicate service ticket from your cloud solution to an external application?
You can setup the communication scenario under Administrator General Settings Integration
Communication Arrangements . The following Communication Scenarios are supported for this Integration:
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 79
8 Status Mapping of Data of SAP Cloud
for Customer to Data of SAP Marketing
Cloud
The following table provides you with a overview about status mappings: Correlated object statuses in SAP
Cloud for Customer, and SAP Marketing Cloud.
5 (Declined) 07 (Unsuccessful)
6 (Converted) 05 (Converted)
3 (Stopped) 07 (Unsuccessful)
4 (Won) 06 (Successful)
5 (Lost) 07 (Unsuccessful)
3 (Completed) 03 (Completed)
4 (Cancelled) 04 (Cancelled)
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
80 PUBLIC Status Mapping of Data of SAP Cloud for Customer to Data of SAP Marketing Cloud
9 Extensibility for SAP Business Partner
Integration
Features
As a key user, you have several options to extend the SAP Business Partner Integration. You can enable
scenario-based extensibility, useSAP Cloud Integration with extension points in iFlows, or use BAdIs that allow
complex mapping.
Use the 2 iflows with extension points to extend your business partner integration.
• Replicate Business Partner to SAP Marketing via Business Partner Web Services
• Replicate Business Partner Relationship to SAP Marketing via Business Partner Web Services
• Value Mapping for SAP Cloud for Customer and SAP Marketing Integration
For more information, see Configure and Deploy iFlows from SAP Cloud for Customer to SAP Marketing Cloud
[page 62].
For more information regarding extending standard iflows, check out the following blog in SAP Community:
Extending standard integration flow to support Customer extensions
As a key user, you can extend the integration in the Custom Fields app using the business context Business
Partner Core View
Once the custom field has been created, you can edit it. Select the tab Busness Scenarios where you will
find both the Business Partner and the Interaction Contact. Click on Enable Usage. As a result, the field will
automatically be created with the same name in both the SAP S/4HANA and SAP Marketing Cloud systems.
Note
If you want to use custom fields of the interaction contact in the lead transfer process from SAP Marketing
Cloud to SAP Sales Cloud, you cannot use the scenario based extensibility. In this case, you can use the
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Extensibility for SAP Business Partner Integration PUBLIC 81
classic approach with two separate custom fields, one for the business partner and one for the interaction
contact. The values of these two custom fields you need to map, using a BAdI.
As a key user, you can extend the integration in the Custom Logic app using the business context Marketing:
Business Partner Mapping. The following BAdIs are provided.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
82 PUBLIC Extensibility for SAP Business Partner Integration
10 Appendix
Purpose:
If you face an error - Please enter a party role with sales unit, while trying to create an opportunity or convert
Lead to opportunity, maintain the sales org data in your system.
Procedure:
6. Choose Save.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Appendix PUBLIC 83
10.2 Finding Required Information
In the section Inbound Services you can see the service URL..
The service URL consists of three parts, namely protocol, host name and service path. The host name follows
the pattern tenant.api.domain.
Procedure
You can download the SAP Marketing Cloud client certificate from the communication system you created in
section.Define Communication Systems [page 17].
Alternatively, you can also choose Security, Maintain Client Certificates, and then select the certificate and click
Download.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
84 PUBLIC Appendix
10.2.3 How to get SAP Marketing Cloud System ID
Procedure
You can get the logical system ID from the communication arrangement you have created in section
Maintaining Communication Arrangements [page 22].
Alternativly, you can also choose Communication Systems, select the entry where the column Own System is
Yes and that is the system ID.
Procedure
You can get the logical system ID from the communication arrangement
Once the integration flows are deployed, you can get the endpoint of an integration flow as follows:
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Appendix PUBLIC 85
Example
/cxf/yMKT/C4C/LeadReplicationRequest_Out
The SAP Cloud Integration Runtime URL is included in the SAP Cloud Integration provisioning e-mail.
Alternatively, you can get it once the prepackaged iFlows in SAP Cloud for Customer Integration with SAP
S/4HANA Cloud have been deployed. For more information, see Configure and Deploy iFlows from SAP Cloud
for Customer to SAP Marketing Cloud [page 62].
In the SAP Cloud Integration Web UI, navigate to Monitor. Choose the Started app. Open on of the iflows.
Choose the status Started. The first part of the listed endpoint is the required SAP Cloud Integration tenant
runtime URL. Example: https://<tenant>-iflmap.hana.ondemand.com
In the SAP Cloud Integration provisioning email, follow the link under Certificate Information. In the resulting
screen, choose X509 Certificate with option Binary CER. Download it to your local machine.
Optionally, you can download the SAP Cloud Integration certificate from Operations View Keystore , then
choose Select and download certificate sap_cloudintegrationcertificate.
These are the most common statuses for messages and their meaning:
• Error: Error occurred during the message processing but message retry not started automatically.
• Failed: Message processing failed, retry not possible.
• Completed: Message processing completed and the message delivered to the receiver successfully.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
86 PUBLIC Appendix
• Processing: Message is currently being processed.
Procedure:
2. Go to Assign Recipients.
4. Enter a relevant Recipient for the Alerts. Choose All_Interfaces and press Execute
7. Choose the message type the you want the user to see
8. Choose Save
After that procedure, the selected users can log on to the system and can navigate to the Message Dashboard /
SAP AIF to analyze and restart messages and errors.
The users can also choose the timeframe they want to analyze and find the errors.
For monitoring the SOAP messages in SAP Marketing Cloud you could use the Message Dashboard, which is
available with role SAP_BR_CONF_EXPERT_BUS_NET_INT.
The relevant message name space on SAP Marketing Cloud side are: /MDMKM and /SDCFC. If you are using the
SOAP-based integration, the name spaces /CMDBP and /MKTBP are also relevant.
For information about the use of the Message Dashboard, see Message Dashboard.
Note
The following step (Assign Recipients to User) is mandatory to see the messages in the dashboard: Assign
Recipients to Users
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Appendix PUBLIC 87
10.4 Ticket Component
Component Comment
CEC-MKT-INT-ERP Use this component for issues with the SOAP-based busi-
ness partner integration.
LOD-CRM-INT-YMT Use this component for issues with the content on SAP
Cloud Integration and issues that occur in the SAP Cloud
for Customer system, for example if the replication of busi-
ness partner data does not reach the SAP Cloud Integration
tenant or if marketing lead messages are not processed suc-
cessfully in SAP Cloud for Customer system.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
88 PUBLIC Appendix
Important Disclaimers and Legal Information
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using
such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Important Disclaimers and Legal Information PUBLIC 89
www.sap.com/contactsap
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.