setono / meta-conversions-api-bundle
在您的 Symfony 应用程序中与 Meta / Facebook Conversions API 一起工作
v0.1.5
2023-12-01 09:00 UTC
Requires
- php: >=7.4
- composer-runtime-api: ^2
- composer/semver: ^3.0
- setono/bot-detection-bundle: ^1.7
- setono/meta-conversions-api-php-sdk: ^0.2.1
- symfony/config: ^5.4 || ^6.0
- symfony/dependency-injection: ^5.4 || ^6.0
- symfony/event-dispatcher: ^5.4 || ^6.0
- symfony/event-dispatcher-contracts: ^1.1 || ^2.5 || ^3.1
- symfony/http-foundation: ^5.4 || ^6.0
- symfony/http-kernel: ^5.4 || ^6.0
- symfony/messenger: ^5.4 || ^6.0
- symfony/monolog-bundle: ^2.12 || ^3.8
- webmozart/assert: ^1.11
Requires (Dev)
- matthiasnoback/symfony-dependency-injection-test: ^4.3
- nyholm/symfony-bundle-test: ^2.0
- phpspec/prophecy-phpunit: ^2.0
- phpunit/phpunit: ^9.5
- psalm/plugin-phpunit: ^0.18
- psalm/plugin-symfony: ^3.1 || ^4.0
- setono/code-quality-pack: ^2.4
- setono/consent-bundle: ^0.1.4
- setono/tag-bag: ^2.2
- setono/tag-bag-bundle: ^3.0
- symfony/twig-bundle: ^5.4 || ^6.0
This package is auto-updated.
Last update: 2024-08-30 01:08:33 UTC
README
在您的 Symfony 应用程序中与 Meta / Facebook Conversions API 一起工作。在底层,此包集成了 Meta Conversions API PHP SDK 库。
安装
要安装此包,请简单地运行
composer require setono/meta-conversions-api-bundle
这还将安装 Bot Detection Bundle,它用于过滤机器人请求。
如果您想处理同意(即 cookie/GDPR 同意),您可以使用 consent bundle,通过安装它
composer require setono/consent-bundle
使用方法
<?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)); } }
测试集成
要测试集成,您可以将测试事件代码(您可以从 Meta / Facebook 的事件管理器中检索)添加到您的网站上的任何 URL,如下所示: https://example.com/?_testEventCode=[YOUR TEST EVENT CODE]
或 https://example.com/?_test_event_code=[YOUR TEST EVENT CODE]
。此代码将保存在会话中,因此您后续的所有请求都将带有测试事件代码。