Lookup tables for key-value data

You can upload lookup tables to your Ion console to manage and leverage key-value data. Combine a lookup table with a server scriptlet, and you have a powerful feature you can use to optimize your creatives.

Lookup tables are comprised of a key column with a corresponding column of values. The key can be a piece of respondent data collected on your form, a query string parameter or an Ion core field. The value would be that to which corresponds to the key.

By looking up a value based on a key, you can serve-up targeted content and control the way respondents navigate through your creative along with a whole suite of actions you can take "behind the scenes."

Here are just a few examples of what lookup tables combined with server scriptlets can accomplish:

  • Check to see if the respondent's location is considered serviceable by your business.
  • Map the respondent's location to a specific sales representative.
  • Display content based on a form selection, query string parameter or core field.
  • Send conditional notifications and email templates.

Once you have outlined what you intend to accomplish, the first step is to create your lookup table file. You may have the ability to do this programmatically or it could be something you can accomplish by hand. Either way, the result should be a two column .csv file. Column A will consist  of your keys and column B will consist of the corresponding values.

If you're creating a short, simple lookup table, you can skip creating the .csv file, and enter the lookup table content manually, right within your console. Here are the steps to take to add your lookup table to your ion console: 

  1. Click Data Management in your console’s side nav and select Lookup Tables
  2. Click on the green “New lookup table” button then add a title and optional description.
  3. Click the Lookup Table Actions dropdown menu and then import your properly formatted .csv file by clicking on the Import Entries link. *You’ll be able to view a sample of the proper format here.
  4. Or, add entries individually by clicking on the green “New entry” button.

You also have the ability to automatically transfer lookup table content to Ion via a PUT request. This advanced functionality requires a posting mechanism to deliver content to the lookup table and working closing with the team here at ion to bring this functionality to fruition. Please contact your customer success manager if you intend to take this route.

Once the lookup table has been uploaded or added to your ion console, you'll use a server scriptlet to lookup a value based on the key. The following function is used to accomplish the lookup:

actionLookupValue("lookup table label", "entry name");

Once you've used the function above to "grab" the value from the lookup table, you can use the scriptlet to execute subsequent actions. For example, you may simply return the value from the lookup table and dynamically insert this into your creative. Or, you could return a response code value and use this as your rule condition on your creative(s).

There are many ways you can leverage a lookup table in your ion console, so please feel free to reach out to the Support Team with any questions you might have.