Set up Apollo.io forms to capture UTM parameters and marketing attribution

Add fields to your embedded Apollo.io form so submissions include the visitor’s original marketing channel, campaign details, and landing page.
Attribution is broken

By the time an inbound lead reaches Apollo, the campaign that brought them to your website may be missing from the record. Visitors browse, leave, and return without the original UTMs in the URL. Unless you preserve that attribution, comparing which campaigns generate qualified leads becomes a reporting problem.

Madlitics captures the original marketing source, campaign details, and landing page, then passes that context into Apollo when the visitor converts. It also identifies sources such as organic search and referrals using available referrer data, so your reporting isn’t limited to tagged campaigns.

This guide walks you through setting up Madlitics with Apollo and checking that attribution reaches your lead records. You’ll configure the integration, run a test submission, and confirm the captured values before using them in your reporting.

Before you begin, install Madlitics on the website where you’ll embed your Apollo form. This guide covers forms built with Apollo’s Form Builder and embedded on your website.

Create a new form or open an existing one

Step 1:  Go to Forms and open an existing form built in Apollo’s Form Builder. To start from scratch, click Create form, then select Create new website form. Add the contact fields and questions you want visitors to complete.

In the form editor, drag a Short text field from the Inputs section onto your form. Click the new field to open its settings. In the next step, you’ll use Map to Apollo field to choose where Apollo stores the attribution value and Set as hidden to keep the field out of view.

‍

Open an existing Apollo form or select Create new website form

‍

Drag a Short text field onto your form

‍

Open the field settings to find Map to Apollo field and Set as hidden

Configure your Apollo form attribution fields

Step 2: Add seven fields to receive the marketing channel, campaign details, and landing page data captured by Madlitics. Each form field needs an Apollo custom field to store the value on the contact record and a URL query parameter to receive it.

Start with the Short text field you added in the previous step: 

  1. Open Map to Apollo field and select Add custom field.
  2. Enter Channel as the Field name, keep the Single-line text field type, and click Save custom field.
  3. Change the form field’s Label to Channel and turn on Set as hidden.
  4. Set URL query parameter to channel.
  5. Turn off both Auto-fill field and Hide field if known. Madlitics will supply the attribution value.

Add six more Short text fields (for each remaining Madlitics field) and repeat this setup for segment1, segment2, segment3, segment4, lp, and lpg.

‍

Open Map to Apollo field and select Add custom field

‍

Create a single-line text contact field named Channel

‍

Confirm the form field maps to Channel

‍

Set the label to Channel, hide the field, and enter channel as the URL query parameter.

‍

Check that Auto-fill field and Hide field if known are both off

‍

Repeat for all Madlitics fields, click Publish when complete

‍

Madlitics fields

Label

Mapping

Hidden

URL Parameter

Auto-fill

Captures

Channel

Channel

On

channel

Off

Original marketing channel

Segment 1

Segment 1

On

segment1

Off

Traffic source, including utm_source for tagged campaigns

Segment 2

Segment 2

On

segment2

Off

Campaign details, including utm_campaign for tagged campaigns

Segment 3

Segment 3

On

segment3

Off

Keyword or targeting detail from utm_term, when supplied

Segment 4

Segment 4

On

segment4

Off

Ad creative or content variation from utm_content, when supplied

Landing page

Landing page

On

lp

Off

URL of the page where the visitor first entered your site

Landing page group

Landing page group

On

lpg

Off

Reporting group for the original landing page

`

Label

Mapping

URL Param

Channel

Channel

channel

Segment 1

Segment 1

segment1

Segment 2

Segment 2

segment2

Segment 3

Segment 3

segment3

Segment 4

Segment 4

segment4

Landing page

Landing page

lp

Landing page group

Landing page group

lpg

Publish and embed your Apollo form

Step 3: Click Publish in the form editor and select Embed on site. Update Allowed domains as needed, then click Copy code.

Follow Apollo’s How to install instructions to add the snippet to your website. Click Publish in Apollo, then save and publish your website changes. Make sure Madlitics is installed on the website where the form will appear. Madlitics captures attribution on your website and passes it into the embedded form.

Use the embedded form for this setup. Apollo’s Share link option won’t receive the attribution Madlitics captures on your website.

‍

Select Embed on site, copy the embed code, and publish your Apollo form

View captured attribution in Apollo

Step 4: When a visitor submits your form, open the form’s Analytics tab and select Contacts to review the captured attribution. Open a contact record to see the mapped custom fields. If they aren’t visible, update/configure the fields displayed in the record.

These fields show the original marketing channel, campaign segments, landing page URL, and landing page group alongside the lead’s contact details. For campaign-tagged visits, the segments contain the source, campaign, term, and content values supplied through your UTMs. Available values depend on the traffic source and tags used.

View captured marketing channels and campaign segments under Analytics → Contacts

‍

View the attribution fields in the contact record and check the captured values.
Stacked bar chart showing lead generation by marketing channel over time, comparing sources like Paid Search, Paid Social, Organic Search, Direct, and Email. Helps visualize which channels drive the most traffic.
Line chart displaying lead-to-customer conversion rates by channel, comparing Google Ads, Facebook Ads, LinkedIn Ads, Organic Search, and Email. Shows how different sources drive qualified leads over time.
Line chart showing revenue performance by marketing campaign, comparing Google Ads, Facebook Ads, and LinkedIn Ads. Helps identify top-performing and underperforming campaigns.

Related articles

Connect Apollo.io form submissions to the campaigns that drove them

With Madlitics set up, your Apollo form submissions include the original marketing channel, available UTM values, and landing page alongside the lead’s contact details. Open the contact record to review those fields and compare which campaigns and landing pages bring in leads. For tagged campaigns, the segment fields show the source, campaign, term, and content values included in your UTMs.

If you sync Apollo contacts to a CRM, map the attribution fields there too. Combined with your CRM’s opportunity and revenue data, they help you see which sources bring in leads that become customers. A campaign that generates fewer submissions may still deserve more budget if those leads consistently turn into qualified opportunities and paying customers.

Frequently Asked Questions

Answers about setting up Apollo forms to capture Madlitics attribution data.