Downporting SAP Hybris Marketing integration to earlier versions of SAP Hybris Commerce
SAP Hybris Commerce has included SAP Hybris Marketing integration since version 5.3.
It started with personalized campaign content, then grew to product recommendations, master and transactional data replication, and then in the 6.5 release, offer recommendations and clickstream data capture. Along the way, existing feature sets were improved and expanded upon. With SAP Hybris Commerce 6.5, you get the most up-to-date functionality for driving sales and gathering customer data.
But what if you’re integrating SAP Hybris Marketing with an earlier version of SAP Hybris Commerce?
This is a common predicament, and it produces the following dilemma: incur steep effort costs to upgrade, or forego the integration benefits included in later releases of SAP Hybris Commerce.
For SAP Hybris Commerce 6.5 we executed a strategy on the Marketing integration extensions to address this problem. The strategy allows you to use the latest 6.5 extensions with versions 6.0 to 6.4 of SAP Hybris Commerce. By following the installation and configuration steps provided below, you can leverage all the features from the 6.5 version of the SAP Hybris Marketing integration.
Note that you can use this downport process with the Expressway download package, which allows you to send master and transactional data directly from SAP Hybris Commerce to SAP Hybris Marketing. For more information, see SAP Hybris Commerce to SAP Hybris Marketing Integration via the Expressway.
Note also that due to the challenges involved in making SmartEdit enhancements available across releases, you must use the WCMS Cockpit for all Marketing integration activities.
How to Install and Configure
- Download SAP Hybris Commerce 6.5 patch 1 or higher (HYBRISCOMM6500P_X-XXXXXXXX.ZIP) from https://wiki.hybris.com/display/downloads/Download, and extract it to your desktop.
- In your current version of SAP Hybris Commerce, remove the extensions related to SAP Hybris Marketing integration. Specifically, if present, remove the following folders:
\hybris\bin\ext-integration\sap\adtreco \hybris\bin\ext-integration\ymkt \hybris\bin\ext-integration\sap\recentvieweditems \hybris\bin\ext-integration\sap\sapprodreco \hybris\bin\ext-integration\sap\y2ysync
If you downloaded any other extensions for Marketing integration, for example the extension that came with the initial downloadable Clickstream package, delete those too.
- Copy the following folder from the 6.5 patch to your version of SAP Hybris Commerce: \hybris\bin\ext-integration\ymkt
- Optional: Remove the \hybris\bin\ext-integration\ymkt\sapymktsync folder, and replace it with the corresponding folder in the Expressway download.
- Add the following extensions to the \hybris\config\localextensions.xml file:
sapymktsync
hybrisanalyticsaddon
eventtrackingwsaddon
sapymktclickstream
recentvieweditemsaddon
sapprodrecoaddon
sapymktsegmentation
b2cbtgaddon (for versions 6.1 to 6.4 only) - Add the following to the local.properties file:
csrf.allowed.url.patterns=/[/]+(/[?]*)+(sop/response)$,/[/]+(/[?]*)+(merchant_callback)$,/[/]+(/[?]*)+(hop/response)$,/[/]+(/[?]*)+(language)$,/[/]+(/[?]*)+(currency)$,/(events)$ piwik.tracker.url.electronics=/yacceleratorstorefront/events piwik.tracker.https.url.electronics=/yacceleratorstorefront/events piwik.tracker.url.apparel-uk=/yacceleratorstorefront/events piwik.tracker.https.url.apparel-uk=/yacceleratorstorefront/events piwik.tracker.url.apparel-de=/yacceleratorstorefront/events piwik.tracker.https.url.apparel-de=/yacceleratorstorefront/events sapymktcommon.odata.url.root=<root path of the SAP Hybris Marketing server> sapymktcommon.odata.url.user=<technical user for SAP Hybris Marketing> sapymktcommon.odata.url.password=<password associated with the technical user> sapymktclickstream.listener.events.batchSize=1 sapymktsegmentation.campaign_category_id=A1
- Install the required AddOns using one of the following commands, depending on your version of SAP Hybris Commerce:
Version 6.0:ant addoninstall -Daddonnames="recentvieweditemsaddon,sapprodrecoaddon,hybrisanalyticsaddon,eventtrackingwsaddon" -DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront"
Versions 6.1 to 6.4:
ant addoninstall -Daddonnames="recentvieweditemsaddon,sapprodrecoaddon,hybrisanalyticsaddon,eventtrackingwsaddon,b2cbtgaddon" -DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront"
- Use the following command to update the system: ant updatesystem
References
- For more information about the sapymktcommon properties, see sapymktcommon Extension, located at https://help.hybris.com under Integrations and Data Management -> SAP Integrations -> SAP Hybris Marketing -> Installation and Configuration -> sapymktcommon Extension.
- https://jira.hybris.com/browse/ECP-2159 –
DataIntegrityViolationException when SAP Hybris Marketing product recommendations are buffered - https://jira.hybris.com/browse/ECP-2182 – yMKT – Segmentation – Portability of incompatible changes
Very good and useful procedure – thanks Dev team!
Procedure was already used for a few customers.
Hi,
which are the minimal modules needed to use ExpressWay? Is it enough to add sapymktsync and sapymktcommon to Hybris 6.3 to sync data from yCommerce to yMarketing?
regards,
PJ
Yes.
Use the proper commerce release to extract sapymktcommon extension :
- Commerce 6.5 for
- Commerce 6.6 for
Hi!,
Are doing the downporting to 6.4 but gets into problem regarding the addoninstall. It doesn't really play with my custom code. Is there anything I need to make different to get it working with custom code?
It's the b2cbtgaddon that's gives me problems. I'm doing the addoninstall exactly apart from changing the "yacceleratorstorefront" part in the end to the customer storefront. Is that correct? It's on B2B.
BR
Christer Hedström
Hello Christer,
this blog is about downporting the standard B2C integration from 6.5 to lower releases of ECP, as this request came up very often from customers. As the integration is B2C only, we don't support yet the B2B accelerator addons specifics, which indeed could create some issues.
As your code is custom, does it work properly on a 6.5 before you attempted to do the downport to 6.4 ?
In any case, we cannot provide much help here. Colleagues in charge of b2cbtgaddon would be for you a better support. I would recommend to post this question on the expert forum: https://experts.hybris.com/index.html
BR,
Emmanuel
Hi, has anyone integrated Commerce cloud 2011?