PHPackages                             dwy/facebook-conversion - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. dwy/facebook-conversion

ActiveCraft-plugin[API Development](/categories/api)

dwy/facebook-conversion
=======================

Craft CMS plugin to send web events directly to Facebook

v1.3.4(3mo ago)016.0k—0%3[6 issues](https://github.com/digitalwithyou/craft-facebook-conversion/issues)[2 PRs](https://github.com/digitalwithyou/craft-facebook-conversion/pulls)proprietaryPHP

Since Jan 27Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/digitalwithyou/craft-facebook-conversion)[ Packagist](https://packagist.org/packages/dwy/facebook-conversion)[ RSS](/packages/dwy-facebook-conversion/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (30)Used By (0)

Facebook Conversion plugin for Craft CMS 3, 4 & 5
=====================================================

[](#facebook-conversion-plugin-for-craft-cms-3-4--5)

Requirements
------------

[](#requirements)

- Craft CMS 3.x, 4.x or 5.x
- Works best with Craft Commerce
- Facebook Pixel (See [configuration](#pixel) how to obtain the Facebook Pixel)
- Facebook Business Manager (See [Facebook Business](https://business.facebook.com/))
- Facebook Access Token (See [configuration](#access-token) how to obtain the Access Token)

Installation
------------

[](#installation)

The plugin can be installed via the Plugin Store in the Craft Control Panel.

Or, open your terminal, go the Craft project and install the plugin via Composer:

```
composer require dwy/facebook-conversion
./craft plugin/install facebook-conversion

```

Configuration
-------------

[](#configuration)

### Pixel

[](#pixel)

1. Open [Facebook Business Manager](https://business.facebook.com)
2. Select your business
3. Navigate to the Events Manager
4. Click the Add Data Source button in the left menu
5. Use "Web"
6. Choose "Conversion API" as method.
7. Fill in a Pixel name and website url
8. After completing the Pixel creation, you'll find the Pixel-ID in the Settings tab of the Data Source. Copy your Pixel-ID to the Settings page of the plugin.

For more information, check the [Create a Facebook Pixel in Business Manager](https://www.facebook.com/business/help/314143995668266?id=1205376682832142) article in the official documention.

### Access Token

[](#access-token)

In the Events Manager:

1. Select the pixel you want to associate with your Conversions API
2. Navigate to the Settings tab
3. Click Create Access Token below the "Set up manually" section
4. Select the Facebook pixel you want your server events to be associated with
5. Click Generate Access Token
6. Copy your access token to the Settings page of the plugin

For more information, check the [Create an Access Token for Conversions API in Guided Setup](https://www.facebook.com/business/help/1341993546002479) article in the official documention.

### Test Event Code

[](#test-event-code)

Can be used to test the implementation.

1. Navigate to the Events Testing tab in the Events Manager
2. Copy the `test_event_code` to the Settings page of the plugin

Make sure an event that can be linked to a user by Facebook (i.e. Purchase event, by having a valid `fbclid` parameter, etc) is used when testing.

Template implementation
-----------------------

[](#template-implementation)

The Facebook Pixel can be added to your template by adding the `facebook-conversion-head-tag` hook to the head of the page and the `facebook-conversion-body-tag` to the body. For example:

```

    My Website

    {% hook 'facebook-conversion-head-tag' %}

    {% hook 'facebook-conversion-body-tag' %}
```

Please note, when the Facebook Pixel is already added by another plugin (E.g. SEOmatic) don't add the template hook to avoid duplication.

Brought to you by [Digital With you](https://digitalwithyou.com), follow us on [Instagram](https://www.instagram.com/digitalwithyou/)

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance80

Actively maintained with recent releases

Popularity26

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 97.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~65 days

Recently: every ~219 days

Total

29

Last Release

107d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/046c001565a7ca9813be41eb3fa789804acb124af126cd4fb291ec2b26d960e1?d=identicon)[dwy](/maintainers/dwy)

---

Top Contributors

[![Diewy](https://avatars.githubusercontent.com/u/1014380?v=4)](https://github.com/Diewy "Diewy (90 commits)")[![boboldehampsink](https://avatars.githubusercontent.com/u/378974?v=4)](https://github.com/boboldehampsink "boboldehampsink (1 commits)")[![qrazi](https://avatars.githubusercontent.com/u/7550540?v=4)](https://github.com/qrazi "qrazi (1 commits)")

---

Tags

facebookCraftcraftcmscraft-plugin

### Embed Badge

![Health badge](/badges/dwy-facebook-conversion/health.svg)

```
[![Health](https://phpackages.com/badges/dwy-facebook-conversion/health.svg)](https://phpackages.com/packages/dwy-facebook-conversion)
```

###  Alternatives

[wrav/oembed

A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles.

36205.0k3](/packages/wrav-oembed)[nystudio107/craft-seomatic

SEOmatic facilitates modern SEO best practices & implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible.

1741.4M46](/packages/nystudio107-craft-seomatic)[scaramangagency/craftagram

Grab Instagram content through the Instagram API

1426.0k](/packages/scaramangagency-craftagram)[craftpulse/craft-typesense

Craft Plugin that synchronises with Typesense

122.7k](/packages/craftpulse-craft-typesense)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)