Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

loiof8d62f4cb1a6434bb0ff3109c04acb6a

Download as pdf or txt
Download as pdf or txt
You are on page 1of 90

PUBLIC

SAP Marketing Cloud


2024-05-10

Setting Up SAP Marketing Cloud Integration with


SAP Cloud for Customer (1J9)
© 2024 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN


Content

1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3 Replicating Business Partner with SOAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

4 Overview of Communication Arrangements and iFlows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

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

9 Extensibility for SAP Business Partner Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81


9.1 SAP Cloud Integration with Extension Points in iFlows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
9.2 SAP Marketing Cloud Scenario-Based Extensibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
9.3 SAP Marketing Cloud Business Add-Ins (BAdIs) for Business Partner Integration. . . . . . . . . . . . . . . 82

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.

SAP Cloud for Customer Mapped Interaction of SAP Marketing Cloud

Account Interaction contact of type Corporate Account

Individual Customer Interaction contact of type Consumer (B2C)

Contact Interaction contact of type Contact (B2B)

Lead Interaction of type MARKETING_LEAD, including product


and interest information

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

Activity with type Phone Call Interaction of type

• TELEPHONE_OUTBOUND
• TELEPHONE_INBOUND
• TELEPHONE_UNSUCCESSFL

Activity with type Appointment APPOINTMENT

Activity with type Visit APPOINTMENT

Activity with type Task TASK

Attribute Set with Marketing Attributes Marketing Attribute Category

 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

2022-07-27 Initial version for SAP Marketing Cloud 2208

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

Connections between Systems


Communication Arrange-
Communication Arrange- iFlows SAP Cloud ment SAP Cloud for Cus-
ment SAP Marketing Cloud Scenario Integration tomer

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

Activity MKT to C4C Replicate Business Activity Business Activity Replication


from SAP Business Suite
from SAP Marketing

Confirm Business Activity


Replication to SAP Marketing

Activity C4C to MKT Replicate Business Activity to Business Activity Replication


SAP Marketing to SAP Business Suite

Lead from MKT to C4C Replicate Lead with Business Lead Replication from SAP
Business Suite
Partner Address Information
from SAP Marketing

Confirm Lead Replication to


SAP Marketing V2

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.

If you are setting up the


integration for the first
time, please use V2.

Opportunity from C4C to Replicate Opportunity to SAP Opportunity Replication to


MKT Marketing SAP Business Suite

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 Permissions from Request Marketing Permis- Request Marketing Permis-


MKT to C4C sions and Subscriptions from sions and Subscriptions from
SAP Marketing SAP Business Suite

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_0045 To allow navigation from the none none


MKT user interface to busi-
ness objects outside MKT, for
example, in C4C

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

Replicate Business Partner


Relationship to SAP Market-
ing via Business Partner Web
Services

Confirm Business Partner


Replication from SAP Mar-
keting

Confirm Business Partner


Relationship Replication from
SAP Marketing

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

4. In SAP Cloud Integration, also deploy the following new iFlows.

Newly Created iFlows

Confirm Business Partner Replication from SAP Marketing

Confirm Business Partner Relationship Replication from SAP Marketing

Replicate Key Mapping to SAP Marketing

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

6.1 Required Information

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:

SAP Marketing Cloud Tenant Details

SAP Cloud Integration tenant details

SAP Cloud for Customer Tenant Details

 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.

• SAP Cloud Integration tenant certificate.

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 Configuration in SAP Marketing Cloud

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

1. Access the SAP Marketing Cloud system and log in as an Administrator.


2. Choose Maintain Employees from Employee – Master Data
3. To create a new employee, choose Add.
4. Choose Upload and choose Delimiter Comma and choose Download Template.
5. Delete the sample data and update the Key Users Details and save the file. For an example, see the table
below.

 Note

Current Date is needed for the column StartDate

Field Value Example

Employee ID <A valid ID for the Employee> M12345

Last Name <A valid name> MarketingExpert

Create Business User <Enter X if you need to create a business user X

Valid From <Current Date with YYYYMMDD format> 20170303

Valid To <Valid End Date with YYYYMMDD format> 99991231

UserName <A valid user name> MarketingExpert

6. Browse for the file and choose Upload.


7. You can see the below message in case import is successful.
8. Log in to SAP Marketing Cloud system with UserName - MarketingExpert provided in the import file and
initial password as Initial1! Change the password during first logon.

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.

7.1.3 Authorizations for Users in SAP Marketing Cloud

Procedure

1. Access the SAP Marketing Cloud system and log in as an Administrator.


2. Choose Maintain Business Users under Identity and Access Management

3. Search your KEYUSER (Example: MARKETINGEXPERT) in the Search tab and choose to open it.

4. Click Add to assign business roles as required.


To know the roles to be assigned, see Business Roles and Apps in SAP Marketing Cloud.
5. Choose Save.

7.1.4 Setting up Communication Arrangements

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.

7.1.4.1 Create Technical Communication User

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

1. Log on to the SAP Marketing Cloud system and log in as a Administrator.


2. Choose the Maintain Communication Users.

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

User Name <user name> for example: CODINTEG

Description Marketing Cloud Communication User

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.

7.1.4.2 Define Communication Systems

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

1. Log on to your SAP Marketing Cloud system as an Administrator.


