如何高效集成Customer.io？使用Composer和printu/customerio轻松实现用户行为追踪与营销自动化

<pre class="brush:php;toolbar:false;">{
    "require": {
        "printu/customerio": "~3.0"
    }
}

<pre class="brush:php;toolbar:false;"><?php
require_once 'vendor/autoload.php';

// 你的应用代码...
?>

<pre class="brush:php;toolbar:false;"><?php
use Customerio\Client;

// 基本配置
$client = new Client('YOUR_API_KEY', 'YOUR_SITE_ID');

// 设置App API Key，用于V2 Track API
$client->setAppAPIKey('YOUR_APP_KEY');

// 如果你的Customer.io账户在欧盟区
// $client = new Client('YOUR_API_KEY', 'YOUR_SITE_ID', ['region' => 'eu']);

?>

<pre class="brush:php;toolbar:false;"><?php
// 创建或更新客户
try {
    $client->customers->add(
        [
            'id' => 1,
            'email' => 'user@example.com',
            'plan' => 'free',
            'created_at' => time()
        ]
    );
    echo "客户添加/更新成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "客户操作失败：" . $e->getMessage() . "\n";
}

// 获取客户信息
try {
    $customer = $client->customers->get(['email' => 'user@example.com']);
    print_r($customer);
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "获取客户失败：" . $e->getMessage() . "\n";
}

// 删除客户
try {
    $client->customers->delete(['id' => 1]);
    echo "客户删除成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "删除客户失败：" . $e->getMessage() . "\n";
}
?>

<pre class="brush:php;toolbar:false;"><?php
// 追踪特定客户的事件
try {
    $client->customers->event(
        [
            'id' => 1,
            'name' => 'product_purchased',
            'data' => [
                'product_id' => 'SKU-123',
                'price' => 99.99
            ]
        ]
    );
    echo "客户事件追踪成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "客户事件追踪失败：" . $e->getMessage() . "\n";
}

// 追踪匿名事件
try {
    $client->events->anonymous(
        [
            'name' => 'website_visited',
            'data' => [
                'page' => '/homepage',
                'referrer' => 'google.com'
            ]
        ]
    );
    echo "匿名事件追踪成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "匿名事件追踪失败：" . $e->getMessage() . "\n";
}
?>

<pre class="brush:php;toolbar:false;"><?php
try {
    $client->page->view(
        [
            'id' => 1,
            'url' => 'http://example.com/pricing',
            'data' => [
                'referrer' => 'http://example.com/features'
            ]
        ]
    );
    echo "页面浏览记录成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "页面浏览记录失败：" . $e->getMessage() . "\n";
}
?>

<pre class="brush:php;toolbar:false;"><?php
// 触发广播活动
try {
    $result = $client->campaigns->trigger(
        [
            'id' => 123, // 你的活动ID
            'data' => [
                'headline' => '新产品发布！',
                'text' => '快来看看我们的最新产品！'
            ],
            'recipients' => [
                'segments' => [
                    'id' => 456 // 目标用户分群ID
                ]
            ]
        ]
    );
    echo "广播活动触发成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "广播活动触发失败：" . $e->getMessage() . "\n";
}
?>

<pre class="brush:php;toolbar:false;"><?php
// V2: 创建或更新一个人实体
try {
    $client->track->entity([
        'type' => 'person',
        'action' => 'identify',
        'identifiers' => [
            'id' => 'user-123',
        ],
        'attributes' => [
            'name' => 'Jane Doe',
            'plan' => 'pro',
            'last_login_at' => time()
        ]
    ]);
    echo "V2 Person实体更新成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "V2 Person实体更新失败：" . $e->getMessage() . "\n";
}

// V2: 批量操作
try {
    $client->track->batch([
        'batch' => [
            [
                'type' => 'person',
                'action' => 'identify',
                'identifiers' => ['id' => 'user-456'],
                'attributes' => ['name' => 'Bob Smith']
            ],
            [
                'type' => 'person',
                'action' => 'event',
                'identifiers' => ['id' => 'user-456'],
                'name' => 'viewed_cart',
                'timestamp' => time(),
                'attributes' => ['item_count' => 3]
            ],
            [
                'type' => 'object',
                'action' => 'identify',
                'identifiers' => [
                    'object_type_id' => 'order',
                    'object_id' => 'ORD-789'
                ],
                'attributes' => ['status' => 'pending', 'total' => 199.99]
            ]
        ]
    ]);
    echo "V2 批量操作成功！\n";
} catch (\GuzzleHttp\Exception\GuzzleException $e) {
    echo "V2 批量操作失败：" . $e->getMessage() . "\n";
}
?>