Trigger - Localization

Localization comes in two parts – invitation and survey. Before you start to localize the ForeSee SDK, you’ll needneed to localize your project. A localized project will contain different .proj folders for each locale, eg en.lproj/fr.lproj/. Once your project is localized, you’ll be ready to follow the steps below to add localized text to your invitation and survey.

Localizing Your Survey

To show different surveys for each locale, you will provide a different configuration file for each locale. To allow for language-based configurations, a copy of your foresee_configuration.json file must be placed in each of the language-sepcific folders mentioned above (ie. en.lproj/foresee_configuration.jsonfr.lproj/foresee_configuration.json) and added into your project.

In most cases, these configurations will be identical apart from the Survey ID (SID) you provide, which will each link to a different language version of the survey. Before you can provide surveys in different languages, you will need to ask us to create the surveys in the languages you require and link each to an SID for you.

Localizing Your Invitation

You can also customize the text in the default invitation by defining strings in the Localizable.strings file. You can also provide translations for different locales by adding a separate version of the file in each locale directory, eg en.lproj/Localizable.stringsfr.lproj/Localizable.strings. An example of this can be found in the ‘Internationalization’ sample that is included as part of the SDK.

Each invitation mode has its own strings to customize:

General Customizations (All Modes)

  • Survey header text (FSSurveyNavBarTitle)The title text on the survey header.
    Default: “Customer Satisfaction Survey”
  • Survey close button title (FSSurveyCloseButtonText)The title of the button used to exit the survey.
    Default: “Close”
  • Privacy Policy Link Text (FSInvitePrvacyPolicy)The text of the ForeSee privacy policy link.
    Default: “ForeSee Privacy Policy”

Immediate Invite Mode

  • Invitation title (FSInviteHeader)The title that appears on all invitations.
    Default: “We welcome your feedback
  • Invitation body (FSInviteBody)The text that appears beneath the title on the invitation.
    Default: “You have been selected to participate in a brief customer satisfaction survey to let us know how we can improve your experience.
  • Accept button text (FSInviteConfirmButton)The text on the positive button of all invitations.
    Default: “Yes, I’ll help
  • Decline button text (FSInviteCancelButton)The text on the negative button of all invitations.
    Default: “No, thanks

Contact Invite Mode

  • Invitation title (FSInviteTitle) The title that appears on all invitations.
    Default: “Thank you for helping!
  • Invitation body (FSContactInviteBody) The text that appears beneath the title in contact mode.
    Default: “Can we email or text you later a brief customer satisfaction survey so we can improve your mobile experience?
  • Accept button text (FSInviteAcceptButtonText) The text on the positive button of all invitations.
    Default: “Yes, I’ll help
  • Decline button text (FSInviteDeclineButtonText) The text on the negative button of all invitations.
    Default: “No, thanks
  • Contact dialog title (FSInviteHeader) The title that appears on the contact details dialog in contact mode.
    Default: “We’d welcome your feedback
  • Contact dialog body (FSContactDetailsBody) The text that appears on the contact details dialog in contact mode.
    Default: “Please provide your e-mail address or mobile number (US and CA only). After your visit you will be sent an e-mail/text message linking to the survey.
  • Contact details hint (FSContactDetailsHint) The text that appears in the contact details EditText field before the user has entered any text.
    Default: “email or mobile number
  • Empty input error message (FSContactDetailsEmptyInputError) The text that appears in red if the user does not enter anything into the contact details field.
    Default: “Enter a mobile number or email address
  • Incorrect input error message (FSContactDetailsInvalidInputError) The text that appears in red if the user enters invalid data into the contact details field.
    Default: “Format should be: name@domain.com or 123-456-7890
  • Contact form accept button text (FSContactDetailsAcceptButtonText) The text on the positive button of the contact details dialog in contact mode.
    Default: “Email/text me
  • Contact form decline button text (FSContactDetailsDeclineButtonText) The text on the negative button of the contact details dialog in contact mode.
    Default: “Cancel
  • Text message button (FSContactDetailsTextMessageNotificationButtonText) The text on the positive button of the contact details dialog when the user has entered a phone number.
    Default: “Text me
  • Email button (FSContactDetailsEmailNotificationButtonText) The text on the positive button of the contact details dialog when the user has entered an email address.
    Default: “Email me

Local Invite Mode

  • Local notification invite body (FSLocalNotificationInviteBody)The body of the invitation that appears in local invite mode.
    Default: “Can we contact you later with a brief customer satisfaction survey so we can improve your mobile experience?
  • Local notification body (FSLocalNotificationBody)The body of the local notification that appears after exiting the app in local invite mode.
    Default: “As promised, here is your <ABC Company> survey. Thank you for your input!
  • Accept button text (FSInviteConfirmButton)The text on the positive button of all invitations.
    Default: “Yes, I’ll help
  • Decline button text (FSInviteCancelButton)The text on the negative button of all invitations.
    Default: “No, thanks

Other articles in this section:

  1. Trigger Overview
  2. Invite Modes
  3. Repeat Days
  4. Sampling
  5. Multiple Measures
  6. CPP's
  7. Localization (current article)
  8. SDK Events
  9. Page views
  10. Custom Invites