Track events

Track ViewContent

Fire ViewContent when a visitor opens a product or service detail page. Meta uses it to build retargeting audiences and to seed Smart Bidding with browsing signals.

Quick start

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

view-content-minimal.js
adsping('track', 'ViewContent', {
  content_name: 'Acme Hydrating Serum',
  content_ids: ['SKU-1043']
});

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.

product-page.html
<script>
  adsping('track', 'ViewContent', {
    content_name: 'Acme Hydrating Serum',
    content_ids:  ['SKU-1043'],
    content_type: 'product',
    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 your product page template, after the AdsPing script tag, and fill the values from your product data.
  • React / Next.js — render <ViewContentTracker /> inside your product page template so one component covers the whole catalog.
  • Google Tag Manager — paste the HTML snippet into a Custom HTML tag, triggered on product page views.
  • Most product-page visitors are anonymous — pass the match fields only when you know the visitor (e.g. they’re logged in). AdsPing SHA-256-hashes every personal field before it reaches Meta.

Parameters

Product details
FieldTypeDescription
content_name
recommended
stringProduct name, plain text.
Acme Hydrating Serum
content_ids
recommended
string[]Array of product SKU strings.
['SKU-1043']
content_typestring'product' or 'product_group'.
product
valuenumberItem price.
24.90
currencystringISO-4217 code.
USD
Customer match data (raises EMQ)
FieldTypeDescription
email
recommended
stringEmail address, any case. The strongest match signal.
phone
recommended
stringAny format — AdsPing normalizes it to E.164 by country.
+1 415 555 1234
firstNamestringGiven name, plain text.
Jane
lastNamestringFamily name, plain text.
Doe
citystringCity name, plain text.
San Francisco
statestringState / region code.
CA
zipCodestringPostal / ZIP code.
94107
countrystringISO-3166 alpha-2 code.
US
dateOfBirthstringYYYY-MM-DD.
1990-01-15
genderstring'f' or 'm'.
f
externalIdstringYour own customer / user id, from your CRM or auth session.
crm-12345
Added automatically — never pass these
FieldTypeDescription
fbp / fbcstringMeta browser cookies — read by pb.js, fbc even built from ?fbclid= in the URL.
client_ip_addressstringVisitor IP, captured on AdsPing's server.
client_user_agentstringVisitor browser, captured on AdsPing's server.
external_idstringAnonymous 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

  1. Open a product page in a fresh browser tab.
  2. Open your pixel’s Report → Recent events in AdsPing.
  3. A ViewContent row appears within ~10 seconds with a green Success badge and its EMQ score.

✓ ViewContent is live.

Meta will start building retargeting audiences from your product page visitors.

Was this page helpful?