如何配置amp-analytics使POST请求体支持PHP的$_POST获取参数

一、AMP页面端配置 #

使用vars定义自定义变量，配合transport.useBody: true将参数放入POST请求体，可根据需求选择JSON或表单编码格式：

方式1：JSON格式请求体（推荐） #

参数结构清晰，适合传递复杂数据：

<amp-analytics type="custom">
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://your-domain.com/analytics-track.php"
      },
      "vars": {
        // 直接引用AMP内置变量
        "pageTitle": "${title}",
        "pageLang": "${lang}",
        "pageUrl": "${canonicalUrl}",
        // 自定义业务变量
        "pageType": "article",
        "siteSection": "tech"
      },
      "triggers": {
        "trackPageLoad": {
          "on": "visible",
          "request": "pageview",
          "transport": {
            "useBody": true,
            "contentType": "application/json"
          }
        }
      }
    }
  </script>
</amp-analytics>

方式2：表单编码格式请求体（兼容$_POST直接读取） #

如果希望PHP端直接通过$_POST获取参数，可设置contentType为表单编码类型：

<amp-analytics type="custom">
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://your-domain.com/analytics-track.php"
      },
      "vars": {
        "pageTitle": "${title}",
        "pageLang": "${lang}",
        "pageType": "article"
      },
      "triggers": {
        "trackPageLoad": {
          "on": "visible",
          "request": "pageview",
          "transport": {
            "useBody": true,
            "contentType": "application/x-www-form-urlencoded"
          }
        }
      }
    }
  </script>
</amp-analytics>

二、PHP后端处理 #

对应JSON格式请求体的处理 #

JSON格式的POST数据不会被PHP自动解析到$_POST，需手动读取解析：

// 读取原始POST内容
$rawPostData = file_get_contents('php://input');
// 解析为关联数组
$analyticsParams = json_decode($rawPostData, true);

// 安全获取参数（带默认值避免报错）
$pageTitle = $analyticsParams['pageTitle'] ?? '';
$pageLang = $analyticsParams['pageLang'] ?? '';
$pageType = $analyticsParams['pageType'] ?? '';

// 后续业务逻辑，比如写入日志或数据库
// file_put_contents('analytics.log', date('Y-m-d H:i:s') . " | {$pageTitle} | {$pageLang}\n", FILE_APPEND);

对应表单编码格式请求体的处理 #

这种情况下PHP会自动解析参数到$_POST，直接读取即可：

$pageTitle = $_POST['pageTitle'] ?? '';
$pageLang = $_POST['pageLang'] ?? '';
$pageType = $_POST['pageType'] ?? '';

// 后续业务逻辑

三、常见问题说明 #

1. 之前vars未生效的原因：

   • 可能是triggers未正确关联对应的request，或vars定义位置错误（需放在<amp-analytics>的JSON配置顶级节点）；
   • 若使用第三方分析类型（如googleanalytics），自定义vars规则不同，自有服务器需指定type="custom"。

2. 关于extraUrlParams：
   该配置原本用于给URL追加查询参数，设置useBody:true时会转为请求体内容，但结构不如vars直观，推荐优先用vars定义自定义参数。

内容的提问来源于stack exchange，提问作者xgretsch