README

salesmachine-php 是一个库，允许您轻松地将数据从您的 PHP 应用程序发送到 SalesMachine.IO。该库可以像以下示例所示，直接使用而无需复杂的配置。

当在流量高的生产环境中使用此库时，您可以使用不同的选项来优化行为。有关更多详细信息，请参阅 生产环境中的使用 和选项章节。

要求

首先，您需要在 SalesMachine.IO 上有一个账户，并拥有有效的 API 凭证。关于您的 PHP 环境的要求相当基本

PHP 5.x
CURL 模块
JSON 模块

快速指南和代码示例

安装

salesmachine-php 客户端库以 Composer 包的形式提供。

初始化 Salesmachine

Salesmachine::init($api_key, $api_secret, array('use_buffer' => true));

创建或更新联系人

Salesmachine::set_contact($contact_uid, array('name' => 'John Doe', 'email' => 'john@doe.com'));

跟踪联系人的页面浏览

Salesmachine::track_pageview($contact_uid, array('/dashboard'));

跟踪联系人的事件

Salesmachine::track_event($contact_uid, 'your event name');

在生产环境中使用 salesmachine-php

虽然默认设置可以让您立即开始使用，但建议为生产环境更改一些设置。

默认情况下，所有对 SalesMachine.IO 的请求都使用 CURL 实时进行。在高流量环境中，这可能会最终导致宿主站点的性能降低。因此建议启用“使用缓冲”选项，该选项将首先将所有请求缓冲到本地文件。

然后，可以使用以下代码通过 cron 作业以常规间隔发送本地缓冲。此方法确保 SalesMachine.IO 库不会降低宿主环境的性能。

将请求存储在本地缓冲区中

Salesmachine::init($api_key, $api_secret, array('use_buffer' => true));
Salesmachine::set_contact($contact_uid, array('name' => 'John Doe', 'email' => 'john@doe.com'));
...

在 cron 作业中处理本地缓冲区

Salesmachine::init($api_key, $api_secret);
Salesmachine::flush();

选项

当调用 Salesmachine::init($api_key, $api_secret) 时，可以作为第三个参数传递一个选项数组。如果此参数不存在或缺少选项键，则使用默认值。

salesmachine-io / salesmachine-php

维护者

详细信息