Syncing Variations With a Variation Feed

Variation feed allows you to automate the process of creating, editing, and removing variations. It is done by choosing a template, and connect it to a CSV or XML file with the variations metadata (images, titles, etc.). Whenever the file changes - the variations will change as well.

Step 1: Design Your Template

1. Create a template of the variations.
2. Turn into a variable every part of the template that you want to be populated by the variation feed. For example, if you want the image to be different for every variation, and the image URL is in the variation feed - the image src should be a variable.

Step 2: Prepare the File

The file can be a CSV or an XML file, that you can either upload to Dynamic Yield or host on your server. 

• Every row is a variation.
• Columns are the variables. For example, if you have 3 variables for the title, image URL and link - file must include at least 3 columns - for each one of the variables.
• File must have at least one column that will have a unique value. It can be an additional column (that is not used in any variable). This column will be used for the variation name.
• Avoid using spaces or special characters in the title. If there are special characters in the table, save the file in UTF8 format.
• Values must include less than 1,000 characters.

Example:

Step 3: Create a Variation Feed

1. Go to Assets › Data Feeds.
2. Click Add New and select Variation Feed.
3. Name the feed.
4. In the Feed Source, you can do one of the following:
   • Upload the file: After you will connect variations to the variation feed, they will update every time you replace the file.
   • Paste the URL that hosts the file: Whenever the file changes - the variations will change.
5. Under the Advanced Settings:
   1. If the feed source is a URL on your servers, choose the sync rate.
   2. Use a Parser Function to adapt and manipulate the feed source, to create a simple, flat table that will be the variation feed.
6. Click Preview. 
7. Choose a column with a unique value in the "Unique Key" settings.
8. Choose a column that will be served as the variation name in the "Variation Name Key". The variation name will later appear in the reports, so make sure it is descriptive to the variation content. 

• Click Save and Activate.

Step 4: Create Your Campaign

1. Create a campaign that will contain the experience with your variations.
2. When you create a new experience, under the Variation wizard step, click the "Syncing it with a Data Feed" button:
3. Select the template you created in Step 1.
   
4. In the template, select the variation feed you created in Step 3.
   
5. In the template, map the feed columns to the template variables. When you map, you will immediately see in the preview how the variation will look like if will be based on the first row of the feed.
   
6. Choose which variations to create.
   1. Decide how many (1-50) and which variation to create.
   2. You can also filter rows by a value in the feed.
      
7. Click Sync Variations. The variations are added to an experience in the campaign.
   
8. Click Save Experience and Save and Publish.
9. You can always click the "Sync Settings" to change the template, the variation feed, the mapping, or the filter.