PHPackages                             hirale/openmage-meta-conversions - 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. hirale/openmage-meta-conversions

ActiveMagento-module[API Development](/categories/api)

hirale/openmage-meta-conversions
================================

A module for integrating Meta Conversion API

v1.1.0(2y ago)391OSL-3.0PHPPHP ^8.0

Since Jun 9Pushed 2w ago1 watchersCompare

[ Source](https://github.com/hirale/openmage-meta-conversions)[ Packagist](https://packagist.org/packages/hirale/openmage-meta-conversions)[ RSS](/packages/hirale-openmage-meta-conversions/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

Hirale Meta Conversions API Module
==================================

[](#hirale-meta-conversions-api-module)

A module for integrating [Meta Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started), sending events from server side.

For duplicate events, you can consult this page

If you are using javascript to send pixel events, You can get event\_id like this.

```
Mage::helper('metaconversions')->getEventId();
```

Supported Events
----------------

[](#supported-events)

- `AddToCart`
- `AddToWishlist`
- `CompleteRegistration`
- `InitiateCheckout`
- `Purchase`
- `Search`
- `ViewContent`
- `PageView`
- `ViewCart`

You can check more events in the [events section](https://developers.facebook.com/docs/meta-pixel/reference#standard-events).

Install
-------

[](#install)

Requires [`hirale/queue`](https://github.com/hirale/queue) `^3.0`(pulled in automatically).

**Maho** (26.5+):

```
composer require hirale/openmage-meta-conversions
```

**OpenMage** (20.17+, PHP 8.3+) — one-time tweaks first; details in the [hirale/queue README](https://github.com/hirale/queue#openmage-one-time-composer-adjustments):

```
composer config platform.php 8.3
composer config allow-plugins.hirale/magento-module-installer true
composer require hirale/magento-module-installer hirale/openmage-meta-conversions
```

Usage
-----

[](#usage)

### Setup

[](#setup)

1. This module requires the [hirale/queue](https://github.com/hirale/queue) module — configure its backend first (System &gt; Configuration &gt; Hirale &gt; Queue).
2. Generate an access token. See .
3. Go to system config `System > Configuration > Sales > Meta API > Conversions API`. Insert the parameters from step 1, save.

### Debug

[](#debug)

Enable Debug Mode in system config, then check `var/log/meta_conversions.log`. Each processed queue message logs two entries: the event batch (envelopes + custom data — `user_data` is deliberately never written to logs, and PII is already SHA-256 hashed before it even reaches the queue) and the Graph API response.

```
2026-06-11T10:00:00+00:00 DEBUG (7): Array
(
    [store_id] => 1
    [events] => Array
        (
            [0] => Array
                (
                    [event] => Array
                        (
                            [event_time] => 1718044092
                            [event_source_url] => https://example.com/some-product.html
                            [action_source] => website
                            [event_id] => 666745bcdd76a
                            [event_name] => ViewContent
                        )

                    [custom_data] => Array
                        (
                            [currency] => USD
                            [content_type] => product
                            [content_ids] => Array ( [0] => SKU-9 )
                        )

                )

            [1] => Array
                (
                    [event] => Array
                        (
                            [event_name] => PageView
                        )

                    [custom_data] =>
                )

        )

)

2026-06-11T10:00:00+00:00 DEBUG (7): FacebookAds\Object\ServerSide\EventResponse Object
(
    [container:protected] => Array
        (
            [events_received] => 2
            [messages] => Array ( )
            [fbtrace_id] => AkuJqnm2pr421jM7d89SRqa
        )

)

```

Upgrading
---------

[](#upgrading)

- The access token is now stored encrypted (`adminhtml/system_config_backend_encrypted`). After upgrading, re-enter and save the token once in system config.
- The queue message schema changed (one message now carries all events of a request, and PII is hashed before enqueueing). Let the queue worker drain pending metaconversions messages before deploying the upgrade; messages enqueued by the old version cannot be processed by the new handler.

License
-------

[](#license)

The Open Software License v. 3.0 (OSL-3.0). Please see [License File](LICENSE.md) for more information.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance63

Regular maintenance activity

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

3

Last Release

742d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7b942350aafb4a51512f22cebb0b977054da9318c79ce67b93d850fee4d7f5b8?d=identicon)[alefix](/maintainers/alefix)

---

Top Contributors

[![hirale](https://avatars.githubusercontent.com/u/22028058?v=4)](https://github.com/hirale "hirale (16 commits)")

---

Tags

magentoopenmagemagento1

### Embed Badge

![Health badge](/badges/hirale-openmage-meta-conversions/health.svg)

```
[![Health](https://phpackages.com/badges/hirale-openmage-meta-conversions/health.svg)](https://phpackages.com/packages/hirale-openmage-meta-conversions)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.6M40](/packages/smile-elasticsuite)[m2epro/magento2-extension

M2E Pro is a Magento trusted (TM), award-winning extension, which allows merchants of all sizes to fully integrate Magento based system(s) into eBay/Amazon/Walmart platforms.

70664.9k](/packages/m2epro-magento2-extension)[combindma/laravel-facebook-pixel

Meta pixel integration for Laravel

5270.9k](/packages/combindma-laravel-facebook-pixel)[tinify/magento2

Make your web shop faster by compressing your JPEG and PNG images. This plugin automatically optimizes your images by integrating with the popular image compression services TinyJPG and TinyPNG.

4246.1k](/packages/tinify-magento2)[sehrling/elasticsuite-ghost-cleaner

Magento 2 module to delete ghost indices automatically for the Smile Elasticsuite module

1797.8k](/packages/sehrling-elasticsuite-ghost-cleaner)[yireo/magento2-graph-ql-rate-limiting

Magento 2 module to add rate limiting to GraphQL resources

1421.3k](/packages/yireo-magento2-graph-ql-rate-limiting)

PHPackages © 2026

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