Standard events are predefined visitor actions that correspond to common, conversion-related activities, such as searching for a product, viewing a product, or purchasing a product. Standard events support [parameters][1], which allow you to include an object containing additional information about an event, such as product IDs, categories, and the number of products purchased.
All standard events are tracked by calling the pixel's fbq('track') function, with the event name, and (optionally) a JSON object as its parameters. For example, here's a function call to track when a visitor has completed a purchase event, with currency and value included as a parameter:
fbq('track', 'Purchase', '{currency: 'USD', value: 30.00}');
If you called that function, it would be tracked as a purchase event in the Events Manager:
![][2]
You can call the fbq('track') function anywhere between your web page's opening and closing `` tags, either when the page loads, or when a visitor completes an action, such as clicking a button.
For example, if you wanted to track a standard purchase event after a visitor has completed the purchase, you could call the fbq('track') function on your purchase confirmation page, like this:
...
...
If instead you wanted to track a standard purchase event when the visitor clicks a purchase button, you could tie the fbq('track') function call to the purchase button on your checkout page, like this:
Purchase
Note that the example above uses jQuery to trigger the function call, but you could trigger the function call using any method you wish.
You can use the fbq('track') function to track the following standard events. Standard events also support [parameter][3] objects with specific object properties, which allow you to include detailed information about an event.
Event Name | Event Description | Object Properties | |
AddPaymentInfo
|
When payment information is added in the checkout flow.
A person clicks on a save billing information button. |
content_category, content_ids, contents, currency, value
None required. |
| --------------||||||
|
AddToCart
|
When a product is added to the shopping cart.
A person clicks on an add to cart button. |
content_ids, content_name, content_type, contents, currency, value
None required.
Required for Dynamic Ads: content_ids, content_type, and contents
| | | | |
AddToWishlist
|
When a product is added to a wishlist.
A person clicks on an add to wishlist button. |
content_name, content_category, content_ids, contents, currency, value
None required. | |
CompleteRegistration
|
When a registration form is completed.
A person submits a completed subscription or signup form. |
content_name, currency, status, value
None required. | |
Contact
|
When a person initiates contact with your business via telephone, SMS, email, chat, etc.
A person submits a question about a product. | None required. | |
CustomizeProduct
|
When a person customizes a product.
A person selects the color of a t-shirt. | None required. | |
Donate
|
When a person donates funds to your organization or cause.
A person adds a donation to the Humane Society to their cart. | None required. | |
FindLocation
|
When a person searches for a location of your store via a website or app, with an intention to visit the physical location.
A person wants to find a specific product in a local store. | None required. | |
InitiateCheckout
|
When a person enters the checkout flow prior to completing the checkout flow.
A person clicks on a checkout button. |
content_category, content_ids, contents, currency, num_items, value
None required. | |
Lead
|
When a sign up is completed.
A person clicks on pricing. |
content_category, content_name, currency, value
None required. | |
PageView
|
This is the default pixel tracking page visits.
A person lands on your website pages. | None required. | |
Purchase
|
When a purchase is made or checkout flow is completed.
A person has finished the purchase or checkout flow and lands on thank you or confirmation page. |
content_ids, content_name, content_type, contents, currency, num_items, value
**Required: **currency and value
Required for Dynamic Ads: content_ids, content_type, and contents
| |
Schedule
|
When a person books an appointment to visit one of your locations.
A person selects a date and time for a dentist appointment. | None required. | |
Search
|
When a search is made.
A person searches for a product on your website. |
content_category, content_ids, contents, currency, search_string, value
None required. | |
StartTrial
|
When a person starts a free trial of a product or service you offer.
A person selects a free week of your game. |
currency, predicted_ltv, value
None required. | |
SubmitApplication
|
When a person applies for a product, service, or program you offer.
_A person applies for a credit card, educational program, or job. _ | None required. | |
Subscribe
|
When a person applies to a start a paid subscription for a product or service you offer.
A person subscribes to your streaming service. |
currency, predicted_ltv, value
None required. | |
ViewContent
|
When a key page is viewed such as a product page.
A person lands on a product details page. |
content_ids, content_name, content_type, contents, currency, value
None required.