Event Name

Description

Object properties

Purchase

Triggered when a purchase is completed or checkout is finalized.

Required: currency and value and order_id. Optional: content_category, content_name, currency, value

AddPaymentInfo

Occurs when payment details are added during the checkout process.

content_category, content_ids, contents, currency, value
​(all optional)

InitiateCheckout

Happens when someone starts the checkout process but hasn’t completed it yet.

content_category, content_ids, contents, currency, value
​(all optional)

AddToCart

When an item is added to the shopping cart.

content_ids, content_name, content_type, contents, currency, value
​(all optional)

AddToWishlist

When an item is added to a wishlist.

content_name, content_category, content_ids, contents, currency, value (all optional)

Lead

Triggered when a sign-up is completed.

content_category, content_name, currency, value (all optional)

Contact

When someone initiates contact with the business via phone, SMS, email, chat, etc.

(all optional)

ViewContent

A visit to a significant web page (e.g., a product page or landing page).

content_ids, content_category, content_name, content_type, contents, currency, value (all optional)

CustomizeProduct

When a product customization occurs.

(all optional)

CompleteRegistration

Triggered when a registration form is filled out.

content_name, currency, status, value (all optional)

Donate

When a donation is made to an organization or cause.

(all optional)

Schedule

When an appointment is booked to visit a location.

(all optional)

Subscribe

When a paid subscription is initiated for a product or service.

currency, predicted_ltv, value (all optional)

Search

When a search action is performed.

content_category, content_ids, content_type, contents, currency, search_string, value (all optional)

Property Key

Value Type

Parameter Description

order_id

String

Special order ID that must be sent with the Purchase signal. This is used to reliably track the number of conversions and deduplicated them order and a server.

content_category

String

The category associated with the page or product.

content_ids

Array of integers/strings

IDs of products linked to the signal, such as SKUs (e.g., ['ABC123', 'XYZ789']).

content_name

String

The name of the page or product.

content_type

String

Either "product" or "product_group" based on the IDs provided in content_ids or contents. Use "product" for product IDs and "product_group" for group IDs. If not specified, Meta matches the signal to all items with the same ID, regardless of type.

contents

Array of objects

A list of JSON objects detailing the quantity and the International Article Number (EAN) or other identifiers. Required fields: id and quantity (e.g., [{'id': 'ABC123', 'quantity': 2}, {'id': 'XYZ789', 'quantity': 2}]).

currency

String

The currency for the specified value.

num_items

Integer

Used with the InitiateCheckout signal. Represents the number of items when checkout was initiated.

predicted_ltv

Integer, float

The estimated lifetime value of a subscriber, as defined by the advertiser, represented as a precise value.

search_string

String

Used with the Search signal. The string entered by the user for the search.

status

Boolean

Used with the CompleteRegistration signal to indicate the registration status.

value

Integer or float

The business value of a user performing this signal.