Configuration

This page provides information about the configuration data set in the Displayable Content Export (DCE).

Example

The following is a generalized example. Your configurations will vary. Continue to the Fields section for information on each field.

{  
  "configs": {  
    "1234": {  
      "PRR": {  
        "additionalFields": {  
          "usage": {  
            "label": "How I use this product",  
            "valueOptions": {  
              "submission": "How I use this product",  
              "workbench": "How I use this product"  
            }  
          }  
        },  
        "contextDataDimensions": {  
          "Age": {  
            "label": "Age",  
            "valueOptions": {  
              "17orUnder": "17 or under",  
              "18to24": "18 to 24",  
              "25to34": "25 to 34",  
              "35to44": "35 to 44",  
              "45to54": "45 to 54",  
              "55to64": "55 to 64",  
              "65orOver": "65 or over",  
              "RatherNotSay": "I'd rather not say",  
              "submission": "How old are you?"  
            }  
          }  
        },  
        "ratingDimensions": {  
          "Quality": {  
            "label": null,  
            "valueOptions": {  
              "dimensionLabel1": "Quality of Product"  
            }  
          },  
          "ClothingFit": {  
            "label": null,  
            "valueOptions": {  
              "description": "Fit",  
              "dimensionLabel1": "runs small",  
              "dimensionLabel2": "runs large",  
              "valueLabel1": "too small",  
              "valueLabel2": "a little small",  
              "valueLabel3": "true to size",  
              "valueLabel4": "a little big",  
              "valueLabel5": "too big"  
            }  
          }  
        },  
        "tagDimensions": {  
          "BestUsesApparel": {  
            "label": "Best Uses - Apparel",  
            "valueOptions": {  
              "CasualWear": "Casual Wear",  
              "DateNightNightOut": "Date Night/Night Out",  
              "SpecialOccasions": "Special Occasions",  
              "WearToSchool": "Wear to School",  
              "WearToWork": "Wear To Work"  
            }  
          }  
        }  
      },  
      "QA": {...},  
      "CP": {...},  
      "SY": {...}  
    },  
    "1234-fr_ca": {...}  
  }  
}

Fields

Display code

{  
  "configs": {  
    "1234": {...}  
    "1234-fr_ca": {...}  
  }  
}

Display codes are used to group related configurations. All clients have a four or five digit default display code. For example, 1234 or 12345.

Display codes are used for localization. Localized display codes will have a locale appended to the default display code. A locale is a combination of a language code and a country code. In the following example, "fr" refers to the French language, and "ca" refers to Canada, 1234-fr_ca. The default display code is always used for en_us

Display codes are also used for special scenarios where the default configurations are not appropriate. For example, a client may need a set of configurations for a promotion or to accommodate a portion of their ecommerce site that is styled differently from the rest of their site. In these cases the display code will typically be the default code with additional characters appended to it. For example, 12345promo or 1234redes.


Content type

{  
    "configs": {  
      "1234": {  
        "PRR": {},  
        "CP": {},  
        "QA": {}  
      }  
    }  
  }

The type of Bazaarvoice content. Configurations can vary between Bazaarvoice content type. See the table below for the meaning of each acronym.

Configuration DCE Content type Acronym source
PRR Review Product Rating and Reviews
CP Author Consumer Profiles
QA Question Questions & Answers

Additional fields

"additionalFields": {  
  "usage": {  
    "label": "How I use this product",  
    "valueOptions": {  
      "submission": "How I use this product",  
      "workbench": "How I use this product"  
    }  
  }  
}

Additional fields accept free text. In your user interface you should display the label value along with the users response.

Example UI

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.


Context data values

"Age": {  
  "label": "Age",  
  "valueOptions": {  
    "17orUnder": "17 or under",  
    "18to24": "18 to 24",  
    "25to34": "25 to 34",  
    "35to44": "35 to 44",  
    "45to54": "45 to 54",  
    "55to64": "55 to 64",  
    "65orOver": "65 or over",  
    "RatherNotSay": "I'd rather not say",  
    "submission": "How old are you?"  
  }  
}

Context data values (CDV) are the answers to multi-select questions about the author. In your user interface you should display the label value along with the users response.

Example UI


Rating dimensions

Content authors can rate different aspects or dimensions of a product.

Normal

"ratingDimensions": {
"Quality": {
"label": null,
"valueOptions": {
"dimensionLabel1": "Quality of Product"
}
},

"Normal" rating dimensions operate on a traditional lowest to highest rating scale. In your user interface you should display the dimensionLabel1 value along with the users response.

Example UI

Slider

"ClothingFit": {  
    "label": null,  
    "valueOptions": {  
      "description": "Fit",  
      "dimensionLabel1": "runs small",  
      "dimensionLabel2": "runs large",  
      "valueLabel1": "too small",  
      "valueLabel2": "a little small",  
      "valueLabel3": "true to size",  
      "valueLabel4": "a little big",  
      "valueLabel5": "too big"  
    }  
  }  
},

"Slider" rating dimensions represent a continuum of value in which lower or higher do no represent worse or better. In your user interface you should include the description value along with the user's response, surrounded by dimensionLabel1 and dimensionLabel2.

Example UI


Tag dimensions

"tagDimensions": {  
  "BestUsesApparel": {  
    "label": "Best Uses - Apparel",  
    "valueOptions": {  
      "CasualWear": "Casual Wear",  
      "DateNightNightOut": "Date Night/Night Out",  
      "SpecialOccasions": "Special Occasions",  
      "WearToSchool": "Wear to School",  
      "WearToWork": "Wear To Work"  
    }  
  }  
}

Tag dimensions identify the different attributes of a product. They may be multi-select and/or free text input.

Example UI

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.