2. Choose the Communication Systems app under Communication Management.
3. Choose New.
4. For System Name, enter any descriptive name and Choose Create.
5. In the Technical Data section, enter the details of your SAP Cloud Integration tenant in the Host Name
field. You can find it in the email forSAP Cloud Integration tenant provisioning, for example, <tenant>-
iflmap.hana.ondemand.com).
6. Enter the SAP Cloud for Customer's My System ID in the Logical System.
7. Enter the SAP Cloud for Customer's My System ID in the Business System.
8. Under the User for Inbound Communication, choose Add.
9. If you want to use certificate-based authentication between SAP Cloud Integration and SAP Marketing
Cloud, choose SSL Client Certificate as authentication method. Select the User Name to which you have
associated the SAP Cloud Integration Client Certificate. For more information, refer to chapter Create
Technical Communication User [page 16].
10. Choose OK.
11. Under User for Outbound Communication, choose Add.
12. Choose:
• Authentication Method: SSL Client Certificate
• Certificate Type: Default Client Certificate
Choose Download Certificate. Save the downloaded file and convert it in the following way:
• Open the downloaded certificate.
• Choose Details.
• Choose Copy To File.
• The Certificate Export Wizard opens.
• Choose DER encoded binary X.509 (.CER) as file format.
• Specify the name of the file you want to export.
• Finish the download.
13. Choose Create.
14. Choose Save.
15. The CER file can later be used and uploaded to SAP Cloud Integration system for each iFlow. For more
information, see Configure and Deploy iFlows from SAP Cloud for Customer to SAP Marketing Cloud [page
62].

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.

7.1.4.2.3 Define Communication System for SAP Marketing


Cloud

The communication system defined in the SAP Marketing Cloud system is used as the source or target system.

Procedure

1. Access the SAP Marketing Cloud system and log on as Administrator.


2. Choose Communication Systems under Communication Management.

3. On the next screen, choose New. The following screen appears.

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.

12. Choose Create.


13. Choose Save.

7.1.4.3 Maintaining Communication Arrangements

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)

The communication arrangement SAP_COM_0017 (Marketing - Presales/Sales Integration) allows the


replication of transactional data between SAP Marketing Cloud and SAP Cloud for Customer.

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].

7. Maintain Additional Properties.


1. Under Target System Type, verify SAP_C4C as the property value. In SAP Marketing Cloud system,
only one communication arrangement Marketing - Presales/Sales Integration with target system type
SAP_C4C can be active.
2. If you want to transfer campaign information from SAP Marketing Cloud to SAP Cloud for Customer,
enter X (Active) for Campaign Transfer to Sales.
3. Fields First Origin of Contact ID, Second Origin of Contact ID, Third Origin of Contact ID must be left
empty.

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

Export Leads /cxf/yMKT/C4C/


LeadReplicationRequest_Out

Export Activities /cxf/yMKT/C4C/ActivityReplicationOut

Export Campaigns /cxf/yMKT/C4C/


CampaignReplicationNotification_Out_E
XT

11. Choose Save.

7.1.4.3.2 Communication Arrangement SAP_COM_0045


for SAP Cloud for Customer (UI Navigation)

The communication arrangement SAP_COM_0045 (Marketing - Presales/Sales UI Integration) allows


navigation from the SAP Marketing Cloud user interface to business objects in SAP Cloud for Customer such
as leads, opportunities, phone calls and visits.

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

Ensure that the Service Status checkbox is not set to Active!

9. Choose Save.

7.1.4.3.4 Communication Arrangement SAP_COM_0475

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.

7.1.4.3.5 Communication Arrangement SAP_COM_0003

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.

7.1.5 Adapt Business Configuration for Interaction Contacts


in SAP Marketing Cloud

 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:

Interaction Contact Interaction Contact


Origin ID Origin Description Quality System Productive System Object Type

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.

7.1.6 Filter for Campaigns to be Replicated to SAP Cloud for


Customer (Optional)

 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:

1. Log on to your SAP Marketing Cloud system as an administrator


2. Choose app Custom Logic under Extensibility.
3. Check if an enhancement implementation for enhancement option Lead Management: Determine Target
System Type already exists. If so, select it. If not, click on the Add (+) button
4. In the pop-up New Enhancement Implementation, use the value help for the field Business Context and
choose Marketing: Campaign
5. In field Enhancement Option, use the value help and choose Filter for Campaigns to Be Replicated to SAP
Cloud for Customer.
6. In field Name, enter a name for your enhancement.
7. Click Create. Select 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.

7.1.7 Determine Target System Type (Optional)

 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:

1. Log on to your SAP Marketing Cloud system as an administrator


2. Choose app Custom Logic
3. Check if an Enhancement Implementation for Enhancement Option Lead Management: Determine Target
System Type already exists. If it exists select the button, if not then click the add button.

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).

7.1.8 SAP Application Interface Framework Monitoring

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.

1. Log on to the SAP Fiori launchpad as an Administrator.


2. Choose the Assign Recipients to Users app.

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.

1. Access the SAP Fiori launchpad and log on as Administrator.


2. Choose Message Dashboard in Message Monitoring.

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.

7.2.1.2 Create Administrator with Initial User

Procedure

1. Navigate to the below work center.

Work Center Business Configuration

View Implementation Projects

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

First Name ADMIN

Last Name PROJECT

Phone The Project Administrator or Contact's


Phone

E-Mail The Project Administrator or Contact's


E-Mail

5. Choose Save and choose Request User.


6. Choose Close.
7. Close these Opened Pages.
8. Now log out and then log in the system again with project initial user.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
34 PUBLIC Configuration
9. Go to below work center and choose Go.

Work Center Administrator

View General Settings Users Business Users

10. Select the User ID.

Example
PROJECTADMIN7000000
11. Go to Edit Attributes , maintain the following values.

Field Value

User ID USERID For example: PROJECTADMIN

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.

Work Center/ View ID Work Center / View Name

SEODADMINWCF Administrator

BC_BUSINESSCONFIGURATION Business Configuration

BUSINESSPARTNERS_WCF Business Partners

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

MOM_ORGANIZATIONALMANAGEMENT Organizational Management

CODPARTNERWC Partners

CODPEOPLE People

COD_PRODUCTDATA Products

CI_CUSTOMER_CONTROL_CENTER Service Control Center

DATA_INTEGRATION Data Integration

14. Choose Save twice.

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

