README

跟踪您商店中的电子商务事件并将它们发送到 Facebook，以在 Facebook 内部启用您的营销活动。

安装

步骤 1：下载插件

composer require setono/sylius-facebook-plugin

步骤 2：启用插件

然后，通过将其添加到项目中 config/bundles.php 文件中注册的插件/包列表中，在 SyliusGridBundle 之前启用插件

<?php
$bundles = [
    // the plugin must be added ABOVE the SyliusGridBundle
    Setono\SyliusFacebookPlugin\SetonoSyliusFacebookPlugin::class => ['all' => true],
    Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
    
    // used for filtering bot requests
    Setono\BotDetectionBundle\SetonoBotDetectionBundle::class => ['all' => true],
    
    // this is the underlying bundle we use to track events
    Setono\MetaConversionsApiBundle\SetonoMetaConversionsApiBundle::class => ['all' => true],
    
    // OPTIONAL: See note below
    // Setono\ConsentBundle\SetonoConsentBundle => ['all' => true],
];

可选：如果您想启用同意（即 cookie / GDPR），您可以安装 consent bundle。

步骤 3：配置插件

# config/packages/setono_sylius_facebook.yaml
imports:
    - { resource: "@SetonoSyliusFacebookPlugin/Resources/config/app/config.yaml" }
    
    # Uncomment next line if you want to load some example pixels via fixtures
    # - { resource: "@SetonoSyliusFacebookPlugin/Resources/config/app/fixtures.yaml" }

步骤 4：导入路由

# config/routes/setono_sylius_facebook.yaml
setono_sylius_facebook:
    resource: "@SetonoSyliusFacebookPlugin/Resources/config/routes.yaml"

步骤 5：选择您的 HTTP 客户端实现

您可以选择安装默认的

composer require kriswallsmith/buzz nyholm/psr7

或者编写自己的 HTTP 客户端并调用

Client::setHttpClient()
Client::setRequestFactory()
Client::setResponseFactory()
Client::setStreamFactory()

步骤 6：更新您的数据库模式

$ php bin/console doctrine:migrations:diff
$ php bin/console doctrine:migrations:migrate

步骤 7：创建一个像素

在 Facebook 中创建像素时，您将收到一个像素 ID。

现在通过导航到 /admin/facebook/pixels/new 在您的 Sylius 商店中创建一个新的像素。请记住启用像素并启用您想要跟踪的渠道。

步骤 8：您已经准备好了！

被跟踪的事件位于 EventSubscriber 文件夹中，但这里有一个列表

ViewContent（即产品页面查看）
添加到购物车
开始结账
购买
ViewCategory（这是一个跟踪类视图的自定义事件）

贡献

您可以如何贡献

将 messages 翻译成您的母语
创建新的事件订阅者以处理尚未实现 Facebook 事件

谢谢！

setono / sylius-facebook-tracking-plugin

维护者

详细信息