Localization

Localization comes in two parts - invitation and survey. Before you start to localize the ForeSee® SDK, you need to localize your project. A localized project contains different .proj folders for each locale, e.g., en.lproj/, fr.lproj/. Once your project is localized, you are 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 must 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-specific folders mentioned above (e.g., en.lproj/foresee_configuration.json, fr.lproj/foresee_configuration.json) and added into your project.

In most cases, these configurations are identical apart from the unique Survey ID (SID) you provide. Each SID links to a specific language version of the survey. Before you can provide surveys in different languages, you must inform us so we can create the surveys in the languages you require and link each to the corresponding SID for you.

Localizing Your Invitation

You can customize the text in the default invitation by defining strings in a Localizable.strings file. You can also provide translations for different locales by adding a separate version of the file in each locale directory, e.g., en.lproj/Localizable.strings, fr.lproj/Localizable.strings. An example of this can be found in our 'Internationalization' sample.

Keys generally indicate which screens and invitation modes the string appears on. The following keys are defined:

FORESEE_Invite_Contact_EmailPage_EmailHint
Default: Enter your email...

FORESEE_Invite_Contact_EmailPage_EmailType
Default: YOUR EMAIL

FORESEE_Invite_Contact_EmailPage_EmptyEmailError
Default: Enter an email address

FORESEE_Invite_Contact_EmailPage_InvalidEmailInputError
Default: Your email is invalid. Format should be: [email protected]

FORESEE_Invite_Contact_EmailPage_Submit
Default: Submit

FORESEE_Invite_Contact_InvitePage_Body
Default: Can we send you a brief survey so we can improve your experience in this app?

FORESEE_Invite_Contact_EmailOnlyInvitePage_Body
Default: Can we send you a brief survey via email so we can improve your experience in this app?

FORESEE_Invite_Contact_InvitePage_EmailMeSurvey
Default: Email me a survey

FORESEE_Invite_Contact_InvitePage_TextMeSurvey
Default: Text me a survey

FORESEE_Invite_Contact_InvitePage_Title
Default: We want your feedback!

FORESEE_Invite_Contact_TextPage_EmptyPhoneNumberError
Default: Enter a mobile number

FORESEE_Invite_Contact_TextPage_InvalidPhoneNumberInputError
Default: Your phone number is invalid. Format should be: 123-456-7890

FORESEE_Invite_Contact_TextPage_MessageDataRatesWarning
Default (Android): Providing your number means you are participating in a ForeSee survey for %s. Message & data rates may apply. 2 messages per survey.
Default (iOS): Providing your number means you are participating in a ForeSee survey for %@. Message & data rates may apply. 2 messages per survey.

FORESEE_Invite_Contact_TextPage_SMSDisclosuresLinkText
Default: SMS Disclosures

FORESEE_Invite_Contact_TextPage_Submit
Default: Submit

FORESEE_Invite_Contact_TextPage_TextHint
Default: Enter your phone number...

FORESEE_Invite_Contact_TextPage_TextType
Default: YOUR MOBILE NUMBER

FORESEE_Invite_ExitSurvey_AcceptButton
Default: Yes Please

FORESEE_Invite_ExitSurvey_DeclineButton
Default: Maybe Next Time

FORESEE_Invite_ExitSurvey_InvitePage_Body
Default: Can we send you a brief survey so we can improve your experience in this app?

FORESEE_Invite_ExitSurvey_InvitePage_Title
Default: We want your feedback!

FORESEE_Invite_InSession_AcceptButton
Default: Yes Please

FORESEE_Invite_InSession_DeclineButton
Default: Maybe Next Time

FORESEE_Invite_InSession_InvitePage_Body
Default: Can we send you a brief survey so we can improve your experience in this app?

FORESEE_Invite_InSession_InvitePage_Title
Default: We want your feedback!

FORESEE_Invite_ThankYouPage_CloseThisWindow
Default: Close this window

FORESEE_Invite_ThankYouPage_ReachOut
Default: We’ll reach out to you after you finish on our app.

FORESEE_Invite_ThankYouPage_ReturnToApp
Default (Android): Returning to %s in %d...
Default (iOS): Returning to %@ in %ld...

FORESEE_Invite_ThankYouPage_ThankYou
Default: Thank You!

FORESEE_Misc_AppName
Default: [PLACEHOLDER]

FORESEE_Misc_Attribution
Default: Powered by ForeSee

FORESEE_Misc_ErrorDialogButton
Default: OK

FORESEE_Misc_ErrorDialogTitle
Default: Error

FORESEE_Misc_PrivacyPolicy
Default: Privacy Policy

FORESEE_Misc_ProgressMessage
Default: Please wait

FORESEE_Misc_WebLoadURLNotSupportedMessage
Default: Couldn't load page. URLs of this type are not supported.

FORESEE_Misc_WebLoadURLNotWhitelistedErrorMessage
Default: Couldn't load page. Only whitelisted domains are permitted.

FORESEE_Notification_Invite_BigText
Default: You have been selected to participate in a brief customer satisfaction survey to let us know how we can improve your experience.

FORESEE_Notification_Invite_Text
Default: You have been selected to participate in a brief customer satisfaction survey to let us know how we can improve your experience.

FORESEE_Notification_Invite_Title
Default: We'd welcome your feedback

FORESEE_Notification_NotificationChannelDescription
Default: ForeSee Survey Notifications

FORESEE_Notification_NotificationChannelName
Default: Survey notifications

FORESEE_Notification_Survey_InviteText
Default: Can we send you a brief survey so we can improve your experience in this app?

FORESEE_Notification_Survey_LinkBigText
Default (Android): As promised, here is your %s survey. Thank you for your input!
Default (iOS): As promised, here is your %@ survey. Thank you for your input!

FORESEE_Notification_Survey_LinkText
Default (Android): As promised, here is your %s survey. Thank you for your input!
Default (iOS): As promised, here is your %@ survey. Thank you for your input!

FORESEE_Notification_Survey_LinkTitle
Default (Android): %s survey
Default (iOS): %@ survey

FORESEE_Survey_CloseButtonText
Default: Close

FORESEE_Survey_LoadErrorMessage
Default: Due to a technical connection issue we are unable to provide you with a survey at this time. Thank you for your time and interest

FORESEE_Survey_LoadErrorTitle
Default: Sorry

FORESEE_Survey_NavBarTitle
Default: Customer Satisfaction Survey

FORESEE_Survey_RequestNotSentErrorMessage
Default: Due to a technical connection issue we are unable to complete the survey at this time. Thank you for your time and interest.

FORESEE_Survey_RequestNotSentErrorTitle
Default: Sorry

FORESEE_WebLoadErrorMessage
Default: We couldn't load the page at this time. There could be a problem with your connectivity.

FORESEE_WebLoadErrorTitle
Default: Sorry