1. Log on to SAP Cloud for Customer.


2. Choose work center view:

Work Center Business Configuration

View Implementation Projects

3. Select First Implementation project.


4. Choose Edit Project Scope button.

5. In the Country step, choose Edit Countries.

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

Implementation Focus Selected

SAP Cloud for Customer Checked

9. In the Scoping step, maintain the following values and choose Next:

Scoping Element L1 Scoping Element L2 Scoping Element L3

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

Sales Account and Activity Management Account Management

Activity Management

Sales Lead Management Leads

Sales New Business Opportunities

Sales Campaign Campaign Management Marketing Permission

General Business Data Business Partners

Employee and Service Agents

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.

10. Choose Next.


11. In the Questions step, navigate using the following path. Communication and Information Exchange
Integration with External Applications and Solutions
12. Select the Scoping Element, on the Right Pane maintain the following values.

13. Mark In Scope for below Elements:

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?

Do you want to query marketing permissions and sub-


scriptions information from an external application to your
cloud solution?

Do you want to replicate marketing permissions from your


cloud solution to an external application?

Do you want to replicate ID mapping from your cloud solu-


tion to an external application?

Integration into Sales, Service, and Marketing Processes Do you want to replicate activities from your cloud solu-
tion to an external application?

Do you want to replicate activities from an external appli-


cation to your cloud solution?

Do you want to replicate leads from an external applica-


tion to your cloud solution?

Do you want to replicate leads from your cloud solution to


an external application?

Do you want to replicate marketing leads from your cloud


solution to an external application?

Do you want to replicate opportunities from your cloud


solution to an external application?

Do you want to replicate campaigns from an external ap-


plication to your cloud solution?

Do you want to query campaign interaction information


from an external application to your cloud solution?

Integration with SAP Marketing Do you want to replicate business attributes to SAP Mar-
keting?

14. Choose Next.


15. Choose Accept Preselected Answers on the pop-up to confirm the values selected in the Questions step.
16. Review the Scoping Setting and choose Finish to complete the scoping.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
40 PUBLIC Configuration
17. On the Confirmation step, choose Close.

7.2.1.4 Confirm Milestone: Design Accepted

Procedure

1. Log on to SAP Cloud for Customer.


2. Go to the Work Center Implementation Projects.
3. Select the title First Implementation project.
4. Choose Open Activity List
5. On the Prepare tab, choose Confirm Milestone: Design Accepted.
6. In the page, select Design Accepted and choose Confirm.
7. On the Prompt, choose OK to continue.
8. Choose Confirm.
9. Choose Close

 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

1. Log on to SAP Cloud for Customer.


2. Input the administrator user and password created, and choose Log On.

Field Value

User ID USER ID For example: PROJECTADMIN

Password Password

3. Change the password then log on again.


4. Navigate to the below work center view

Work Center Business Configuration

View Implementation Projects

5. Select First Implementation project


6. Choose Open Activity List.
7. On the Prepare tab, choose Define Administrators for Project Team.
8. Choose Lock Initial User.
9. Choose Lock User.
10. Choose OK and close the opened pages.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
42 PUBLIC Configuration
7.2.2 Fine Tuning

7.2.2.1 Define Business Roles

Procedure

1. Navigate to below work center.

Work Center Administrator

View General Settings

2. Select Users Business Roles .


3. Choose New Business Role . On the new window, maintain below values.

Tab Field Value

General Business Role ID SALES_REP_MARKETING

4. Choose Maintain Name and Description.


5. In the dialog box, add the following values:

Tab Field Value

General Language EN - English

General Business Role Name Sales Representative - Marketing

General Description Sales Representative - Marketing In-


formation

6. Choose OK.
7. Choose the tab Work Center and View Assignments
.
8. Select below assignment.

Tab Work Center/ View ID Work Center/ View Name

WORK CENTER AND VIEW CODACCOUNTWCV Customers -> Accounts


ASSIGNMENTS
COD_CONTACT_WCV Customers -> Contacts

COD_SEOD_ACCOUNTWL_WCVIEW Customers -> Individual Customers

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 43
Tab Work Center/ View ID Work Center/ View Name

WORK CENTER AND VIEW COD_PRODUCTDATA-> COD_MATE- Products


ASSIGNMENTS RIAL
Products -> Products
COD_PRODUCTDATA-> PMM_PRO-
Products -> Product Categories
DUCTCATEGORIES

WORK CENTER AND VIEW COD_SALES_WCF Sales


ASSIGNMENTS
COD_OPPORTUNITY_WCVIEW Sales -> Opportunities

COD_MKT_PROSPECTWC Sales -> Leads

WORK CENTER AND VIEW CODPEOPLE Employees


ASSIGNMENTS
COD_EMPLOYEES Employees-> Employees

WORK CENTER AND VIEW COD_ACTIVITIES Activities


ASSIGNMENTS
COD_ACTIVITIES -> COD_APPOINT- Appointments
MENT
E-mails
COD_ACTIVITIES -> COD_EMAIL
Phone Calls
COD_ACTIVITIES -> COD_PHONE-
Tasks
CALL

COD_ACTIVITIES -> COD_TASK

WORK CENTER AND VIEW COD_MARKETING Sales Campaign


ASSIGNMENTS
COD_CAMPAIGN Sales Campaign -> Campaigns

9. Select Actions Activate from the bottom right corner.


10. Save and Close the business roles page.

7.2.2.2 Create User for Integration Test

1. Choose the work center view: Administrator General Settings


2. Under section Users, choose Employees.
3. Choose New Employee and create the following settings:

Field Value

First Name Marketing

Last Name Sales Rep

4. Choose Save and Close.


5. Choose the work center view: Administrator General Settings .

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

Password Enter a password

9. Choose Edit Access Rights. Then choose Yes to save your changes.
10. Assign the role to the user:

