Skip to main content

Language and Region

Purpose of this document

This document provides business, technical (including configuration), and implementation details for specific features within the ES Loyalty feature set. This document specifically addresses a subset of functionality centred on language and localization features.

Multi-language/localization

Offer output

Localization is the ability to support multiple languages in the platform, specifically for configurable offer output. The intent is to provide localization options for both loyalty program members (in the offers they receive, receipt messaging, and so on) and Console or Reports users.

For members:

  • Language settings options in a website or web application presenting loyalty program offers or other content generated by Exchange Solutions.
  • Messages and information provided by supporting systems available in all supported languages.
  • Program communications based on the member's language preferences.
  • Storage of language preferences between sessions, with OS language preferences used for first-time access.

For Console and Reports users:

  • Member Admin Console and Promo Console available in all supported languages.
  • Reports available in all supported languages.
  • Console allows text to be entered in supported languages and allows language-specific content to be entered for creative elements.

TBA


Localization is the ability to support multiple languages in the platform, specifically for configurable banner output.

The reasons for supporting this feature include:

  1. Compliance with legislation requirements -- Particularly for a mandated language in a localized area, such as French in Quebec.
  2. Customer engagement -- Engaging with customers in the language they're most comfortable with.
  3. Competitive necessity -- Many competitors already offer these capabilities.

For clients, the Console allows multiple languages (by configuration) to be entered for creative elements.

Users can edit banner copy for non-expired banner states (Live, Disabled, Inactive, Future).

Additional languages appear in the Banner Preview modal when an additional language is selected from the dropdown. The Duplicate functionality also carries over secondary language copy creative. When a draft is saved, secondary language copy, if present, is persisted for later editing. When Save and Publish is clicked, the secondary language copy is persisted and flows to the appropriate data store.

When exporting the banner view to CSV files, the additional language copy for a banner is included in the export. The client's developer can retrieve banner offers in the language required for display in a loyalty app or web front end.

PRD -- Banner_Localization.docx


ES Console and reporting

Supports multiple languages within the Console for program managers and reporting consumers.

Multilingual ES Console and ES Loyalty PRD -- Multilingual ES Console & ES Loyalty.docx

When exporting the banner view to CSV files, the additional language copy for a banner is included in the export. The client's developer can retrieve banner offers in the language required for display in a loyalty app or web front end.

For instance, multiple language options are available when setting up the Copy and Creative section in creating a new offer.


Receipt messaging

Supports multiple languages in the platform, specifically for receipt configuration output. Provides a message in any supported language on the member's receipt for a transaction.

Provides messages in multiple languages on transaction receipts. The parameters for localization are set in the related configuration file:

{
"audit": {
"created": { ... },
"updated": { ... },
"version": 1
},
"Category": "LOCALIZATION",
"ConfigDetails": {
"Description": "Specifies the list of locales we support.",
"Enabled": true,
"Locale": [{ "en-CA": "English (CA)" }, { "fr-CA": "French (CA)" }],
"DefaultLocale": "en-CA"
},
"ConfigType": "LOCALIZATION"
}

This LOCALIZATION config is shared by both receipt messages and prompt messages. Depending on whether localization is enabled or disabled, the Locale and DefaultLocale values are used to populate the data.

Receipt and Prompt Messaging -- Receipt and Prompt Messages - ES Loyalty - Confluence


Prompts

Supports English, French, and other languages in the POS systems with which ES Loyalty is integrated, for POS prompts. These prompts may be displayed to a POS terminal operator or to the member.

Multilingual ES Console and ES Loyalty PRD -- Multilingual ES Console & ES Loyalty.docx


Canadian address (member profile, store address)

Enables Canadian address information within member profiles and store data, including associated features such as targeting based on member geography.

Ability to present Canadian address details -- specifically, the province with its relevant two-letter code and the postal code in the correct format -- in various parts of the product, including API calls, feeds, and the Console.


American address (member profile, store address)

Enables American address information within member profiles and store data, including associated features such as targeting based on member geography.

Ability to present American address details -- specifically, the state with its relevant two-letter code and the ZIP code in the correct format (including extensions) -- in various parts of the product, including API calls, feeds, and the Console.