Track events

Track InitiateCheckout

Fire InitiateCheckout when a visitor arrives on your checkout page — they’ve clicked “Checkout” or “Buy now” and are about to enter payment details.

Quick start

One call when the checkout page loads, anywhere after pb.js — this alone is a working InitiateCheckout event:

initiate-checkout-minimal.js

adsping('track', 'InitiateCheckout', {
  value: 24.90,
  currency: 'USD',
  num_items: 1
});

Every extra field you add raises your Event Match Quality — the full payload below reaches EMQ 10/10.

Full example

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

checkout.html

<script>
  adsping('track', 'InitiateCheckout', {
    content_ids:  ['SKU-1043'],
    content_type: 'product',
    num_items:    1,
    value:        24.90,
    currency:     'USD',
    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'
  });
</script>

HTML — place the snippet in the <body> of the checkout page, after the AdsPing script, and fill the values from your cart data.
React / Next.js — render <CheckoutTracker /> on your checkout page; the useEffect fires the event once when the page loads.
Google Tag Manager — paste the HTML snippet into a Custom HTML tag, triggered on your checkout page.
Send a field only when you actually have it. AdsPing SHA-256-hashes every personal field before it reaches Meta.

Parameters

Checkout details

Field	Type	Description
`value` recommended	number	Cart total. `24.90`
`currency` recommended	string	ISO-4217 code. `USD`
`num_items`	number	Total item count. `1`
`content_ids`	string[]	Array of cart item SKU strings. `['SKU-1043']`
`content_type`	string	'product' or 'product_group'. `product`

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`

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

Open your checkout page with items in the cart.
Open your pixel’s Report → Recent events in AdsPing.
An InitiateCheckout row appears within ~10 seconds with a green Success badge and its EMQ score.

✓ InitiateCheckout is live.

Every checkout page load is now forwarded to Meta via the Conversions API.