Skip to main content

Create a Data Specification

The first step as a Seller is capturing high quality data that is both structured and meaningful.

Define the shape of data using a Data Specification, which details the properties available including their data type, whether they are required, and any validation. You can think of a Data Specification as a blueprint for an instance of your data.

Via the App​

Navigate to https://app.bidzenith.com/dataspecifications and click Create. You'll be presented with a page in which to create your Data Specification

Create a Data Specification

  1. Provide a Name and Description for the Data Specification.

  2. Select the Culture for the Data Specification. The Culture determines the formatting for any dates, numbers, and currencies associated with the Data Specification or its properties.

  3. Select the Time Zone for the Data Specification. The Time Zone determines the origin time zone for any date or time related properties of the specification.

  4. Add properties to the Data Specification using the toolbar on the right hand side. You can choose from the following property types:

    • Name
    • Email
    • Address
    • Text
    • Integer numbers
    • Decimal numbers
    • Boolean
    • Date and Time, including Date Range and Time Range
    • Choice Lists, allowing Single or Multiple selections
    • Geo Location
    • IP Address

    All types are described here

  5. Provide a unique Name for each property type, and a Description to better describe what the property relates to.

  6. Select whether a value for each property is Provided as an input, or Calculated from other inputs.

  7. Select whether a value for a property is Required.

  8. Select whether a value for a property is queryable by Campaigns that will target the Data Specification.

  9. Select whether a value for a property is visible to all (PUBLIC) or visible only to the Data Specification owner and winning bidder (PRIVATE).

  10. Once all properties have been added to the Data Specification, click Submit to save it.

For more information, see Data Specifications.

Via the API​

You can also create a Data Specification through the API.