Configure integration field mapping
Field mapping controls how data from external platform forms (Meta or Google Ads) maps to lead fields in AI Lead Manager. Proper field mapping ensures that prospect information flows correctly into lead records when a lead is captured.
Before you begin
Permission: You must have access to the AI Lead Manager integrations area.
- You must have an active integration connection. See Connect Meta (Facebook) integration or Connect Google Ads integration.
- Platform forms must be synced before you can configure field mapping.
Steps
Map platform form fields to lead fields
- Navigate to Lead Management > AI Lead Manager > Platform Integration.
- Select the integration (Meta or Google Ads) you want to configure.
- Under the list of synced forms, select the form you want to map.
- The mapping page displays two columns:
- Platform fields -- The fields defined on your advertising platform's lead form (for example, "Full Name", "Email Address", "Phone Number").
- Lead fields -- The available target fields in AI Lead Manager (for example, Name, Email, Phone, Source, Type, Stage).
- For each platform field, select the corresponding lead field from the dropdown.
- Select Save to apply the mapping.
Mapping status
Each form tracks its mapping status:
| Status | Description |
|---|---|
| Unmapped | No platform fields have been mapped to lead fields. |
| Partially Mapped | Some platform fields have been mapped. Unmapped fields do not populate on captured leads. |
| Fully Mapped | All platform fields have been mapped to lead fields. |
Available target fields
Common target fields for mapping include:
| Lead field | Description |
|---|---|
| Name | The lead's full name |
| The lead's email address | |
| Phone | The lead's phone number |
| Stage | The initial pipeline stage for the lead |
| Source | The lead source |
| Type | The lead type classification |
| Priority | The lead priority level |
| Center | The center the lead is assigned to |
| Assignee | The team member assigned to follow up on the lead |
Set default field properties
After mapping fields, configure the default lead properties applied to every lead captured from this integration:
- From the integration details page, navigate to Field properties.
- Set default values for Lead stage, Source, Priority type, Lead type, Center, and Assignee.
- Select Save to apply the field properties.
These defaults are applied automatically to every lead captured from the integration, in addition to the field-to-field mappings configured above. The Assignee target field ensures every captured lead is assigned to a team member automatically.
Resync forms
If your platform forms have changed (new fields added, forms created or removed):
- Navigate to Lead Management > AI Lead Manager > Platform Integration and select the integration.
- Select Resync to refresh form and account data from the platform.
- Review any new forms and update field mappings as needed.