Create multilingual content with manual translation multilingual-manual

On this page: Learn how to create multilingual content with manual translation by configuring language settings and translating or importing content directly in your campaigns and journeys for each locale.

IMPORTANT
For manual flow, users need to be granted the Manage Language settings permission.

Using the manual flow, you can effortlessly translate your content directly in your campaigns and journeys, giving you precise control and customization options for your multilingual messages. Additionally, you can easily import pre-existing multilingual content with the Import HTML option.

Follow these steps to create multilingual content using manual translation:

Create language settings language-settings

In this section, you can set your different locales for managing your multilingual content. You can also choose the attribute that you want to use to look up information related to profile language

  1. From the Administration menu, access Channel > General settings.

  2. In the Language settings menu, click Create language settings.

  3. Type-in the name of your Language settings and choose Manual Translation.

  4. Select the Locales associated to this settings. You can add a maximum of 50 locales.

    If a Locale is missing, you can manually create it beforehand from the Translation menu or by API. Refer to Create a new Locale.

  5. Select a Fallback preferences to define a backup option for when a profile does not meet the necessary criteria for content delivery.

    Note that if no fallback option is selected, the campaign or journey will not be sent.

  6. Choose your sending preference from the following options:

    • Select profile language preference attributes
    • Create custom conditional rules
  7. If you select Select profile language preference attributes, choose the relevant attribute from the Profile language preference attributes menu to look up profile language information.

  8. If you select Create custom conditional rules, select the locale for which you want to create conditions. Then, build rules based on factors like user location, language preferences, or other contextual elements.

  9. Start creating conditions by adding an attribute, event, or audience to define your target group.

    note important
    IMPORTANT
    Contextual data is available exclusively for Web, In-App, Code-based Experience and Content cards channels. If used for Email, Mobile message, Push notification or Direct mail channels, without additional attributes, the campaign or journey will be sent in the language of the first option on the list.

    accordion
    Prerequisites to use contextual events in your conditions

    When users display your content, a personalization request is sent along with the experience event. To leverage contextual data in your conditions, you must attach additional data to the personalization request payload. To do this, you need to create a rule in Adobe Experience Platform Data Collection to specify: IF a personalization request is sent, THEN attach extra data to the request, defining the attribute to match with the language field in your schema.

    note
    NOTE
    These prerequisites are required for the In-app and Content cards channels only.
    1. In Adobe Experience Platform Data Collection, access the Rules menu and create a new rule. Detailed information on how to create rules is available in Adobe Experience Platform Data Collection documentation

    2. In the rule’s IF section, add an event configured as below:

      • Choose the Extension you are working with.
      • In the Event type field, select “AEP Request Event”.
      • In the right pane, select “XDM Event Type equals personalization.request”
      • Click the Keep changes button to confirm.
    3. In the rule’s THEN section, add an action configured as below:

      • Choose the Extension you are working with.

      • In the Action Type field, select “Attach Data”.

      • In the JSON payload section, make sure that the attribute used to retrieve the language to use (in the example below “language”) matches the name of the attribute specified in the schema where your data collection datastream is flowing into.

        code language-json
        
        {
            "xdm":{
                "application":{
                    "_dc":{
                        "language":"{%%Language%%}"
                    }
                }
            }
        }
        
      • Click the Keep changes button to confirm and save your rule.

  10. Once you have created a condition for a locale, you can reuse it for other locales instead of rebuilding it from scratch. Click Copy to… then select one or more target locales to apply the condition to.

    note
    NOTE
    Copying a condition overwrites any existing condition on the selected target locales.
  11. Drag and drop the locales to reorder them and manage their priority in the list.

  12. To delete a locale, click the bin icon.

  13. Click Submit to create your Language settings.

Note that after setting up your language preferences, you will no longer have the option to edit them.

To add a locale or change the conditions of an active Language settings, access and select Duplicate. This creates a copy of the existing setting that you can then edit.

Create a multilingual content create-multilingual-campaign

After setting up your multilingual content, you are ready to craft your campaign or journey and customize the content for each of your selected locales.

  1. Create and configure an email, mobile message, or push notification campaign or journey.

    note important
    IMPORTANT
    We recommend including only one translation project per journey.
  2. Create or import your original content and personalize it as needed.

    When the content is ready, click Save and return to the campaign configuration screen.

  3. From the Actions menu, select Add languages.

  4. Select the Language settings you created previously. Learn more

  5. From the drop-down menu, select the locale to associate with your existing content.

  6. In the Content menu, open the advanced settings of the Locales menu and select Copy to all locales.

    note
    NOTE
    This operation processes the full email payload and is subject to the same message content size guardrail as journey publication: a maximum of 2 MB, with a recommended size below 1 MB. For larger content, copy to fewer locales at a time.

  7. After the content is copied to the selected Locales, open each locale and click Edit email body to translate the content.

  8. To disable a locale, open its More action menu.

    note
    NOTE
    To re-enable a disabled locale, select Copy primary to all. This action copies content from the enabled primary variant to all locales, including disabled locales. Once the locale is re-enabled, translate the copied content as required.
  9. To deactivate the multilingual configuration, select Add languages from the Actions menu, then select the language to retain for your content.

  10. Click Review to activate to display a summary of the campaign.

    Review the summary for missing or incorrect settings and update the campaign as needed.

  11. Preview the multilingual content to verify how it renders in each language.

Your campaign or journey is now ready to activate. After messages are sent, use reports to measure the performance of your multilingual content.

IMPORTANT
If your campaign is subject to an approval policy, you will need to request approval in order to be able to send your multilingual campaign or journey. Learn more
recommendation-more-help
journey-optimizer-help