雪软/laravel-facebook-pixel

Laravel 的 Facebook Pixel 集成

v0.01 2023-02-28 13:22 UTC

This package is auto-updated.

Last update: 2024-09-28 16:51:55 UTC


README

Laravel 的 Facebook Pixel 集成

Latest Version on Packagist Software License Quality Score Total Downloads

为您的 Laravel 应用程序提供简单的 Facebook Pixel 实现。

Facebook Pixel

Facebook Pixel 是一段 JavaScript 代码片段,允许您跟踪您网站上的访客活动。它通过加载一个小的函数库来实现,您可以在访客采取您希望跟踪的动作(称为事件)时使用它(称为 转化)。跟踪的转化 会显示在 Facebook 广告管理器Facebook 分析 仪表板中,您可以使用它们来衡量广告的效果,定义 自定义受众 以进行广告定位,进行 动态广告 活动,并分析您网站转化漏斗的有效性。

有关您想要通过 标准事件 发送的具体示例

安装

您可以通过 Composer 安装此包

composer require snowsoft/laravel-facebook-pixel

在 Laravel 5.5 及以上版本中,该包将自动注册服务提供者和外观

在 L5.4 及以下版本中,首先注册包的服务提供者和外观

// config/app.php

'providers' => [
    ...
    WebLAgence\LaravelFacebookPixel\LaravelFacebookPixelServiceProvider::class,
],

'aliases' => [
    ...
    'LaravelFacebookPixel' => WebLAgence\LaravelFacebookPixel\LaravelFacebookPixelFacade::class,
],

接下来,发布配置文件

php artisan vendor:publish --provider="WebLAgence\LaravelFacebookPixel\LaravelFacebookPixelServiceProvider"

配置

配置文件相当简单。

return [

    /*
     * The Facebook Pixel id, should be a code that looks something like "XXXXXXXXXXXXXXXX".
     */
    'facebook_pixel_id' => '',
   
    /*
     * Use this variable instead of `facebook_pixel_id` if you need to use multiple facebook pixels
     */
    'facebook_pixel_ids' => [],
    
    /*
     * Enable or disable script rendering. Useful for local development.
     */
    'enabled'           => true,
];

用法

基本示例

首先,您需要包含 Facebook Pixel 的脚本。Facebook 文档建议在 body 标签之后立即这样做。

{{-- layout.blade.php --}}
<html>
  <head>
    @include('facebook-pixel::head')
    {{-- ... --}}
  </head>
  <body>
    @include('facebook-pixel::body')
    {{-- ... --}}
  </body>
</html>

发送像素

在任何时候,您都可以使用以下函数创建一个 标准事件

\LaravelFacebookPixel::createEvent($eventName, $parameters = []);

变更日志

有关最近更改的更多信息,请参阅 变更日志

贡献

有关详细信息,请参阅 贡献

安全性

如果您发现任何与安全相关的问题,请通过电子邮件 jeremy@weblagence.com 而不是使用问题跟踪器。

许可

MIT 许可证 (MIT)。有关更多信息,请参阅 许可文件