pushandmotion/pamsdk-php

此包的最新版本(dev-master)没有提供许可信息。

PAM PHP客户端。

dev-master 2018-08-08 05:16 UTC

This package is not auto-updated.

Last update: 2020-10-11 12:53:16 UTC


README

访问PAM的客户端SDK

要求

  • PHP 5.6.0+

安装

  1. 通过Composer包含库

    $ composer require pushandmotion/pamsdk-php:dev-master
    
  2. 包含Composer自动加载器

    require __DIR__ . '/vendor/autoload.php';

用法

安装PAM脚本(跟踪页面浏览量)

  1. 从您的后端代码创建PAM脚本,并将其输出到HTML中,位于</body>标签之前

    $baseUrl = 'https://<your-pam-website>.com';
    $username = '<your-username>';
    $password = '<your-password>';
    $appId = '<your-app-id>';
    $secret = '<your-app-secret>';
    
    $sdk = new \PAM\Sdk($baseUrl, $username, $password, $appId, $secret);
    $pamScript = $sdk->createTrackingScript(
        [
            'field-1' => 'value-1',
            'field-2' => 'value-2',
            'field-N' => 'value-N',
            'content-tags' => $sdk->createTags(['content-tag1','content-tag2'])
        ]);
  2. 如果您使用某种MVC框架,那么在您的视图中应该有类似的内容(实际代码将取决于您的框架)

    <html>
    <body>
        <h1>Hello, PAM</h1>
    
        {!! $pamScript !!}
    </body>
    </html>
  3. 在HTML页面中安装脚本后,通过检查浏览器加载页面时的网络请求来验证脚本;您将看到带有JSON响应id和sid的POST请求/event调用

    Screen-shot of page-view event post request

表单提交

当您从您的网站接收到表单提交时,您可以通过调用submitForm方法将表单数据转发到PAM。

$result = $sdk->submitForm(
            '1', //formId must match the formId received from PAM backend
            [
                'param-1' => 'value-1',
                'param-2' => 'value-2',
                ...
                'param-N' => 'value-N'
            ]);