Business Role ID Assigned to User

SALES_REP_MARKETING Checked

11. Choose Save and confirm your changes with Save.

7.2.3 Communication Language for Data Replication

1. Navigate to the following work center view.

Work Ccenter BUSINESS CONFIGURATION

View IMPLEMENTATION PROJECTS

2. Choose Open Activity List.


3. Choose Fine-Tune.
4. Choose Communication Language for Data Replication in the table.
5. Choose Add Row. And add your default language for text replication. Example: EN
6. Choose Save and Close.

7.2.4 Set Up Communication System

1. 1. Log on to SAP Cloud for Customer.


2. Navigate to the following work center view.

Work Center Administrator

View General Settings

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 45
3. Choose Communication Systems in the Integration division

4. Choose New to define Communication System, maintain as following.

Field Value Comment

ID Enter a SID SID is the system ID and XXX is the


Client number of the SAP Marketing
example: SIDCLNTXXX
Cloud system.

SAP Business Suite Yes

Host Name Enter the SAP Cloud Integration Run-


time URL. This URL is included in the
SAP Cloud Integration provisioning e-
mail. For more information, see How
to get the SAP Cloud Integration Run-
time URL [page 86].

System Access Type Internet

Internal Comment Optional.

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

Business System ID My System ID of Marketing Cloud sys-


tem

IDoc Logical System ID My System ID of Marketing Cloud sys-


tem

SAP Client Client Number example: XXX

Preferred Application Protocol 5-Web Service

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.

7.2.5 Configure Communication Arrangements

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

Communication Scenarios Communication Services Inbound Communication Services Outbound

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

• Confirm Business Activity Replica- • Replicate Business Activity to SAP


tion from SAP Business Suite - Business Suite - Select
Unselect
• Replicate Business Activity Attach-
ment to 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 Attribute and Assignment • Replicate Business Attribute As-


Replication with SAP Marketing signment to SAP Marketing -
Select

• Replicate Business Attribute Set to


SAP Marketing - Select

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

• Replicate Business Partner Direct


Responsibility to SAP Business
Suite - Unselect

Campaign Replication from SAP Busi- • Replicate Campaign from SAP


ness Suite Business Suite - Select

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

• Replicate Leads from the 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

• Replicate Lead to SAP Business


Suite - Unselect

• Replicate Marketing Lead to SAP


Business Suite - Select

Marketing Permission Replication to • Replicate Marketing Permission to


SAP Business Suite SAP Business Suite - Select (dep-
recated since 2102)

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

• Deprecated: Replicate Opportunity


to SAP Business Suite - Unselect

Request Campaign Interactions from • Request Campaign Interactions


SAP Business Suite from SAP Business Suite - Select

Request Marketing Permissions and • Request Marketing Permissions


Subscriptions from SAP Business and Subscriptions from SAP Busi-
Suite ness Suite - Select

ID Mapping Replication to SAP Busi- • Replicate ID Mapping to SAP Busi-


ness Suite ness Suite - Unselect
• Replicate Business Partner ID
Mapping to SAP Business Suite -
Select

 Note

In case you do not see any of the configuration scenarios, recheck the project scoping to add the necessary
scoping elements.

1. Log on to SAP Cloud for Customer.


2. Go to Administrator General Settings Integration Communication Arrangements
3. Choose New to create a new communication arrangement
4. In Communication Scenarios table, select the Communication Scenario, Business Activity Replication from
SAP Business Suite
5. Choose Next
6. Choose System Instance ID from the value help. You have already created this communication system ID of
the SAP Marketing Cloud system. See Set Up Communication System [page 45].
7. Choose Code List Mapping as SAP On-Premise Integration

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.

10. Click Edit Credentials.


11. On the Certificate tab, choose Upload Certificate.
12. Choose SAP Cloud Integration Client Certificate and choose OK.
13. Choose Edit Advanced Settings
14. Under the Inbound tab, select Replicate Business Activity from SAP Business Suite.
15. Under the Outbound tab, select Confirm Business Activity Replication to SAP Business Suite For Outbound
Communication Credentials click Download.
16. Enter a name for SAP Cloud for Customer Client Certificate X.509 (example C4CSSLClient.cer) and
choose Save.

 Note

This certificate has to be uploaded while configuring SAP Cloud for Customer to SAP Cloud Integration
inbound iFlow.

17. Choose Edit Advanced Settings


18. Choose Outbound tab
19. Enter the Path for Confirm Business Activity Replication to SAP Marketing service. The path should be taken
from the corresponding SAP Cloud Integration iFlow sender's tab.

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

20.Choose Next and Finish.


21. Click Close.

7.2.6 Filter Communication Arrangements

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

1. Log on to SAP Cloud for Customer.


2. In the Administrator work center, choose the General Settings view.
3. Go to the section Integration and open Communication Arrangement Filters.
4. Choose Add Row and fill the table as following:

Communication Partner Communication System from SAP Marketing Cloud

Communication Scenario Name Business Partner Replication to SAP Business Suite

5. Add Row for the Filters and select Send Business Partners with In Preparation status.

7.2.7 Change the Assignment of Categories

Procedure

1. Log on to SAP Cloud for Customer.


2. In the Business Configuration work center, choose the Implementation Projects view.
3. Select the project and select Open Activity List.
4. Choose the Fine Tune tab and select Leads.

 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.

5. Choose Assign Categories.


6. Add the category 0002 – Telephone Call.
7. Save and Close your entries.

7.2.8 Assigning Involved Parties for Tasks

1. Log on to SAP Cloud for Customer.


2. Navigate to the Workcenter Business Configuration and choose Implementation Projects view
3. Select the First Implementation project
4. Choose Open Activity List
5. Choose the Fine Tuning tab and choose All Activities
6. Search for Activities in the list and choose 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.

7.2.9 Create Attribute and Attribute Set (Optional)

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

