Multi-Currency Support

IBM® Digital Analytics supports capturing multiple different currencies for purchases under a single client ID. To enable this functionality, you must specify a currency code that conforms to the ISO4217 specification. See http://www.xe.com/iso4217.htm for reference.

A given Client ID can report currency format data using only the single currency code that you specified in the settings for that Client ID. Using "multi-currency conversion" through the cmSetCurrencyCode function or the cm_currencyCode variable does not change the currency code used to report currency data within a given Client ID; it only converts Order Total, Unit Price and Shipping Charge values collected in different currencies to the single reporting currency that you have specified for that Client ID.

Currency values must be included in the data captured in Shop Action 5, Shop Action 9, and Order tags. To capture the currency code with the relevant tag data, call the cmSetupOther(...) function with the variable name cm_currencyCode and the 3-byte currency code. For example:

cmSetupOther({"cm_currencyCode":"EUR"});

The cmSetupOther(...) function can be called in the same script block as the cmSetClientID(...) call on the page.

If you are not using IBM Digital Analytics hosted libraries (libs.coremetrics.com/eluminate.js) version 4.7.5 or later, the cmSetupOther function will not be available. In this case, call the cmSetCurrencyCode function anywhere in the tagged page prior to the related Shop or Order tag function calls. For example:

<script>
cmSetCurrencyCode("EUR");
</script>

Multi-Currency Support for IBM Digital Analytics Multisite

IBM Digital Analytics Multisite implementations should always set the 3-byte ANSI currency code in all pages which will send currency data with tags. The 3-byte code set on the page should match the currency type sent in tags from that page. This will ensure that collected currency values are converted properly for display in both the Multisite Analytics Global ID and the Multisite Analytics Site ID ("59990000|SITEID1"), in cases where these IDs are configured to report in different currencies.