Experience programs migration
Feedback > Surveying > Experience Programs > Experience Programs Migration
The Experience programs migration tool migrates existing Medallia Experience Cloud configuration assets, such as Surveys, Fields, Auto Importers, and Emails to an Experience program. This tool consists of a series of steps to associate and organize the assets in Experience programs.
To launch the Experience programs migration, from Medallia Setup, navigate to Feedback > Surveying > Experience Programs, click Experience Programs Migration, and then Create new program in the Program List screen.
Watch this video for an end-to-end program migration example:
Identify the program
-
In a document, list all the programs that you ultimately want to see on your Experience Cloud instance as Experience programs. Typically, a good place to start is from the Admin Suite > Surveys > Surveys. Alternatively, navigate to the Condition String Relationships screen to get a condensed view of existing surveys.
-
Additionally, consider:
-
Fully imported programs, such as Digital and Conversations.
-
Combining separate surveys (for example, Personalized and Anonymous surveys) into the same program.
-
Installed Apps.
-
-
Align with your team and client that the list matches their expectations.
-
Map out the Condition strings that define each of the programs. To do so, consider the answers for these questions:
-
What combination of field values are unique to records within this program?
-
What combination of field values would not be possible for records within this program?
-
Do these combinations of field values correspond to Condition strings on my Email inviters, Email templates, Design rules, and Surveys?
-
-
Create a draft version of the Condition string per program to compare with the automated version produced by the Experience program migration tool.
Condition string relationships
Condition string relationships define the field dependencies of the Condition string you identified to migrate the program. By doing this, the Experience program migration tool recognizes which are the right configuration assets that needs to migrate.
Any condition strings underneath the parent condition string imply that the parent condition string is true. This is important to know the programs that share an asset conditioned on the parent condition string instead of the program condition string itself.
-
Enter comma-separated strings like
survey_type,record_type, programto more quickly find fields that should be used in the Condition string relationships. Click Matching fields. -
Check and edit the list of matching E-fields. Click Compute with AutoImporter or Compute with Slug if no Auto Importer is available.
-
Check the inferred Condition string relationships against the draft on the Identify the program step. These relationships are derived from field values in Auto Importers, Anonymous surveys, and from real field values on records in Experience Cloud. If the Experience program migration tool has inferred incorrect relationships or missed some, manually edit them on the text box. Note that each condition string implies that all the parent condition string are always
true. For example:e_record_type = 'B2B' e_survey_program = 'B2B Relationship' e_survey_program = 'B2B Onboarding'e_record_type = 'B2B'is alwaystrueif eithere_survey_program = 'B2B Relationship'ORe_survey_program = 'B2B Onboarding'istrue. Additionally, sibling conditions strings — condition strings under the same parent condition and at the same level — cannot be bothtrue. For example, ife_survey_program = 'B2B Relationship'istruethene_survey_program = 'B2B Onboarding'isfalse. -
When the Condition string relationships are accurate, click Save. The Condition string relationships can be only be saved once, but you may need to make small edits to it if you see more or less items for a given asset (for example, extra survey email). Click View changelog to see the lists of changes for that field dependency. See Change Log for more information.Tip: If you have issues saving the Condition string relationships, try to save it from Condition String Relationships screen you can access at the top navigation.
Program name and Condition string
After identifying the Condition string relationships:
-
Enter the name the Experience program will have in Admin Suite.
-
Enter the Condition string. You can select the Feedback fields (E-fields) the Experience program migration tool has detected. Click the condition value (of Enum Content Kind) to write the condition. Note that the options available come from Survey conditions tab in the Condition String Relationship screen.Tip: Surveys are not always a direct mapping to programs: some programs have no surveys at all (such as Digital or other completed records we import) whereas some programs may have two or more surveys (pilot builds, A/B tests, etc.). However, the list of surveys is usually the best starting point when designing which programs your instance should have.
Program fields and Profile settings
Program fields and Profile Settings associates fields to your program and configures settings for profiles. Field associations pre-filter field selectors based on a program, and are required for profiles and other future features. This automatically pulls fields from Surveys, Auto Importers, and Case Forms. Use the following procedure to configure program fields and profile settings.
-
If a Case form on your instance contains fields you want available to your profiles and associated to your program, select a form in the Case Forms dropdown.
-
Click Check Condition. Experience Cloud processes your condition, and populates the form with the Auto Importers and surveys that match your condition, with all selected by default. For example:
-
Unselect any Auto Importers and surveys you do not need. For example, in the image above you might unselect the Test Auto Importer.Tip: Click on Missing AIs? and Missing Surveys? to get the full details of the Auto Importers and surveys conditions.
-
Click Load Fields. Experience Cloud generates a list of the fields available to be used in contacts, events, and feedback schemas. All fields are listed in one of the following tables:
-
Event and Feedback fields — The E-fields and Q-fields from the Auto Importers, Surveys, and Case Form you selected. These fields contain data and, when mapped to Contact fields, provide the information displayed in profiles.
-
Contact fields — The fields available to be used in Customer Profiles. This table always includes the following five fields, which begin unmapped: External Customer ID, Email, First Name, Last Name, and Phone.
Note: By default, Experience Cloud categorizes survey fields as Feedback fields, and Auto Importer fields as Event fields. You can change this categorization by changing the Type value of specific fields, as described later in this procedure. -
-
The Event and Feedback fields table does not include K-fields. To add one or more K-fields to the list:
-
Click Add K-fields.
-
Select the K-fields you want to add.
-
Click Add/Remove selected.
Important: The Experience program migration tool only displays K-fields with calculations that use fields already loaded to the Experience program schema. -
-
To change the Type value of Event and Feedback fields, double-click that field's Type value, and then select a new value.
-
For Contact fields to display data in profiles, they must be mapped to fields in the Event and Feedback fields table:
-
In the Event and Feedback fields table, locate the field you want to map to a contact field. Click Search to make location easier by adding search fields to the top of each column.
-
In the Type column, click the small arrow to open the Map to Contacts dialog. For example:
-
Either select an Existing Field in the Contact fields table for the mapping, or select New Field to create a new row in the Contact fields table, mapped to this Event or Feedback field. For example, the following image shows the Map to Contacts dialog, with the
e_emailEvent field mapped to the Email contact field: -
Click Map. Repeat these steps until your Contact Fields table has all of the mappings needed by your profiles.
-
Optionally for any Contact field, change the values for IsPii (which marks the field as personally-identifying information), IsIdentity (which marks the field as identifying information), and IsIndexed (to mark the field for indexing).Restriction: Mark no more than five fields as IsIndexed.Warning: After you create a schema with a field marked as identifying information, you cannot remove that field.Important: As of iOS15, Apple devices obfuscate the user’s IP address when using the Mail app. If the only customer identifier (IsIdentity) configured in the schema is for the customer email address, multiple profiles might be created for the same user. To avoid this, always configure at least one other identifier besides email address.
-
- By default, all of the fields in the Event and Feedback fields table have an Action value of Add, making them available to profile administrators in Admin Suite. If you want to remove fields from being available, double-click the Action value for those fields and change the value to Ignore.
- At the bottom of the screen add an Event, which is available to users as a filter in the Contact Timeline module, and determines the sort order of events.
- Enter an Event Name.
- Select an Event Type.
- Select an Event Timestamp. The field you select must have a value for every record in the program, or the event will not appear in the Contact Timeline.
- At the bottom of the screen add a Feedback configuration, which defines the field used as the main score field in a profile, and is displayed next to each piece of feedback on the Contact Timeline.
- Enter the Program Name you want displayed on the Contact Timeline.
- Select a Feedback Main Score.
If the dropdown does not list the field you want, turn on Show All Fields and try again.
- At the bottom of the screen add a Backfill rule, which defines which historical survey records should be used for this Experience program.
- Enter a Name for the rule.
- Enter a Priority.
- Enter a Condition for applying a backfill to this program.
- Turn on the Active property.
-
Click Update backfill if making any changes of the Backfill condition.
Important: This creates only a Backfill rule, and does not actually begin a Backfill process. -
Optionally, click Export to download the program JSON file or Import to upload a JSON file of the program schema,
-
Before proceeding, verify that you have completed all of the following tasks:
-
Map all contact fields (unmapped fields are grayed out), and verify the isPii, isIdentity, and isIndexed settings for all Contact fields.
- Categorize all event and feedback fields correctly.
- Mark as Ignore any event and feedback fields that should be unavailable in customer profiles.
- Add all necessary K-fields.
- Configure the Event area, especially the Event Name and Event Timestamp.
- Configure the Feedback area.
- Configure a Backfill Rule.
-
-
On the production instance, grant the appropriate permissions to the roles that will use Customer profiles:
-
On the Company > Users > Roles > Roles screen, for any role that will view customer profiles, move the View Invitation Management capability to the right-side box of the MemberCaps property. This is required for users to see non-responded records in the Contact Timeline.
-
For roles that will create Customer profiles in Admin Suite, assign the Manage Reports and Controls administrative permission, as described in Reports and Preferences. This permission works only for users' primary role.
-
Confirm associations
Confirm associations step reviews that the Experience migration tool has correctly associated each asset (Surveys, Auto Importers, Design rules, Emails, Email inviters, Alerts, Rapid Response emails, Locales and Languages preferences, Omni Exporters) to migrate them into an Experience program. Each confirmation step shows a table listing the assets the tool has associated to. For example, Confirm Association of Legacy Alerts shows a table with the Alerts associated to Condition string defined in the Program name and Condition step:
Click Missing ...? to see the full details of the asset conditions.
If any asset is missing or was erroneously included, go back Condition string relationships or Program name and Condition string to adjust either the Condition String relationship or the Condition string.
Tag assets
Tag assets labels the configuration assets and shows which ones will be migrated as Experience programs in Admin Suite. Review all the assets confirmed during the Confirm associations step and click Tag assets to finish the migration process.
Manage migrated Experience programs
-
Editor — Edits the details of the Experience programs migration steps, for example adding new rows to the Contact Fields table, or changing existing mappings. Note that this impacts the Admin Suite Experience program configuration.Important: Updating an Experience program creates a new schema, but only requires a new Backfill if you added new Contact fields and you need historical data displayed for those fields. Because backfills can require much time to complete for big companies (days to months in extreme cases), run a backfill only once.
-
Delete — Deletes the migrated program from both the Program list screen and Admin Suite Experience programs.Warning: For safety purposes, avoid deleting migrated Experience programs on production instances.
-
Copy data — Copies the migrated program data to another instance, such as a sandbox. This is useful for testing the configuration on a sandbox instance.
-
On the Program List screen on your sandbox, click Copy data.
-
In the dialog box, enter the URL of your production instance, including the Experience Cloud version of the URL and the company name. For example:
-
Click Copy.
-
If prompted, sign in to the production instance.
-
After authenticating as a user on the production instance, 500 survey records are transferred to the sandbox. When that transfer is complete, click the provided link to return to the sandbox.
-
Run a backfill process on the sandbox instance, as described in Backfill.
-