Format Example: Character Format

5. Choose Save and Open.


6. In General Data Section click Add to add value list. (Example: 1, 2 or 3)
7. In Description Section, select the Language and Description. Example: English and Beginner

8. Click Actions and Release. Repeat for the values below:

ID Example: HD_EMPLOYEE_SINCE

Description Example: Employed Since

Format Example: Date Format

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

Description Example: Information for Contact

Business Application Business Partner

Person-Relevant or Organization -Relevant checkbox Select the Checkbox as per Requirement

10. Select Save and Open


11. Under the Attributes tab, select Add and Choose any of the Attributes from the value help to add.
12. Press Save button.
13. Click Actions button and select Release to release the Attribute Set.

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

Upload Code List Mapping

1. On the Support Launchpad, go to SAP Note 2355989 .


2. Download the code list mapping file, which is attached to the note, to your local computer. This file will be
uploaded to SAP Cloud for Customer in the following steps.
3. Log on to SAP Cloud for Customer.
4. Go to Business Configuration Upload Code List

 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.

5. Select Upload Code List.


6. Select the code list mapping group On Premise Integration.
7. Choose Upload.
8. Select the file you downloaded in step 1.

Check the status of Code List Mapping upload in the Application Log

1. Go to Business Configuration Upload Code List Application Log .


2. Select the required Application Log ID. The log displays information in the following tabs:
• General: Displays a high-level summary and administrative data for the job
• Settings: Displays settings selected during an upload
• Results: Displays the detailed results of the job including a list of detailed message descriptions, and
the nature of the message.
• You can also export the information on the tabs to Microsoft Excel. To do this, select Export to Microsoft
Excel, and select the tab from which you wish to export the data.

View Code List Mapping

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.

7.2.11 Create and add an URL Mash-up

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

1. Log on to SAP Cloud for Customer.


2. Navigate to Administrator workcenter and navigate to Mashup Authoring workcenter View.
3. Choose New and choose URL Mashup from the list.
4. In the resulting screen, maintain the following:

Field Value Comment

Port Binding type With Port Binding

Port Binding Marketing Permission Port

Mashup Name Enter a valid name, such as: Edit Per-


missions and Subscriptions

URL Provide a URL as per the integrated Fill any dummy value in the URL for
SAP Marketing Cloud system. InteractionContactID in the URL

Format for 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

5. Once the URL is added, choose Extract Parameters.


6. In the Request Parameter table, delete the constant value for the InteractionContactID field and add
a Parameter Binding for it. Choose the selection button which appears besides the Parameter Binding
column and choose InteractionContactID entry.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 57
7. Choose Activate and Save the Mashup.

 Note

Perform the steps mentioned below after Account is replicated.

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

7.3 Configuration in SAP Cloud Integration

 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.

7.3.1 Deploy Technical Communication User Data with a


Credential Artifact

 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

1. Open the SAP Cloud Integration, integration service tenant WEB UI


(for example, https://<your SAP Cloud Integration, integration service tenant URL>/
itspaces)
2. On the tenant menu, choose Monitor.
3. Choose the Security Material tile in the Manage Security Material section.
4. Choose Add.
5. Select User Credentials.
6. Enter the following values in the Add Users Credential dialog box window:

Field Name Entry Value

Name For example, Mkt_Credential

Description optional

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
60 PUBLIC Configuration
Field Name Entry Value

User <User Alias Name of your technical user>

Enter the user name created in Create Technical Communication User [page
16].

Password <Password of your technical user>

7. Choose OK to save the user credentials.


8. In case of the replication of Business Transactions was selected in , a second credential artifact need to be
created, choose Add.
9. Enter the following values in the Add Users Credential dialog box:

Field Name Entry Value

Name For example, C4C_Credential

Description Optional

User <User Alias Name of your technical user>

Enter the user name created in Create SAP CRM User

Password <Password of your technical user>

10. Choose OK to save the user credentials.

7.3.2 Deployment of the Artifacts

1. Open the SAP Cloud Integration service tenant WEB UI.

 Example

https://<your SAP Cloud Integration tenant URL>/itspaces

2. On the tenant menu, choose Discover.


3. Select All to see all published integration packages.
4. Search for the SAP Cloud for Customer Integration with SAP Marketing package.
5. Choose the package to display the package content.
6. To copy the integration package of the catalog to your customer workspace, choose Copy in the upper right
corner, to copy the package.
7. On the tenant menu, choose Design.
8. On the Design tab page, select the SAP Cloud for Customer Integration with SAP Marketing package
that contains the integration scenarios.
9. An overview of the artifacts available in the selected integration package is shown.

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

1. Open the SAP Cloud Integration service tenant WEB UI.


2. Select the Design mode and select the integration package you copied.
3. Go to the Artifacts tab and configure each iFlow in the table below.

iFlows to Configure

Name of the iFlow Description of the iFlow

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

Confirm Business Partner --

Confirm Business Partner Relationship Replica- --


tion from SAP Marketing

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 Lead to SAP Marketing V2 Lead Replication to SAP Marketing


Interface

Replicate Marketing Permission to SAP Market- Marketing Permission Replication to SAP Marketing
ing (Deprecated as of 2102)

Replicate Opportunity to SAP Marketing Opportunity Replication to SAP Marketing

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

4. To configure an iFlow, choose Actions Configure .


5. For the iFlows, provide the relevant details on the Sender tab page:

 Note

Not every iFlow will have the full list of fields.

Field Name Entry Value

Sender: C4C

Adapter Type: SOAP

Address: is prefilled for every iFlow

This address must be unique on SAP Cloud Integration


service tenant. If this scenario should be deployed twice
on same tenant, this address needs to be changed.

URL to WSDL is prefilled for every iFlow

Authorization User Role or Client Certificate.

User Role is prefilled for every iFlow

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

Receiver Choose yMKT or MKT

