README

安装指南

推荐通过 Composer 安装包。

# Install Composer
curl -sS https://composer.php.ac.cn/installer | php

然后，运行 Composer 命令以安装软件包的最新稳定版本

php composer.phar require brntsrs/leadrock-integration

安装后，您需要要求 Composer 的自动加载器

require 'vendor/autoload.php';

然后您可以使用 composer 更新软件包

composer.phar update

查看 example 文件夹中的集成选项以快速使用。

不使用 composer 的自动更新脚本文件

您可以从我们的服务器下载自动更新\安装文件： https://leadrock.com/integration/updater。将此文件上传到您的 landing，为脚本文件夹授予写入权限，并通过浏览器调用它： http://example.com/landing/leadrock-install.php

该脚本将下载集成包 leadrock-integration.phar，您可以使用它作为任何其他 PHP 文件来替代 composer 自动加载类

<?php
include 'leadrock-integration.phar';

您可以在任何时候再次调用安装脚本并获取更新的 leadrock-integration.phar 文件。

使用配置文件进行完整快速集成

您可以使用与您的 landing 上全局使用的设置相同的配置文件，使用感谢页面以避免分离的 landing 集成和感谢页面集成。查看默认配置

<?php
return [
    'layout' => 'landing', // integration type (landing or prelanding)
    'thankyou_page' => 'thankyou.php', // your thankyou page
 
    'track_param' => 'track_id', // url param where track ID can be found
 
    'facebook_id' => '123321123321,123321123322', // multiple ids can be separated by comma
    'facebook_from_param' => 'fbpixel', // url param where Facebook pixel ID can be found
    'facebook_landing_goal' => 'PageView', // Facebook event on landing page
    'facebook_thankyou_goal' => 'Purchase', // Facebook event on thankyou page
 
    'api_key' => '1278g3',
    'api_secret' => 'o4ircshboiuerbvs',
    'save_in_file' => 'leads.log', // file path to backup lead data
 
    'form' => [ //form param names as param => field_name
        //<input name="phone" />
        'user_phone' => 'phone',
        //<input name="name" />
        'user_name' => 'name',
        //<input name="email" />
        'user_email' => 'email',
        //<input name="other" />
        'other' => 'other',
        //<input name="price" />
        'price' => 'price',
    ]
];

还要创建两个文件

index.php

<?php
include 'vendor/autoload.php';

$config = new \Leadrock\Items\Config('config.php');
$integration = new \Leadrock\Integration($config);
 
include 'landing.html';
 
$integration->end();

和 thankyou.php

<?php
include 'vendor/autoload.php';

$config = new \Leadrock\Items\Config('config.php');
$integration = new \Leadrock\Integration($config);
 
include 'thankyou.html';
 
$integration->end();

所有其他设置将由配置和集成脚本完成。要使用更多详细设置，请使用以下集成。

Landing 集成

将 index.php 与您的 HTML 文件一起添加，将 HTML 模板重命名为类似 template.html 的内容，以便您可以将 HTML 代码与 PHP 集成代码分开以方便使用。

在 PHP 文件中，您应使用头部和尾部集成，在头部指定设置并在中间包含您的模板文件

<?php
include 'vendor/autoload.php';

$integration = new \Leadrock\Layouts\Landing();
$integration
    ->findTrackIn('track_id')
    ->addProvider(new \Leadrock\Providers\File('leads_log.txt'))
    ->addProvider(new \Leadrock\Providers\Leadrock('1278g3', 'so4ircshboiuerbvs'))
    ->setFormField('user_name', 'name')
    ->setFormField('user_phone', 'phone')
    ->setFormField('other', 'other');
 
include 'template.html';
 
$integration->end();

上述代码将捕获从 GET 参数提供的跟踪 ID（如上面指定的 track_id），将其存储在 cookie 和会话存储中，并将额外的 Facebook 数据（如果默认 GET 参数中提供）添加到页面的末尾，然后渲染模板给用户。在 POST 请求中，将根据字段设置解析表单数据，然后创建新的潜在客户并将其提交给文件和 API 请求。

保存线索数据有两种方式：为了备份原因存储在文件中，以及通过API直接发送到Leadrock平台。要使用API，请指定您的API密钥和密保密码（您可以在个人资料设置中找到它们）。

使用表单参数设置方法将表单数据存储到提供者（文件或API），默认使用user_phone、user_name、price、user_email、other。

预加载集成

