GA4 Report API PHP客户端添加过滤器触发致命错误求助

错误信息 #

Fatal error: Uncaught Exception: Expect Google\Analytics\Data\V1beta\Filter\StringFilter. in /home/Server1/xagyrxxhed/public_html/vendor/google/protobuf/src/Google/Protobuf/Internal/GPBUtil.php:198 Stack trace: #0 /home/Server1/xagyrxxhed/public_html/vendor/google/analytics-data/src/V1beta/Filter.php(116): Google\Protobuf\Internal\GPBUtil::checkMessage() #1 /home/Server1/xagyrxxhed/public_html/vendor/google/protobuf/src/Google/Protobuf/Internal/Message.php(1082): Google\Analytics\Data\V1beta\Filter->setStringFilter() #2 /home/Server1/xagyrxxhed/public_html/vendor/google/protobuf/src/Google/Protobuf/Internal/Message.php(80): Google\Protobuf\Internal\Message->mergeFromArray() #3 /home/Server1/xagyrxxhed/public_html/vendor/google/analytics-data/src/V1beta/Filter.php(54): Google\Protobuf\Internal\Message->__construct() #4 /home/Server1/xagyrxxhed/public_html/quickstart.php(280): Google\Analytics\Data\V1beta\Filter->__construc in /home/Server1/xagyrxxhed/public_html/vendor/google/protobuf/src/Google/Protobuf/Internal/GPBUtil.php on line 198

问题分析 #

你的代码存在两处关键错误：

• 维度参数格式错误：dimensions字段被拆分为两个独立数组，GA4 API要求该字段是包含所有维度实例的单一数组
• 过滤器对象嵌套错误：string_filter被包裹在数组中传递，但API期望直接传入StringFilter对象实例，而非数组包裹形式

修正后的完整代码 #

require 'vendor/autoload.php';

use Google\Analytics\Data\V1beta\BetaAnalyticsDataClient;
use Google\Analytics\Data\V1beta\OrderBy;
use Google\Analytics\Data\V1beta\OrderBy\MetricOrderBy;
use Google\Analytics\Data\V1beta\DateRange;
use Google\Analytics\Data\V1beta\Dimension;
use Google\Analytics\Data\V1beta\Metric;
use Google\Analytics\Data\V1beta\Filter;
use Google\Analytics\Data\V1beta\Filter\StringFilter;
use Google\Analytics\Data\V1beta\FilterExpression;
use Google\Analytics\Data\V1beta\Filter\StringFilter\MatchType;

$property_id = XXXX;
// 补充客户端初始化逻辑（需确保已完成GA4认证配置）
$client = new BetaAnalyticsDataClient();

$response_cpc = $client->runReport([
    'property' => 'properties/' . $property_id,
    'dateRanges' => [
        new DateRange([
            'start_date' => $_GET["date"],
            'end_date' => $_GET["date"],
        ]),
    ],
    // 修正：将两个Dimension实例合并到同一个数组中
    'dimensions' => [
        new Dimension(['name' => 'firstUserSourceMedium']),
        new Dimension(['name' => 'firstUserCampaignName'])
    ],
    'metrics' => [
        new Metric(['name' => 'sessions']),
        new Metric(['name' => 'bounceRate']),
        new Metric(['name' => 'conversions:Newsletter_signup']),
        new Metric(['name' => 'screenPageViewsPerSession']),
        new Metric(['name' => 'transactions']),
        new Metric(['name' => 'conversions:go_to_amazon'])
    ],
    // 修正：直接传入StringFilter实例，去掉多余的数组包裹
    'dimensionFilter' => new FilterExpression([
        'filter' => new Filter([
            'field_name' => 'firstUserSourceMedium',
            'string_filter' => new StringFilter([
                'match_type' => MatchType::BEGINS_WITH,
                'value' => 'cpc',
                'case_sensitive'=> false,
            ])
        ])
    ]),
    'limit'=> 25,
    'orderBys' =>[ 
        new OrderBy([
            'metric' => new MetricOrderBy(['metric_name' =>'sessions']),
            'desc'=>true,
        ])
    ],
]);

print_r($response_cpc);

额外说明 #

原代码中缺少$client的初始化逻辑，需确保你已通过服务账号密钥等方式完成GA4 API的认证配置，否则会触发新的未初始化错误。

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