Adapter Type SOAP or HCIODATA

Address is prefilled for every iFlow

Protocol-Hostname-Port https://<hostname>:<port>, for example


https://my12345-api.s4hana.ondemand.com

To retrieve the protocol, hostname and port, check the


Service URL of the communication arrangement created
in Communication Arrangement SAP_COM_0017 for SAP
Cloud Integration (SAP Cloud for Customer Integration)
[page 23]

Proxy Type Internet

Authentication Basic or Client Certificate

Credential Name (only for basic authentication) Credentials

Enter the name from Deploy Technical Communication


User Data with a Credential Artifact

Private Key Alias (for Certificate-based Authentication) sap_cloudintegrationcertificate

Alias for SSL keypair in SAP Cloud Integration service key-


store.

7. Provide the relevant details on the More tab page:

Field Name Entry Value

Type All Parameters

Content Modifier false (default)

If you have an iflow extension scenario implemented, you


must change this to true.

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

1. Open the SAP Cloud Integration service tenant WEB UI.


2. Select the Design mode and select the integration package you copied.
3. Go to the Artifacts tab and configure each iFlow mentioned in the table below:

iFlows to Configure

Name of the iFlow Description of the iFlow

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

Not every iFlow will have the full list of fields.

Field Name Entry Value

Sender: yMKT

Adapter Type: SOAP

Address: is prefilled for every iFlow

This address must be unique on SAP Cloud Integration


service tenant. If this scenario should be deployed twice
on same tenant, this address needs to be changed.

URL to WSDL is prefilled for every iFlow

Authorization User Role or Client Certificate.

User Role is prefilled for every iFlow

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

Adapter Type SOAP

Address https://<s4_yMkt_host>:<s4_yMkt_port>

Host *.crm.ondemand.com

Port 443

Proxy Type Internet

Authentication Basic or Client Certificate (for Cloud connector, only Basic


or None)

Principal Propagation

Credential Name (only for basic authentication) Credentials

Private Key Alias (for Certificate-based Authentication) sap_cloudintegrationcertificate

Alias for SSL keypair in SAP Cloud Integration service key-


store.

For example, hcicertificate (provided by SAP).

6. Provide the relevant details on the More tab page:

Field Name Entry Value

Type All Parameters

Content Modifier false (default)

If you have an iflow extension scenario implemented, you


must change this to true.

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

CUAN, SystemID COD, BusinessSystemID

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

CUAN, LogicalSystem COD, CommunicationLanguage

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

CUAN, MapBusinessPartnerRole COD, BusinessPartnerRoleCode

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.

Business Partner Roles in SAP Marketing Cloud  Tip


ROLE Description In order to get the used role codes, open your
SAP Cloud for Customer system, go to Business
000000 Business Partner (General)
Configuration and select the implementation project.
AGC001 External Marketing Agent Go to Open Activity List and select Accounts. There you
BBP005 Service Performer will find the activity Maintain Customer Roles. Please
keep in mind that the SAP Cloud for Customer Code
BBP010 Freelancer
List Mapping could choose a different external code.
BUP001 Contact Person

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

as contact. SAP Marketing via Business Partner Web Services).

If a consumer has this role,


they will also be flagged as a
contact.

BUP002 Prospect

BUP003 Employee

If a business partner has this


role, no interaction contact is
created for them.

If you want to create interac-


tion contacts for these busi-
ness partners, you can re-
move the role BUP003 from
the iFlow.

FLCU000 Customer (Fin. Accounting)

If a business partner has this


role, they will be flagged as
consumer.

FLCU01 Customer

If a business partner has this


role, they will be flagged as
consumer.

FLVN00 Supplier (Fin. Accounting)

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 69
CUAN, MapBusinessPartnerRole COD, BusinessPartnerRoleCode

ROLE Description

FLVN01 Supplier

FS0000 Financial Services BP

UDM000 Collections Management

WFVN00 FI Workforce Creditor

 Tip
In order to get the role codes, open your SAP
Marketing Cloud system as an configuration expert, go to

Configure Your Solution Application Area: Database

and Data Management Sub Applicatoin Areas: Business

Partner and select the app Define Business Partner


Roles.

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

In SAP Marketing Cloud it is not possible to change any


 Tip
relationship categories. So make sure to use the code list
mapping in SAP Cloud for Customer. In order to get the used role codes, open your
SAP Cloud for Customer system, go to Business
The available relationship category roles in SAP Marketing Configuration and select the implementation project.
Cloud are based on the following criteria: Go to Open Activity List and select Accounts. There you
will find the activity Maintain Customer Relationships.
• Only relationships between contacts and accounts are
Please keep in mind that the SAP Cloud for Customer
considered. Relationships between 2 contacts or be-
Code List Mapping could choose a different external
tween 2 accounts are not taken into account.
code.
• Only relationships with a direction are considered.

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

BBP002 Invoicing Party Rel.

BUR001 Contact Person Rel. ship

BUR002 Shared Living Arrangement

BUR011 Responsible Employee

BUR013 Replacement Relationship

BURC01 Shareholder Relationship

CHM005 Resp. Partner Contact

CRME01 Trader Relationship

CRME02 Trader - End Customer

CRME03 Service Center Relship

CRMH00 Undefined Relationship

CRMH02 Ship-To Party Relship

CRMH03 Payer Relationship

CRMH04 Bill-To Relship

CRMH06 Person Responsible

CRMH07 Wholesaler

CRMM01 Alternative Payer Relship

CRMM02 Payee Relationship

CRMM03 Corr Recipient Relship

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Configuration PUBLIC 71
CUAN, MapBusinessPartnerRelationship COD, BusinessPartnerRelationshipCategoryCode

RELTYP Description

CRMM04 Dunning Recipient Relship

CRMS01 Carrier

CRMS02 Manager for Entitlements

