Skip to content

Lead forms

Pingado records a lead when a visitor submits a form with an email field on your site. It skips:

  • forms with a password field, such as log-in forms
  • search forms (role="search")
  • forms with the data-pingado-ignore attribute

Pingado records every lead. Each person’s first lead goes to your connected ad accounts and counts as a new lead in your reports; a later one, such as the same person signing up for the newsletter again or on another device, is recorded only. A lead without an email (a Google sign-up, say) counts too. The email is hashed in the browser before it is sent.

Which forms tell Pingado who the visitor is

Section titled “Which forms tell Pingado who the visitor is”

Pingado reads an email, phone number and name only from forms where visitors enter their own details:

  • sign-up and log-in forms (forms with a password field); these are not leads
  • the forms that count as leads

An email from any other form stays in the visitor’s browser and is never sent. If the visitor becomes a lead in the same visit (within 30 minutes), for example on a sign-up success page, the lead uses that email. Otherwise it is discarded. Once a visitor is a lead, other forms are not read at all, so an email someone types for another person, such as a contact they add in your app, is never taken as theirs.

Pingado also reads:

  • the user_data, user and enhanced_conversion_data objects of a dataLayer push (Google’s Enhanced Conversions shape), and a top-level user_email
  • the email parameter of a page that triggers a conversion, such as /signup/success?email=...

Send the user’s email on the page that counts as the lead

Section titled “Send the user’s email on the page that counts as the lead”

If the lead is a page, such as your sign-up success page, push the signed-up user to the dataLayer on that page as early as you can, for example when the route mounts:

window.dataLayer.push({ event: 'sign_up', user_data: { email: 'customer@example.com' } })

When Pingado does not know the visitor’s email yet, it waits briefly on that page (until the page is ready, then at most half a second) and sends the lead as soon as the email arrives. If none comes, the lead goes without one, and an email pushed later still counts for the visitor’s later conversions, such as a trial. If the visitor leaves the page or switches tabs first, the lead goes at once.

Once a lead or a sign-up or log-in form has given the visitor an email, it stays theirs: a different email from a form, the dataLayer or a URL does not replace it. Only pingado.identify() from your own code can change it.

If your form stays on the page and shows a message after a successful send, such as “Thank you, we got your message”, no code is needed. In Settings → Conversions Mapping, select the gear next to Lead, add a Text visibility trigger with that message (or a part of it), and keep Only right after a form is submitted on.

When someone sends a form with an email address, Pingado waits up to 15 seconds for the text. If it shows, that is a lead, with the email and name from that form. If the send fails, your site shows no such text, so nothing is sent. The text is matched in any upper or lower case, and only while it is visible on the page.

If your form is sent by your own code and shows no fixed message, or submits without a native submit event (an embedded form builder, for example), send the lead yourself:

  1. Add data-pingado-ignore to the <form> tag, so Pingado does not capture the form by itself.
  2. When your own request succeeds, call window.pingado?.lead() with the email address:
form.addEventListener('submit', async (event) => {
event.preventDefault()
// Your own validation and request, as today
const res = await fetch(form.action, { method: 'POST', body: new FormData(form) })
if (res.ok) {
// The form went through: send the lead to Pingado
window.pingado?.lead(form.email.value, { firstName: form.name.value })
// Then show your success message
}
})

Send the lead only after success: a lead counts only when the form really went through, so your ad platform does not learn from failed or invalid attempts.

If your site already sends a Lead to Meta itself (fbq('track', 'Lead')), remove that call: Pingado sends it, and both would count twice.

Every lead goes to your connected ad accounts twice, from the browser pixel and from Pingado’s servers, with the same event ID, so each platform counts it once.