Facebook Conversion API Integration

NOTE:

This integration ONLY handles purchase conversion events.

To track visits to the checkout BEFORE purchase, add your FB tracking pixel script to the product CSS field.

Important Note

Passing Facebook Click Identifiers (Crucial Step)

For the Conversion API to accurately attribute a purchase back to a specific Facebook ad, you must pass Facebook's tracking parameters from your landing page to the PayKickstart checkout page.

When a visitor clicks your ad and lands on your website, Facebook provides two key identifiers:

• _fbp (Browser ID): Usually stored in a browser cookie.

• _fbc (Click ID): Usually stored in a browser cookie after a user clicks an ad. If the cookie is not present, this value must be constructed from the fbclid URL parameter.

Your responsibility is to capture these values and pass them to the PayKickstart checkout URL.

Passing the Parameters Correctly

The fbc parameter you send to PayKickstart is not simply the raw fbclid value from the URL. It must be correctly formatted according to Meta's specifications.

There are two primary scenarios for getting the correct value:

1. From the _fbc Cookie (Recommended): The easiest and most reliable method is to retrieve the value directly from the _fbc browser cookie on your landing page and pass it as the fbc parameter.

2. From the fbclid URL Parameter: If the_fbccookie is not available, thefbcvalue must be constructed in a specific format: version.subdomainIndex.creationTime.fbclid. This is a technical task that requires a script on your website to assemble the value correctly.

Example of a Correctly Formatted URL

Your website's logic should dynamically build the checkout URL. It should prioritize grabbing the _fbc and _fbp cookie values first, for example:
https://app.paykickstart.com/checkout/sample-product-123?fbc={value_from_the_fbc_cookie}&fbp={value_from_the_fbp_cookie}
 

Note for Your Developer: Please ensure that the script on our landing page captures the values from the _fbc and _fbp cookies and appends them to the PayKickstart checkout URL query string as fbc and fbp. If the _fbc cookie is not present, the fbc parameter must be constructed using the fbclid from the URL, formatted as per Meta's Conversions API documentation.

Important: If these parameters are missing or incorrectly formatted, PayKickstart cannot link the purchase event back to the specific ad click. This will significantly impact your campaign's reporting and optimization capabilities.

ADDITIONAL NOTES:

Conversion pixels are ONLY triggered on up-front purchases.
This will NOT trigger an event for subscription rebills.

For deduplication in your conversion pixel, please use the PayKickstart Transaction ID as the event ID (where applicable).