Overview
The way in which localized guides are delivered to visitors for the Reseller Partner Program has not changed from Adopt v1 to Adopt v2. The substantive change is that now all localization settings changes made in the Partner's subscription affect all Adopt End User (AEU) subscriptions.
Whether leveraging Adopt v1 or v2, Partners will enable and configure localization on a per application basis. The difference in the two versions is in how the settings are shared between the Partner and their AEUs.
In Adopt v1, both the Partners and the AEUs accessed the settings from within the same subscription. In Adopt v2, each End User organization will have their own subscription so every time the Partner makes a change to any localization settings, the settings are synced to all AEUs.
For example, an AEU may use three applications of their Partner's product suite but require the guides be delivered in different languages for each application. To enable this behavior, the AEU would need to speak with their Partner and share the language requirements. After doing so, their Partner would enable localization for each application and add the specific languages needed.
Once localization is enabled and the languages are added to the application in the Partner's subscription, that information will be synced to the AEU subscription. After the sync is complete, the Localization tile will be visible for the AEU. This tile will include all available languages. The organization can change the authored language (2) if needed and export the XLIFF file for translations. After the file is translated into the desired language, find the desired language in the Untranslated section (1) and import the file. After translations are successfully imported for a given language, that language automatically appears in the Translated section where any updates to the translations for that language are imported.
Requirements
- Pendo Admin users can access and manage your Localization settings in Subscription Settings
Setup Localization Settings
Note: These steps only apply to Partner subscriptions.
1. Localization Settings are app specific. Go to Subscription Settings in the Settings menu and select an app.
2. Enable Localization in the Localization Settings tab. This shows the Localization Settings that are applied to all Guides in that app.
Language Preference Metadata
In order for the correct translation to be delivered with the guide, the Adopt end user must have access to the metadata field that determines the visitor's language. This means only those values that are marked as "Adopt Enabled" are allowed to be selected.
Pendo determines which language to serve visitors based on the Visitor’s local metadata. Use the default language metadata that Pendo collects from the Visitor's browser or set up a custom language metadata value in the Metadata tab. The metadata field name and values of that metadata are up to the Partner.
Select the language metadata value in the drop down menu.
Note: Pendo highly recommends that you use your own values for analytics accuracy but a visitor’s browser language metadata can be used if you don’t have another option.
Supported Guide Languages
1. Click on + Language to add all the languages you will need for Guide translations.
2. Select the language from the drop down menu. The list shows all available languages and the default metadata value collected by the browser for that language.
3. Change the metadata to match your custom language metadata value if necessary.
4. Click Add to save the new language. Repeat this process until you have added all of your languages.
Supported Languages
Supported Languages shows a list of all added languages. Hover over a language to show the Edit and Delete buttons.
Note: Supported languages cannot be deleted by a Partner's organization. Once a language is added by the Partner, it is automatically shared with all of their Adopt End Users. The Partner will not know which organizations have guides translated into which languages and could therefore break guide delivery for an organization if they delete a language currently in use.
Missing Translation Language Behavior
Missing Translation Language Behavior (1) controls if a visitor sees a Guide in the default language when their translated language is not available for that Guide. This could be because that language has not yet been translated or is not set up in your Pendo subscription.
Show Default Language if Translation is Missing (2) can’t be turned off in a Partner’s subscription. This setting will allow visitors to see guides in the default language if they have a language setting that doesn’t match any of the current translations. As these supported languages are controlled by the Partner, but the guide translations are controlled by the AEUs, Show Default Language if Translation is Missing can't be disabled in the Partner's subscription to avoid inadvertently disrupting guide delivery for their AEUs.
For example, a visitor may set their preferred language to Korean in their browser. However, the AEU does not translate their guides into Korean. With this setting enabled, the visitor will still receive guides as they will be displayed in the guide’s default language since the translation to Korean is missing.
Localization Tile
The localization tile can be accessed on the Guide Details and Resource Center Module Details page. Once localization has been enabled for an organization, and their Partner has added the requested languages, the AEU must import translations in the desired language (1). When the translations are successfully imported the language will appear in the Translated section. To learn more about localization, view this Localization article.