Meta (Facebook)

Follow this guide by Meta (Facebook) to Create and install a Meta (Facebook) pixel.

The AddPaymentInfo event has not been implemented as in a standard WooCommerce setup there is no save button or next step before hitting the purchase button. Hitting the purchase button is the next step, and the event that we want to track.

1. Get a Meta (Facebook) CAPI access token: instruction.
2. Paste the access token into the advanced section for Meta (Facebook) within the plugin.

Once the access token has been saved into the configuration, Meta (Facebook) CAPI is active.

By default, our plugin sends the minimum required amount of data to Meta (Facebook) with each CAPI hit. Also, the plugin doesn’t process anonymous visitors. Those are visitors who block the Meta (Facebook) pixel and where no fbp cookie is set. (Read more about the fbp cookie here). You can change those settings in accordance with your shop policy and the laws under which your shop has to operate.

• Process anonymous hits: Our plugin doesn’t send a CAPI hit if a visitor is blocking the Meta (Facebook) pixel. If you enable this setting, our plugin will send an anonymized CAPI hit to Meta (Facebook). It will generate a random fbp ID and a random user_agent, which are the required parameters for a valid CAPI hit.

In order to test the events using the Test Events Tool, our plugin offers a simple filter. Add it to your functions.php file while you’re testing.

/wp-content/themes/child-theme/functions.php

add_filter('wpm_facebook_capi_test_event_code', function () {
    // exchange TEST12345 with the test event code generated in your account
    return 'TEST12345';  
});

In case you suspect that something is wrong with the API call to the Meta (Facebook) server, or you simply want to see the response from the Meta (Facebook) server, the following filter is for you. It will output the API request response into the WooCommerce log file for Meta (Facebook) CAPI. You can view the log file under WooCommerce > Status > Logs > wpm-facebook-capi. Or you can open the file on the server. It is saved under /wp-content/uploads/wc-logs/.

/wp-content/themes/child-theme/functions.php

add_filter('wpm_send_http_api_facebook_capi_requests_blocking', '__return_true');

Data Processing Options are a way to control how the the data is used in the Meta (Facebook) systems and better support shop owners with their California Consumer Privacy Act (CCPA) compliance efforts. You’ll find more information in the official documentation.

The following filter is a simple way to add the necessary fields to each CAPI hit. Below settings are just an example. You need to make sure that you are using settings which are inline with your shops policy regarding CCPA.

/wp-content/themes/child-theme/functions.php

add_filter('wpm_facebook_capi_data_processing_options', function () {
    return [
        'data_processing_options'         => ['LDU'],
        'data_processing_options_country' => 1,
        'data_processing_options_state'   => 1000,
    ];
}, 10, 2);

When this option is enabled, the Pixel Manager will additionally send several visitor identifiers to Meta (Facebook), such as IP address, shop ID, and email. It is optional and will increase the likelihood that Meta (Facebook) will match the hit to an existing Meta (Facebook) user profile. For security reasons, the Pixel Manager will hash the data where possible. More info about hashing and visitor identifiers here and here.

A very convenient way to populate the product catalog within Meta (Facebook) is using microdata tags. It uses the Meta (Facebook) pixel and additional tags on product pages to upload the product data to Meta (Facebook). Each time a person visits a product page the product data is uploaded and updated. Additionally to that, Meta (Facebook) crawls the website and retrieves remaining data from the website. More information about this here.

In comparison to creating a dedicated feed, this method has several advantages:

• It is much simpler to set up, therefore less errors can happen.
• Creating the tags takes only a low amount of server resources.
• The tags are cache friendly. No additional cache settings need to be made.

On the other hand dedicated feed plugins have several disadvantages:

• Feed plugins sometimes fail running. Eg. if WP Cron has problems.
• They can run into timeout issues for shops with many products.
• They are harder to debug.
• If no proper cache exclusions are being set, the server will always deliver cached versions of the feed.

As always, using one or the other method has tradeoffs. Using microdata tags relies on constant traffic to the product pages or the Meta (Facebook) crawler to crawl the products in order to keep an updated catalog. If this is not a big concern for the person running the ads, then microdata tags are the better solution.

1. Within the plugin, open the advanced settings for Meta (Facebook) and activate the Microdata Tags for Catalogues.
2. Head over to your Meta (Facebook) commerce manager and select your catalogue.
3. Open the Catalogue tab and select Data sources.
4. (Select Add items.) If a drop-down appears, select Add multiple items.
5. Select Pixel and select Next.
6. Select the pixel you want to connect and then Next.
7. If you wish, select Add filters to limit the items that your pixel updates. Select Next. (Usually its best not to limit the items. Therefore don’t use the filter unless you have a good reason to.)
8. Select Add trusted websites and enter the website domains that you trust to use as sources for your item information. Don’t include the http:// or www. For example, enter jaspersmarket.com. If you want your pixel to use multiple country-specific websites, enter each one. Select Save and then Next.
9. Select your default currency. This is the currency that your catalogue will use if prices for items on your website don’t include a 3-letter ISO 4217 currency code, such as USD or EUR. Select Next.

Your connected pixel now appears in Data sources. It may take up to 24 hours to be ready. When the pixel is ready, it updates your catalogue each time someone interacts with a product page on your website, typically within 15 minutes of the interaction. If you remove any items from your website, they’ll be deleted from your catalogue after seven days.