如何基于GA4 .NET Core API构建带参数过滤的事件查询请求

要实现按多个事件参数过滤并获取click_sponsored事件的总发生次数，你需要通过组合多条件AND过滤来实现，不需要把事件参数添加到维度（因为你只需要单条总和结果）。以下是完整的代码实现：

完整代码示例 #

// 构建事件名称过滤条件
var eventNameFilter = new Filter
{
    FieldName = "eventName",
    StringFilter = new Filter.Types.StringFilter
    {
        Value = "click_sponsored"
    }
};

// 构建事件参数过滤条件（替换为你的实际参数值）
var clientFilter = new Filter
{
    FieldName = "eventParams.client",
    StringFilter = new Filter.Types.StringFilter
    {
        Value = "你的client参数值"
    }
};

var whateverFilter = new Filter
{
    FieldName = "eventParams.whatever",
    StringFilter = new Filter.Types.StringFilter
    {
        Value = "你的whatever参数值"
    }
};

var blablaFilter = new Filter
{
    FieldName = "eventParams.blabla",
    StringFilter = new Filter.Types.StringFilter
    {
        Value = "你的blabla参数值"
    }
};

// 组合所有AND条件
var filterGroup = new FilterExpressionList
{
    Expressions =
    {
        new FilterExpression { Filter = eventNameFilter },
        new FilterExpression { Filter = clientFilter },
        new FilterExpression { Filter = whateverFilter },
        new FilterExpression { Filter = blablaFilter }
    }
};

var request = new RunReportRequest
{
    Property = "properties/" + "你的GA4属性ID",
    // 不需要维度，因为我们只需要总次数；如果要显示eventName可以保留，但不影响总和
    // Dimensions = { new Dimension { Name = "eventName" }, },
    Metrics = { new Metric { Name = "eventCount" }, },
    MetricAggregations = { MetricAggregation.Total }, // 确保返回总和而非拆分数据
    DateRanges = { new DateRange { StartDate = "2022-08-01", EndDate = "today" }, },
    DimensionFilter = new FilterExpression
    {
        FilterExpressionList = filterGroup
    }
};

关键说明 #

1. 事件参数的过滤字段名：GA4中事件参数的过滤字段格式为eventParams.{paramName}，比如你要过滤的client参数对应字段是eventParams.client，注意参数名要和你上报到GA4的完全一致（大小写敏感）。
2. 多条件AND组合：通过FilterExpressionList的Expressions集合添加所有过滤条件，默认就是AND关系，只有同时满足所有条件的事件才会被统计。
3. 获取单条总和结果：设置MetricAggregations = { MetricAggregation.Total }，即使你保留了维度，也会返回所有符合条件的数据的总和；如果不需要维度，可以直接去掉Dimensions配置，返回结果就是单一的总次数。
4. 结果处理：执行请求后，你可以从返回的RunReportResponse中提取eventCount的数值，格式化为click_sponsored: {数值}即可。

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