Track events

Track Lead

Fire Lead when a visitor submits a form — contact form, demo request, newsletter signup. AdsPing forwards it to Meta’s Conversions API with every match field it can attach.

Quick start

One call, anywhere after pb.js is loaded. All fields are optional — this alone is a working Lead event:

lead-minimal.js

adsping('track', 'Lead', {
  email: '[email protected]',
  phone: '+1 415 555 1234'
});

Every extra field you add raises your Event Match Quality — the full payload below reaches EMQ 10/10. pbq(…) is a legacy alias for adsping(…); both work.

Full example

Pick the tab for your stack — they all send the same event.

contact-page.html

<script>
  document.querySelector('#contact-form')
    .addEventListener('submit', function () {
      adsping('track', 'Lead', {
        email:        '[email protected]',
        phone:        '+1 415 555 1234',
        firstName:    'Jane',
        lastName:     'Doe',
        city:         'San Francisco',
        state:        'CA',
        zipCode:      '94107',
        country:      'US',
        dateOfBirth:  '1990-01-15',
        gender:       'f',
        externalId:   'crm-12345',
        value:        0,
        currency:     'USD',
        content_name: 'Contact form',
        content_ids:  ['contact-lead']
      });
    });
</script>

HTML — replace #contact-form with your form’s id and place the snippet anywhere after the AdsPing script tag.
React / Next.js — call window.adsping inside your form’s onSubmit, before your own submit logic runs.
Google Tag Manager — paste the HTML snippet into a Custom HTML tag, triggered on your form submit.
Send a field only when you actually have it. AdsPing SHA-256-hashes every personal field before it reaches Meta.

Parameters

Customer match data (raises EMQ)

Field	Type	Description
`email` recommended	string	Email address, any case. The strongest match signal. `[email protected]`
`phone` recommended	string	Any format — AdsPing normalizes it to E.164 by country. `+1 415 555 1234`
`firstName`	string	Given name, plain text. `Jane`
`lastName`	string	Family name, plain text. `Doe`
`city`	string	City name, plain text. `San Francisco`
`state`	string	State / region code. `CA`
`zipCode`	string	Postal / ZIP code. `94107`
`country`	string	ISO-3166 alpha-2 code. `US`
`dateOfBirth`	string	YYYY-MM-DD. `1990-01-15`
`gender`	string	'f' or 'm'. `f`
`externalId`	string	Your own customer / user id, from your CRM or auth session. `crm-12345`

Event details

Field	Type	Description
`value`	number	Monetary value of the lead. Use 0 if unknown. `0`
`currency`	string	ISO-4217 code. `USD`
`content_name`	string	Free-text label for the form. `Contact form`
`content_ids`	string[]	Array of string ids. `['contact-lead']`

Added automatically — never pass these

Field	Type	Description
`fbp / fbc`	string	Meta browser cookies — read by pb.js, fbc even built from ?fbclid= in the URL.
`client_ip_address`	string	Visitor IP, captured on AdsPing's server.
`client_user_agent`	string	Visitor browser, captured on AdsPing's server.
`external_id`	string	Anonymous visitor id pb.js sets on first visit (your externalId is sent in addition).

About Event Match Quality (EMQ)

Meta scores each event 0–10 on how well it can match the event to a person. Every field you send adds signal. On top of what you pass, AdsPing attaches the things it can read server-side — so you never paste these:

fbp + fbc — Meta browser cookies, read by pb.js (it even builds fbc from ?fbclid= in the URL).
client_ip_address + client_user_agent — the visitor’s IP and browser, captured on AdsPing’s server. Meta requires these for website events; they’re sent in plaintext (not hashed).
external_id — an anonymous visitor id pb.js sets on first visit.

Every personal field (email, phone, name, address) is SHA-256 hashed before it leaves AdsPing — Meta only ever receives the hash. The more real fields your payload carries, the closer you get to EMQ 10/10.

Test it

Submit your form with test data.
Open your pixel’s Report → Recent events in AdsPing.
A Lead row appears within ~10 seconds with a green Success badge and its EMQ score.

✓ Lead is live.

Every form submission is now forwarded to Meta via the Conversions API.