Product Setup: Extra Fields

The Extra Fields tab allows you to create and manage additional fields for the selected product.

How To Add New Extra Field

Advanced Settings

Filters

API Documentation Settings

How To Add Preset Fields

Extra Fields in IVR

To access the Extra Fields, go to the System Management > Products section, click the “Settings” button in the “Actions” column for the selected product, and select the “Extra Fields” tab.

The “Extra Fields” tab contains the following information:

• Internal Name: The name of the field.
• Name In Reports: The name of the field that will be reflected in the reports and in the filter names.
• Field Protection: The type of the field protection to secure sensitive data sent in the field.

• Required: The status of the field requirement settings (Yes \ No)

• Description: Filter description.

• Format: The format example for the field.
• Example: The usage example for the field that will be displayed in the API documentation.
• Visible in API: Displaying the field in the API.

To add a field, click the “Add New Extra Field” button and fill in the following fields in the pop-up window:

• Type: Select the type of the field (New / Import).
  Note: You can import a JSON file with one or multiple extra fields.
• Internal Name: Enter the internal name of the field.
• Name In Reports: Enter the name of the field that will be reflected in the reports and the filter names.
• Validator: Select the type of field based on which data will be validated according to the set rules:
  • String: The field type for the string data input. Fill in the “Min line length” and “Max line length” to determine the accepted string length.
  • Array: The values validation will be based on the list of accepted values. Fill in the “Comma-separated list of valid arguments (ex.: option_1, option_2, option_3)” field to list all the values separated by commas.
  • Date: The field type for the date input. The validator checks if the date is valid. 
  • Date in the future: The field type for the future date input only. The validator checks if the future date is valid. If the provided date is earlier than the next date, the lead can not be sold.
  • Email: The field type for the email input.
  • IP: The field type for the IP address input. Select the preferable option (IPv4 + IPv6 / IPv4 / IPv6) from the “Available IP Address Format” drop-down list.
  • ZIP Code: The field type for the ZIP code input. Select the preferable option (ZIP Code / UK Post Code) from the “ZIP Code format” drop-down list. 
  • DOB: The date of birth input field. Select one of the available extra fields from the "Age field (DOB calculated)" drop-down list to record the calculated age according to the provided DOB value. 
    Note: The extra fields are available in the list only if they are not required and have an active status, the "Integer" field type, and the "Range" validator are selected.
  • Phone Number: The field type for the phone number input. Select the preferable option (Phone Number 7-13 digits / US Phone Number with Country Code / US Phone Number without Country Code / UK Phone Number with Country Code / UK Phone Number without Country Code) from the “Phone Number Format” drop-down list. 
  • State/Province: The field type for the State or Province input.

Click the “Create” button to finish.

Advanced Settings

Filters

Note: Filters are applicable exclusively during the Post phase in Ping-Post Products.

API Documentation Settings

Press the “API Documentation Settings” button and fill in the following fields to add the set of parameters to the API:

• Visible in API (optional): Select the preferable visibility option of the field in the API documentation (Not Visible / Visible). Note: The default configuration is set as “Visible”.

• Format for API: Add the format example for the field that will be displayed in the API documentation.
  Examples: Numeric only, 10-11 digits long; One of the following: [YES, NO]. 

• Example for API: Add the usage example for the field that will be displayed in the API documentation. Description for API: Add the description of the field that will be displayed in the API documentation.

To edit the field properties, click the “Edit” button.

To remove the field, click the “Delete” button.

Please note that you cannot create duplicates of existing parameters.

To export the Product extra fields in JSON format, click the “Export” button. Select the extra fields you would like to export from the drop-down list in the pop-up window.

Click the “Export” button to proceed.

Note: This feature can help you import the corresponding extra fields to other Products in your system.

Preset Fields

To add special service fields (Trusted Form URL, Jornaya Lead ID, I Claim Session Id) as extra fields for the Product, click the “Add Preset Field” button. Make a selection in the “Preset Field” pop-up window and click the “Add” button.

Please, note that preset fields are available only for custom products. Once the preset fields are added, they can not be edited or deleted. In case all available preset fields are added, the "No more preset fields available" pop-up window will be displayed.

 

Extra Fields in IVR

To configure the Extra Field to be used in IVR, go to the System Management > Products section, click the “Settings” button in the “Actions” column for the selected product, and select the “Extra Fields” tab.

Click the “IVR Configuration” button in the “Actions” column for the selected Product Extra Field to configure and use it in IVR.

Select one of the following IVR extra fields types from the “Type” drop-down menu:

• Range:

  • Digits: Set the minimum and the maximum number of characters accepted in this field (1 to 15). For example, this type can be used for the Year of Birth field or Vehicle Manufacturing Year field.

• Fixed:

  • Short SSN: Can be used for the 4-digit SSN field. All settings are predefined.

  • ZIP Code: Can be used for the ZIP code field. All settings are predefined.

• Date:

  • Day: Select a day in a month (1-31). All settings are predefined.

  • Full Date: Select a date in MMDDYYYY format (month, day, year). All settings are predefined.

  • Month: Month number (1-12). All settings are predefined.

  • My date: Select a date in the MMYYYY format (month, year). All settings are predefined.

  • Year: Select four digits for the year (from 1923). All settings are predefined.

• Selector:

  • Custom: Create custom options (press 0-9). At least two options should be created. For example, it can be used for Insurance types (1 - Auto, 2 - Life).

  • Gender: The Gender predefined selector (1 - Male, 2 - Female).

  • Score: The Credit Score predefined selector (1 - Excellent, 2 - Good, 3 - Fair, 4 - Poor).

  • Yes/No: The Yes/No predefined selector (1 - Yes, 2 - No).

• Status: Set the status defining if this field will be available in IVR (Active, Disabled).

Find the list of IVR blocks in which Extra Fields can be used in this Knowledge Base article.