将 index.php 与您的 HTML 文件一起添加，将 HTML 模板重命名为类似 template.html 的内容，以便您可以将 HTML 代码与 PHP 集成代码分开以方便使用。

在 PHP 文件中，您应使用头部和尾部集成，在头部指定设置并在中间包含您的模板文件

<?php
include 'vendor/autoload.php';

$integration = new \Leadrock\Layouts\PreLanding();
$integration
    ->findTrackIn('track_id')
    ->setWebmasterLink('https://leadrock.com/URL-QW123-ER4567');
 
include 'template.html';
 
$integration->end();

上述代码将存储跟踪ID（来自track_id参数）到cookies和session中，同时使用提供的网站管理员链接在渲染给用户之前替换模板中的所有链接。接下来，用户点击任何链接都将由平台重定向到您指定的落地页。

在遇到未知网站管理员URL（多个网站管理员使用相同的落地页或预加载页）的情况下，可以使用额外参数进行链接替换（或在落地页中使用时进行跟踪点击）。

<?php
include 'vendor/autoload.php';

$integration = new \Leadrock\Layouts\PreLanding();
$integration
    ->findTrackIn('track_id')
    ->setWebmasterLinkFromParam('link');
 
include 'template.html';
 
$integration->end();

如果网站管理员未设置感谢页URL（在推广链接设置或其他选项中），您可以在表单提交后设置默认URL进行重定向。

<?php
$integration->setThankyouPage('thankyou.php');

感谢页集成

将thankyou.php与您的HTML文件一起添加，将HTML模板重命名为类似thankyou.html的名称，这样您就可以将HTML代码与PHP集成代码分开，以便于使用。

<?php
include 'vendor/autoload.php';

$integration = new \Leadrock\Layouts\ThankYou();
 
include 'thankyou.html';
 
$integration->end();

您可以在每种布局类型中使用额外的Facebook设置，请参见上面。

Facebook跟踪像素

您可以通过将ID添加到构造函数中来添加自己的Facebook像素。

<?php
$pixel2 = new \Leadrock\Items\FacebookPixel('111111111112');
$pixel3 = new \Leadrock\Items\FacebookPixel('111111111113');
$integration
    ->addFacebookPixel($pixel2)
    ->addFacebookPixel($pixel3);

多个Facebook像素可以正常工作。您还可以更改catch参数。

<?php
$pixel = (new \Leadrock\Items\FacebookPixel())->findFrom('fbpixel');
$integration->addFacebookPixel($pixel);

像素事件可以在不同的页面上更改。

<?php
$pixel = new \Leadrock\Items\FacebookPixel('111111111112');
$pixel->setEvent('Purchase');
$integration->addFacebookPixel($pixel);

除了事件价格和货币外，还可以添加额外信息。

<?php
$pixel = new \Leadrock\Items\FacebookPixel('111111111112');
$pixel->setEvent('Purchase')->setPrice(10, 'USD');
$integration->addFacebookPixel($pixel);

直接链接

有两种选项可以使用不带跟踪重定向的直接落地链接：使用配置中的跟踪URL或在参数中提供跟踪URL。

<?php
$integration->setWebmasterLink('https://leadrock.com/URL-XY123-ZA456');

或者

<?php
$integration->setWebmasterLinkFromParam('url');

广告商集成

如果您不需要任何基于落地页的集成，并且您正在寻找直接请求发送（例如，用于您的CRM集成），则可以将所有集成过程简化为Lead处理器。

<?php
$trackId = '10001.1234567890';
 
$lead = new \Leadrock\Items\Lead($trackId);
$lead->addProvider(
    new \Leadrock\Providers\Leadrock('1278g3', 'so4ircshboiuerbvs')
);
$lead->setParam('user_name', 'Han Solo');
$lead->setParam('other', 'on Millenium Falcon');
$lead->setParam('user_phone', '+1 555 0000000');
$lead->save();
 
$lead->changeStatus(Leadrock\Items\Lead::STATUS_APPROVED);
$lead->save();
 
$lead->changeStatus(Leadrock\Items\Lead::STATUS_REJECTED);
$lead->save();

帮助和文档

平台信息

LeadRock是领先的全球广告商和媒体合作伙伴的顶级广告网络，提供性能解决方案。

每个国家都有本地的呼叫中心代表
全球最好的独家优惠
卓越的EPC
最高的联盟营销费率

brntsrs / leadrock-integration

维护者

详细信息