README

在Facebook中跟踪用户行为。

安装

步骤 1：下载插件

打开命令行控制台，进入您的项目目录，并执行以下命令以下载此插件的最新稳定版本

$ composer require setono/sylius-facebook-plugin

此命令需要您已全局安装Composer，如Composer文档中的安装章节所述。

步骤 2：启用插件

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

<?php
$bundles = [
    Setono\ClientIdBundle\SetonoClientIdBundle::class => ['all' => true],
    Setono\ConsentBundle\SetonoConsentBundle::class => ['all' => true],
    Setono\BotDetectionBundle\SetonoBotDetectionBundle::class => ['all' => true],
    Setono\SyliusFacebookPlugin\SetonoSyliusFacebookPlugin::class => ['all' => true],
    Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
];

步骤 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" }

setono_sylius_facebook:
    access_token: '%env(FACEBOOK_ACCESS_TOKEN)%'

# .env
###> setono/sylius-facebook-plugin ###
FACEBOOK_ACCESS_TOKEN=<YOUR TOKEN>
###< setono/sylius-facebook-plugin ###

警告！此插件使用https://github.com/Setono/ConsentBundle，默认情况下不会将数据发送到Facebook。

为了在开发环境中解决这个问题，您必须像这样配置ConsentBundle

# config/packages/dev/setono_consent.yaml
setono_consent:
    marketing_granted: true

此配置将默认将营销同意设置为true，这意味着如果您不处理同意，您将默认发送所有事件到Facebook（这可能与GDPR或其他与营销相关的法律相冲突）

步骤 4：导入路由

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

步骤 5：更新数据库模式

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

步骤 6：创建像素

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

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

步骤 7. 配置cron

将bin/console setono:sylius-facebook:send-pixel-events命令添加到您的crontab中。

计划必须是每小时或更频繁。见说明。
将bin/console setono:sylius-facebook:cleanup命令添加到您的crontab中。

计划必须是每天或更少。见说明。

步骤 8：您已准备就绪！

跟踪的事件位于EventListener文件夹中。

贡献

您可以如何贡献

将messages和validators翻译成您的母语
创建Behat测试，以验证脚本是否在相应的页面上输出
创建新的事件订阅者，以处理尚未实现的Facebook事件

谢谢！

davidrobert / setono-sylius-facebook-plugin-fork

维护者

详细信息