CRMS03 Responsible Scrapper

FI0200 Alternative Payer

FI0210 Authorized payers

FI0300 Altern. dunning recipient

FS0030 Borrower Entity Member

FSB001 Privat Co. with partners

ICM001 Organization Responsible

ICM002 External Organization

ICM003 External Person

UDM001 Collections Relationship

UKM001 CM Account Hierarchy

 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.

7.3.5.2 Optional Mappings

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

CUAN, CallLeadGroupCode COD, 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.

Default value: 0002 "Telephone Call".

Mapping between SAP Marketing Cloud CustomerTransactionDocumentOriginTypeCode and SAP Cloud


for Customer CustomerTransactionDocumentOriginTypeCodeCallLeadGroupCode

CUAN, CustomerTransactionDocumentOriginTypeCode COD, CustomerTransactionDocumentOriginTypeCode

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.

Default value: 003 "Campaign".

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.

Default value: EN "English".

 Note

Value mapping can be used for the marketing attribute assignments.

It offers the possibility to maintain one language code to map descriptions for marketing attribute
assignment values. The logic is as follows:

1. If no value is maintained, values are mapped.

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:

CUAN, CategoryCode COD, ActivityGroupCode

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

Activity Types are:

01 Activity Task

02 Appointment

03 Phone Call

04 Visit

7.4 Data Loading

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.

You can load the following data:

• Accounts or Contacts or Individual Customers


• Business Partners and Business Partner Relationships
• Marketing Permissions
• Business Attribute Sets

7.4.2 Initial Load of Account/ Contact/ Individual Customer


to SAP Marketing Cloud

Procedure

1. Logon to the SAP Cloud for Customer system.


2. Navigate to Administrator Workcenter Extract Data to External System Workcenter view
3. Choose Replicate Business Partner under Master Data.
4. In the resulting screen, maintain the criteria for which you want to execute the initial load

Field Description Value

Business Partner ID Business Partner to be replicated to <A Valid ID>


SAP Marketing Cloud system

Business System ID SAP Cloud for Customer Logical Sys- <Logical system name of
tem the Cloud for Customer>

Category 1-Person

Package Size 100

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

1. Logon to the SAP Cloud for Customer system.


2. Navigate to Administrator Workcenter Extract Data to External System Workcenter view
3. Choose Replicate Business Partner Relationship under Master Data.
4. In the resulting screen, maintain the criteria for which you want to execute the initial load

Field Description Value

Business System ID SAP Cloud for Customer Logical Sys- <Logical system name of
tem the Cloud for Customer>

Package Size 100

Test run No

5. Choose Execute.

7.4.4 Initial Load of Business Attribute Set and Assignment


to SAP Marketing Cloud (Optional).

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

1. Logon to the SAP Cloud for Customer system.


2. Navigate to Administrator Workcenter Extract Data to External System Workcenter view
3. Under Master Data choose Replicate Business Attribute Set to SAP Marketing.
4. In the resulting screen, maintain the criteria for which you want to execute the initial load Replicate
Business Attribute Assignment to SAP Marketing.

Field Description Value

Object Type Code (in case of Attribute


assignment replication)/Attribute Set
ID (In case of attribute set replication)

Business System ID SAP Cloud for Customer Logical Sys- Replicate Business
tem Attribute Assignment
to<Logical system name of
the Cloud for Customer>

Package Size 100

Test run No

5. Choose Execute.

7.5 Service Ticket Integration

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

Ticket Buyer Party Contact ID

Ticket Creation Date Time Time Stamp

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

Ticket Priority Code Interaction Priority

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.

Confirmation Issuing Status Code Status Code

Information Life Cycle Status Code External Status Code

Service Category Product Category of type Process Category

Incident Category Product Category of type Incident Category

Object Category Product Category of type Object Category

Cause Category Product Category of type Cause Category

Resolution Category Product Category of type Solution Category

• Ticket Completion Time Point Interaction Processing Duration


• Ticket Creation Date Time
Is calculated from TicketCompletionTimePoint minus Crea-
tionDateTime and converted into seconds.

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 .

Select the scoping question:

Do you want to replicate service ticket from your cloud solution to an external application?

Communication Scenario / Arrangements

You can setup the communication scenario under Administrator General Settings Integration
Communication Arrangements . The following Communication Scenarios are supported for this Integration:

Service Ticket Replication to SAP Business Suite

• Outbound Communication Services


• Replicate Service Tickets to SAP Business Suite

Cloud Integration iFlow


iFlow: Replicate Service Ticket to SAP Marketing

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.

Lead Status Mapping

Status in SAP Cloud for Customer Status in SAP Marketing Cloud

1 (Open) 01 (In Process)

2 (Qualified) 01 (In Process)

4 (Accepted) 01 (In Process)

5 (Declined) 07 (Unsuccessful)

6 (Converted) 05 (Converted)

Opportunity Status Mapping

Status in SAP Cloud for Customer Status in SAP Marketing Cloud

1 (Open) 01 (In Process)

2 (In Pprocess) 01 (In Process)

3 (Stopped) 07 (Unsuccessful)

4 (Won) 06 (Successful)

5 (Lost) 07 (Unsuccessful)

Activity Status Mapping

Status in SAP Cloud for Customer Status in SAP Marketing Cloud

1 (Open) 01 (In Process)

2 (In Process) 01 (In Process)

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.

9.1 SAP Cloud Integration with Extension Points in iFlows

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

9.2 SAP Marketing Cloud Scenario-Based Extensibility

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.

For more information, see Custom Fields.

 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.

9.3 SAP Marketing Cloud Business Add-Ins (BAdIs) for


Business Partner Integration

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.

BAdI Technical Name Use

CUAN_BUPA_MAP_BPREL_CODE_VALUE Business Partner mapping: Adjust relationship code values

