Docs > Defining trials by CSV

This page describes how to define your experiment's trials using a simple CSV.

  • Columns

    CSV is the easiest way to define the various trials of your experiment. Regardless of how you design your experiment (via the Builder tool or JSON), you can upload a Trial CSV.

    The file should contain the following 4 column headings. Each subsequent row in the file denotes a value assigned to one of the layers for a trial / condition.

    Trial

    The name of the trial.

    Condition

    The name of the trial's condition.

    Layer

    The name of a layer in your experiment.

    Value

    For image & audio layers, the value should be the name of the asset that should be displayed. For text layers, the value should be the actual text to display.

  • Formatting

    Columns in the file should be comma separated.

    The escape character is the double-quote ".

    Values with special characters such as new lines or double-quotes should be enclosed by double-quotes. See the sample file for an example.

  • Sample

    The sample CSV defines the assets for two trials, each with two conditions.