Meta / Facebook Conversions API bundle

Work with the Meta / Facebook Conversions API in your Symfony application. Under the hood this bundle integrates the Meta Conversions API PHP SDK library.

Installation

To install this bundle, simply run:

composer require setono/meta-conversions-api-bundle

This also installs the Bot Detection Bundle which is used to filter bot requests.

If you want to handle consent (i.e. cookie/GDPR consent), you can use the consent bundle, by installing it:

composer require setono/consent-bundle

Usage

<?php

declare(strict_types=1);

use Psr\EventDispatcher\EventDispatcherInterface;
use Setono\MetaConversionsApi\Event\Event;
use Setono\MetaConversionsApiBundle\Event\ConversionsApiEventRaised;

final class YourService
{
    private EventDispatcherInterface $eventDispatcher;

    public function __construct(EventDispatcherInterface $eventDispatcher)
    {
        $this->eventDispatcher = $eventDispatcher;
    }

    public function track(): void
    {
        $event = new Event(Event::EVENT_VIEW_CONTENT);
        $event->customData->contentType = 'product';
        $event->customData->contentName = 'Blue Jeans';
        $event->customData->contentIds[] = 'PRODUCT_SKU';

        $this->eventDispatcher->dispatch(new ConversionsApiEventRaised($event));
    }
}

Test the integration

To test the integration you can set the test event code (that you can retrieve from Meta / Facebooks event manager) and append it to any url on your website like so: https://example.com/?_testEventCode=[YOUR TEST EVENT CODE] or https://example.com/?_test_event_code=[YOUR TEST EVENT CODE]. This code is saved in a session and hence all your subsequent requests will be sent with the test event code.