通过测量协议将网页浏览事件发送到 GA4 媒体资源

Question

如何使用 PHP 通过测量协议将网页浏览事件发送到 GA4 媒体资源？

这就是我正在做的事情，但在我的 Google Analytics 4 属性中我看不到任何流量。

$data = array(
    'api_secret' => 'XXXX-YYYYY',
    'measurement_id' => 'G-12345678',
    'client_id' => gen_uuid(), // generates a random id
    'events' => array(
      'name' => 'page_view',
      'params' => array(),
    )
);

$url = 'https://www.google-analytics.com/mp/collect';
$content = http_build_query($data);
$content = utf8_encode($content);

$ch = curl_init();
curl_setopt($ch,CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_HTTPHEADER,array('Content-type: application/x-www-form-urlencoded'));
curl_setopt($ch,CURLOPT_HTTP_VERSION,CURL_HTTP_VERSION_1_1);
curl_setopt($ch,CURLOPT_POST, TRUE);
curl_setopt($ch,CURLOPT_POSTFIELDS, $content);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_exec($ch);
curl_close($ch);

Answer 1

我现在正在努力注册综合浏览量来跟踪 API 使用情况，以下是我发现的内容：

XTOTHEL 关于将内容类型设置为上面的 content/json 是正确的。除了指定内容类型之外，您还必须将 JSON 数据作为 CURLOPT_POSTFIELDS 数据发送。

另外，根据他们的规范，api_secret 和measurement_id 需要成为URI 的一部分： https: //developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events ?client_type=gtag#required_pa​​rameters

最后，您可以使用调试模式来验证您的响应，并通过简单地将 URL 更改为google-analytics.com/debug/mp/collect 来了解现在发生的情况

这是我现在正在使用的代码：

//retrieve or generate GA tracking id
            if (empty($_COOKIE['_cid'])) {
                setcookie('_cid', vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex(random_bytes(16)), 4)));
            }
            $data = '{"client_id":"'.$_COOKIE['_cid'].'","events":[{"name":"load_endpoint","params":{"page_location":"'.$request->fullUrl().'"}}]}';
            echo '<pre>';
            print_r($data);

            $measurement_id = 'G-xxxxx';
            $api_secret = 'xxxx';
            $url = 'https://www.google-analytics.com/debug/mp/collect?api_secret='.$api_secret.'&measurement_id='.$measurement_id;
            $ch = curl_init();
            curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
            curl_setopt($ch, CURLOPT_URL, $url);
            curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            curl_close($ch);
            echo $response;

这在一定程度上有效。目前，它将页面视图注册为自定义事件，而不是实际的页面视图。我仍在尝试找出如何让它们以页面浏览的形式出现。

后续经过 更多的调试，我发现页面视图实际上正在工作，它们只是没有显示在某些视图中。解决方法是将 page_title 添加到参数中：

$data = '
{
  "client_id": "'.$_COOKIE['_cid'].'",
  "events": [
    {
      "name": "page_view",
      "params": {
        "page_location": "'.$request->fullUrl().'",
        "page_title": "'.$request->path().'"
      }
    }
  ]
}
';

给接下来的人一些额外的注意事项：

• 调试模式确实为无效的顶级参数（client_id、事件）返回了一些有用的验证错误 - 但它没有为事件“params”内的任何内容返回错误。IE - 我输入“page_asdtitle”而不是“page_title”，它接受得很好。
• 使用调试模式时，我发送的所有测试实际上都没有显示在调试面板中。我怀疑这是因为数据传播延迟，它可能没有加载实时数据。
• 使用 JSON 验证器会有所帮助。确保您在 GA 告诉您的地方使用对象和数组。
• 如果您无法弄清楚为什么 PHP 代码不起作用，请使用 JavaScript 将代码编写为浏览器事件，然后在浏览器中运行它。有大量关于如何做到这一点的示例。从那里，您可以使用开发工具 -> 网络来检查请求。如果您右键单击“收集”端点的 Google Analytics 请求，您将看到一个将请求复制为 CURL 的选项。将其放入文本编辑器中，并将其与 PHP 代码发送的内容进行比较。
• 要在没有大量传播延迟的情况下实际测试这一点，您可以登录 Google Analytics，转到“报告”->“实时”，如果正常工作，您应该会看到数据在 30-60 秒内显示。如果您使用 /debug/ 端点，则不会显示实时数据。