Facebook CAPI

The Facebook Conversion API (CAPI) integration allows events to be sent to Facebook via our server instead of through the browser

It sounds similar to the Facebook pixel feature that exists today, but it works a little differently:

1. You add the pixel/token in Abicart admin that enables this pixel/token on your site.
2. Facebook uses this pixel/token to track events and conversion information for Facebook Ads Manager

How is CAPI different from a Facebook pixel?

Facebook CAPI is a complement to Facebook pixel and is primarily targeted at visitors who own an iOS device with a version 14 or higher.

With Facebook pixel, all data collection is done through the visitor's browser, while in combination with CAPI it is sent through our servers.

Facebook pixel: Facebook checks for events and retrieves data directly from the site based on the visitor's activity. It is a fairly reliable way, but with recent Apple privacy changes, the pixel could not always accurately track usage of your site.

Some browsers may also choose to disable tracking via the pixel.

Facebook CAPI can track this data even if the browser blocks pixel tracking so with CAPI you get more accurate data. Note that Facebook CAPI does not replace the Facebook Pixel but is a complement to it. 

Our integration ensures that no event or information is tracked twice if you have both the pixel and Facebook CAPI. If the information comes in via Facebook Pixel, we ensure that it is not duplicated when we send the information via CAPI, this is to ensure that the measurements are accurate.

Step-by-step:

1. Click Appearance -> Themes -> Edit Theme.
2. Click Additions -> Facebook.
3. Add a correct Pixel ID
4. Add a correct Access token
5. Save

To make sure it works, do this:

1. Preview the theme
2. Now you land in your store and that means we sent a "PageView" event both through the pixel and our server
3. Click on any product and a "ViewContent" event is tracked
4. Add a product to the cart and the "AddToCart" event is tracked

Here is how you see the information:

1. Go to Facebook Business Account
2. In Business Account, select "Events Manager"
3. Select "Your Pixel Integration"
4. Events registered via both browser and server are listed here

Requirements from Facebook

Business Manager - You will need a Business Manager account to use this API.

Pixel ID: You need a pixel ID to use their Conversion API. If you already have a Facebook pixel for the site, we recommend using the same pixel ID for both browser and server events.

Access token - To use this conversion API, you will need to generate an access token that is used as a parameter in each API request.

There are two ways to obtain an access token:

Through Events Manager (recommended), follow these steps:

1. Select the pixel you want to implement in Events Manager
2. Click on the settings tab
3. Under the "Conversion API" section, click on Generate access token link under "Set up manually" and follow the instructions.
4. Once you have your Access Token, click on "Manage integrations" in the "Overview" tab.
5. Click on "Manage" next to Conversions API
6. This will create a Conversion API app and users for you.

No auditing or permission requests need to be made.

By your own app:

If you already have your own app in Facebook, you can generate access tokens in Business Manager.

1. Go to Business settings
2. Assign a pixel to your system user. It is also possible to create a new system user in this mode.
3. Select the assigned system user and click generate.

No auditing or permissions requests need to be made.