Field Management gives you full control over which fields are collected, validated, and displayed for each lead submission method across your system — including Form, Ping, and Post APIs.

Accessible from the top navigation bar, this tool manages system-wide fields like transaction_id, lead_id, first_name, email, phone, and many more.


Getting Started with Field Management

Step 1: Understand What Fields Are

Each field (like Email, Phone, or Zip Code) is a data point collected from your leads. You decide which fields are important and where they are required.


Step 2: Turn Fields On or Off

  • Toggle ON — Field is enabled and usable.
  • Toggle OFF — Field is not used in your campaign/API.

Step 3: Choose Where It’s Required

Choose field requirements at each stage of the lead flow:

Requirement OptionDescription
Form RequiredNeeded in the Form API (when user submits data via your funnel).
Ping RequiredNeeded in the Ping API (used for validation before full lead post).
Post RequiredNeeded in the Post API (after ping is approved, final data is sent).

Enable any combination based on your workflow.


Step 4: Show Field in Posting Specs

  • Posting Spec Switch → Enables field visibility in the source-facing API documentation.
  • Helps partners understand what fields they must pass for each API type.

Step 5: Set Validation Rules (Optional)

  • Acceptable Values – Define allowed values (e.g., only "yes" or "no").
  • Rejection Rules – Automatically reject leads that don’t meet defined criteria.

Step 6: Add Helpful Descriptions

Add a description to each field (e.g., “User’s primary phone number”) to help traffic sources understand what data to provide.


Step 7: Apply Changes Globally (Optional)

Use the Apply to All Sources option to apply your settings across every source instantly — avoiding repetitive setup.


Field Manager – Add Fields Guide

When you click “Add Fields”, a sidebar opens to help you configure your campaign’s data structure. It’s divided into sections:

System Fields

  • Core fields like email, phone, first_name, etc.
  • Common across all campaigns.
  • Automatically reusable.

Vertical Fields

  • Based on the campaign’s selected vertical (Debt Relief, Tax, Legal, etc.).
  • Only shows fields relevant to that vertical.

Custom Fields

  • Manually created for your campaign.
  • Useful for extra data points not covered by system/vertical fields (e.g., custom_code).

Other Vertical Sections

  • Add fields from other categories, even if not your primary vertical.
  • Expand and “Add Fields +” as needed.

Each field row includes:

FieldDescription
Field NameUser-friendly label (e.g., “Monthly Gross Income”)
ParameterSystem/internal key (e.g., monthly_gross_income)
Action“Add Fields +” to include

Don’t forget to Save Fields after changes.


Field Enablement – System-Wide Impact

1. Lead/Click/Call Routing

Path:
distribution → advertiser/customEndpoint → leadRouting / clickRouting / callRouting

  • Enabled fields appear in the Lead Fields section.
  • Shows label, parameter name, and input box for value.
  • Fields can be mapped manually or left empty.
  • New fields added appear at the bottom of the list.

2. Reporting Table Column Selector

  • Enabled fields appear in the “Table Columns” modal.
  • New fields default to toggle OFF.
  • Toggle ON to make field a visible column in reports.
  • Supports draggable ordering.
  • Populates table rows if lead data exists for the field.

Key Benefits of Field Management

Cleaner Data – Enforce formatting, validations, and requirements.
Faster Integrations – Clearly documented requirements for partners.
Better Control – Customize requirements per step and per campaign.
Clear API Specs – Accurate, auto-generated docs.
Time Savings – Apply globally across all sources.
Consistent Quality – Reduce junk data and increase conversion rates.
Smart Filtering – Only show fields relevant to selected verticals.
Organized UI – Find and add fields quickly by type.
Flexible Expansion – Add fields from other verticals when needed.
Form Precision – Keep lead forms clean by including only what’s needed.
Per-Campaign Customization – Tailor field setup uniquely for each campaign.