Trigger - Localization

To localize your survey and invitation, you will need to add locale-specific folders for each supported language. Localizations for the ForeSee SDK will usually be stored in the res/values and res/raw folders. You will therefore need to add suffixed folders for each language, eg. res/values-fr for french and res/raw-es for spanish, as well as having a ‘base’ folder (res/raw, res/values) for unsupported languages. Once these are in place, you will be ready to begin localization.

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. res/raw-fr/foresee_configuration.json,  res/raw-es/foresee_configuration.json), as well as a base configuration (res/raw/foresee_configuration.json).

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 customize the text in the default invitation by defining strings in the res/values/strings.xml file. Each invite mode has it’s own strings to customize. Localizations are included with the SDK for European French, French Canadian, European Spanish, American Spanish, European Portuguese, Brazilian Portuguese and German. To localize the text for other languages, use the res folder suffixes mentioned above (eg res/values-tr/strings.xml for Turkish localization) as well as a base configuration (res/values/strings.xml) if you intend to alter the default english invite text.

Note
Strings configured in each language’s strings.xml file is applied based on
the language setting of the operating system. If you choose to set the
language of their app in another way, these localizations are ignored.

General Customizations (All Modes)

  • Invitation title (FORESEE.inviteTitle)The title that appears on the invitation.
    Default: “We’d welcome your feedback
  • Accept button text (FORESEE.inviteAcceptButtonText)The text on the positive button of the invitation.
    Default: “Yes, I’ll help
  • Decline button text (FORESEE.declineButtonText)The text on the negative button of the invitation.
    Default: “No, thanks
  • Attribution text (FORESEE.attributionText)The text for the survey attribution string below the body text.
    Default: “Conducted by ForeSee
  • Privacy policy link text (FORESEE.privacyPolicyLinkText)The text of the ForeSee privacy policy link.
    Default: “Privacy Policy

Immediate Invite Mode

  • Invitation body (FORESEE.inSessionInviteBody)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.

Contact Invite Mode

  • Invitation body (FORESEE.contactInviteBody)The text that appears beneath the title in the contact invitation mode.
    Default: “Can we email or text you later a brief customer satisfaction survey so we can improve your mobile experience?
  • Contact dialog title (FORESEE.contactDetailsTitle)The title that appears on the contact details dialog in the contact invitation mode.
    Default: “Thank you for helping!
  • Contact dialog body (FORESEE.contactDetailsBody)The text that appears on the contact details dialog in the contact invitation 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.
  • Accept button text (FORESEE.contactDetailsAcceptButtonText)The text on the positive button of the contact details dialog in the contact invitation mode.
    Default: “Email/text me
  • Decline button text (FORESEE.contactDetailsDeclineButtonText)The text on the positive button of the contact details dialog in the contact invitation mode.
    Default: “Cancel
  • Contact details hint (FORESEE.contactDetailsHint)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 (FORESEE.contactDetailsEmptyInputError)The text that appears if the user does not enter anything into the contact details field.
    Default: “Enter a mobile number or email address
  • Incorrect input error message (FORESEE.contactDetailsInvalidInputError)The text that appears if the user enters invalid data into the contact details field.
    Default: “Format should be: name@domain.com or 123-456-7890
  • Text message button (FORESEE.contactDetailsTextMessageNotificationButtonText)The text on the positive button of the contact details dialog when the user has entered a phone number.
    Default: “Text me
  • Email button (FORESEE.contactDetailsEmailNotificationButtonText)The text on the positive button of the contact details dialog when the user has entered an email address.
    Default: “Email me
  • Progress text (FORESEE.progressMessage)The text on the progress indicator that appears after the user has entered an email address.
    Default: “Please wait

ExitSurvey Invite Mode

  • Local notification invite body (FORESEE.localNotificationSurveyInviteText)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 title (FORESEE.localNotificationSurveyLinkTitle)The title of the local notification that appears after exiting the app in ExitSurvey invite mode.
    Default: “ABC Company survey
  • Local notification body (FORESEE.localNotificationSurveyLinkText)The body of the local notification that appears after exiting the app in ExitSurvey invite mode.
    Default: “As promised, here is your ABC Company survey. Thank you for your input!
  • Local notification body (large) (FORESEE.localNotificationSurveyLinkTextBigText)An optional larger body for the local notification that appears after exiting the app in ExitSurvey invite mode. This text will only be visible after expanding the notification.
    Default: “As promised, here is your ABC Company survey. Thank you for your input!

ExitInvite Invite Mode

  • Local notification title (FORESEE.localNotificationInviteTitle)The title of the local notification that appears after exiting the app in ExitInvite mode.
    Default: “We’d welcome your feedback
  • Local notification body (FORESEE.localNotificationInviteText)The body of the local notification that appears after exiting the app in ExitInvite invite mode.
    Default: “You have been selected to participate in a brief customer satisfaction survey to let us know how we can improve your experience.
  • Local notification body (large) (FORESEE.localNotificationInviteBigText)An optional larger body for the local notification that appears after exiting the app in ExitInvite invite mode. This text will only be visible after expanding the notification.
    Default: “You have been selected to participate in a brief customer satisfaction survey to let us know how we can improve your experience.

Other articles in this section:

  1. Trigger Overview
  2. Invite Modes
  3. Invitation API
  4. Page Views
  5. Repeat Days
  6. Sampling
  7. Multiple Measures
  8. CPP's
  9. Localization (current article)