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-ignoreattribute
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,userandenhanced_conversion_dataobjects of adataLayerpush (Google’s Enhanced Conversions shape), and a top-leveluser_email - the
emailparameter 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.
Forms that show a message after sending
Section titled “Forms that show a message after sending”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.
Forms submitted with JavaScript
Section titled “Forms submitted with JavaScript”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:
- Add
data-pingado-ignoreto the<form>tag, so Pingado does not capture the form by itself. - 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.
Send leads to ad platform pixels
Section titled “Send leads to ad platform pixels”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.