如何使用GA4 PHP客户端库按维度FULL_REGEXP过滤？排查无结果问题

你的代码无返回结果的核心问题是正则表达式过滤器的格式错误，具体问题点和修复如下：

1. 正则表达式值的格式错误 #

使用FULL_REGEXP时，value字段只需要写纯正则表达式，不需要带上字段名和==这类运算符。你当前的写法是把GA旧版的过滤器语法套到了GA4 Data API上，两者不兼容。

错误写法：

'value' => 'hostName==www.site.com'

修复后（匹配hostName等于www.site.com的精确值，正则写法需完全匹配）：

'value' => '^www\.site\.com$'

2. 反向匹配的实现方式错误 #

你试图用pageReferrer!~^https:\/\/*实现排除以https://开头的referrer，但GA4 Data API的FULL_REGEXP不支持在value里加!~符号。要实现反向匹配，需要用FilterExpression的not_expression属性包裹过滤器。

同时你的正则存在语法问题：^https:\/\/*中的*是量词，前面的/仅匹配一次，应改成^https://.*来匹配所有以https://开头的字符串。

错误写法：

new FilterExpression([
    'filter' => new Filter([
        'field_name' => 'pageReferrer',
        'string_filter' => new Filter\StringFilter([
            'match_type' => Filter\StringFilter\MatchType::FULL_REGEXP,
            'value' => 'pageReferrer!~^https:\/\/*',
        ])
    ]),
])

修复后：

new FilterExpression([
    'not_expression' => new FilterExpression([
        'filter' => new Filter([
            'field_name' => 'pageReferrer',
            'string_filter' => new Filter\StringFilter([
                'match_type' => Filter\StringFilter\MatchType::FULL_REGEXP,
                'value' => '^https://.*',
            ])
        ]),
    ])
])

完整修复后的代码 #

$request = $client->runReport([
    'property' => 'properties/' . $property_id,
    'dateRanges' => [
        new DateRange([
            'start_date' => "$dateStart",
            'end_date' => "$dateEnd",
        ]),
    ],
    'dimensions' => [
        new Dimension(['name' => 'hostName']),
        new Dimension(['name' => 'pageReferrer']),
    ],
    'metrics' => [
        new Metric(['name' => 'sessions']),
    ],
    'dimensionFilter' => new FilterExpression([
        'and_group' => new FilterExpressionList([
            'expressions' => [
                new FilterExpression([
                    'filter' => new Filter([
                        'field_name' => 'hostName',
                        'string_filter' => new Filter\StringFilter([
                            'match_type' => Filter\StringFilter\MatchType::FULL_REGEXP,
                            'value' => '^www\.site\.com$',
                        ])
                    ]),
                ]),
                new FilterExpression([
                    'not_expression' => new FilterExpression([
                        'filter' => new Filter([
                            'field_name' => 'pageReferrer',
                            'string_filter' => new Filter\StringFilter([
                                'match_type' => Filter\StringFilter\MatchType::FULL_REGEXP,
                                'value' => '^https://.*',
                            ])
                        ]),
                    ])
                ]),
            ]
        ]),
    ]),
]);

额外注意事项 #

• GA4 Data API的FULL_REGEXP使用RE2正则语法，写正则时要符合该语法规范，比如特殊字符（如.）需要转义。
• 如果只是精确匹配hostName，可以不用正则，直接用MatchType::EXACT，效率更高：

  'match_type' => Filter\StringFilter\MatchType::EXACT,
  'value' => 'www.site.com'
  

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