CUAN_BUPA_MAP_BUPA_ADDRESS Business Partner mapping: Determine relevant address


usages

CUAN_BUPA_MAP_BUPA_CODE_VALUE Business Partner mapping: Adjust Business Partner code


values

CUAN_BUPA_MAP_BUPA_ROLE Business Partner mapping: Adjust role mapping

CUAN_BUPA_MAP_COMPANY_EXT_FLD Business Partner mapping: Adjust corporate account exten-


sion fields

CUAN_BUPA_MAP_MKT_AREA Business Partner mapping: Adjust marketing area

CUAN_BUPA_MAP_PERSON_EXT_FIELD Business Partner mapping: Adjust contact person extension


fields

CUAN_BUPA_MAP_REL_CAT Business Partner mapping: Get relevant relationship catego-


ries

For more information, see Custom Logic.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
82 PUBLIC Extensibility for SAP Business Partner Integration
10 Appendix

10.1 Maintain Organizational Data

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:

1. Login to the SAP Cloud for Customer system as an administrator

2. Navigate to Administrator General Settings

3. Choose Org Structure under Company

4. In the resulting screen choose New Org Unit

5.Maintain the following fields:

Field Value Comment

ID <A Valid ID> A Valid ID for the Org

Name The Name of the Sales Organization

Vaild From A valid start date

Vaild To A valid end date

Parent Unit <The Parent Org ID>

Sales Checked If the sales org that you are creating is


a sub-unit of an another existing org,
then provide that parent unit ID

Sales Organization Checked

Manager The manager who is responsible for the


Sales Org

6. Choose Save.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Appendix PUBLIC 83
10.2 Finding Required Information

10.2.1 How to get SAP Marketing Cloud Service URL

To find the SAP Marketing Cloud service URL, go to a communication arrangement.

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.

10.2.2 How to get SAP Marketing Cloud Client Certificate

Procedure

You can download the SAP Marketing Cloud client certificate from the communication system you created in
section.Define Communication Systems [page 17].

1. Log on to your SAP Marketing Cloud system as an administrator.


2. Choose the Communications Arrangements app.
3. Select the communication arrangement you created in section Maintaining Communication Arrangements
[page 22].
4. Choose Download Certificate in Outbound Communication to download the SAP Marketing Cloud client
certificate to your local system.
5. Open the downloaded certificate.
6. Choose Details.
7. Choose Copy To File.
8. The Certificate Export Wizard appears.
9. Choose DER encoded binary X.509 (.CER) under File Format.
10. Specify the name of the file you want to export.
11. Finish the download.

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].

1. Log on to your SAP Marketing Cloud system as an administrator.


2. Choose the Maintain Communication Arrangements app.
3. Select the communication arrangement you have created in section Maintaining Communication
Arrangements [page 22]
4. The logical system ID is displayed in field Own System under Common Data.

Alternativly, you can also choose Communication Systems, select the entry where the column Own System is
Yes and that is the system ID.

10.2.4 How to get SAP Cloud for Customer System ID

Procedure

You can get the logical system ID from the communication arrangement

1. Log on to your SAP Cloud for Customer system.


2. Choose Administrator.
3. Choose Communication Arrangements.
4. Select the communication arrangement you created.
5. The logical system ID is displayed in field My System under My Communication Data.

10.2.5 How to get the Integration Flow endpoints in SAP


Cloud Integration

Once the integration flows are deployed, you can get the endpoint of an integration flow as follows:

1. Log on to the SAP Cloud Integration Web UI.


2. Navigate to the Monitor view.
3. Under Manage Integration Content, choose Started.
4. Search for the integration flow, and select it in the list. The required service endpoint starts with /cxf/.

Setting Up SAP Marketing Cloud Integration with SAP Cloud for Customer (1J9)
Appendix PUBLIC 85
 Example

/cxf/yMKT/C4C/LeadReplicationRequest_Out

10.2.6 How to get the SAP Cloud Integration Runtime URL

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

10.2.7 How to Get the SAP Cloud Integration Client


Certificate

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.

10.3 Monitoring Messages

10.3.1 Monitoring Messages in SAP Cloud Integration WebUI

1. Log on to the SAP Cloud Integration Web UI.


2. Go to the Monitor view.
3. Under Monitor Message Processing, choose All Integration Flows.
4. Here you can find the messages for the SAP Cloud Integration endpoints that were called.
5. To find the right message, you can filter the list of messages according to Time, Status, Artifact or ID.

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.

10.3.2 Monitor messages in SAP Cloud for Customer

1. Log on to your SAP Cloud for Customer.


2. Go to the Administrator work center and select System Administration.
3. Under Web Service message Monitoring. you can view the number and status of all processed messages.
4. When a message with status System Error is selected, you can check its error log.
To check the error log, choose View Error Log .

10.3.3 Monitoring Messages in SAP Marketing Cloud

Procedure:

1. Log on to your SAP Marketing Cloud system as an administrator.

2. Go to Assign Recipients.

3. Enter Namespace CUAN.

4. Enter a relevant Recipient for the Alerts. Choose All_Interfaces and press Execute

5. Enter the relevant users that should see the messages

6. Flag the field Include on Overview

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-CSL Use this component for issues occurring in the SAP


Marketing Cloud, for example if lead outbound messages do
not reach the SAP Cloud Integration tenant.

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.

Videos Hosted on External Platforms


Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.

Beta and Other Experimental Features


Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

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

© 2024 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form


or for any purpose without the express permission of SAP SE or an SAP
affiliate company. The information contained herein may be changed
without prior notice.

Some software products marketed by SAP SE and its distributors


contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for


informational purposes only, without representation or warranty of any
kind, and SAP or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP or
SAP affiliate company products and services are those that are set forth
in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an
additional warranty.

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.

Please see https://www.sap.com/about/legal/trademark.html for


additional trademark information and notices.

THE BEST RUN

You might also like