如何在服务端设置Google Analytics（Firebase Analytics）用户属性

可行性结论 #

完全可以实现，目前有两种主流实现路径，分别对应持久化用户属性、临时关联事件属性两种场景，需要配合Google Analytics Admin API或者Measurement Protocol完成操作。

具体操作步骤 #

路径1：持久化设置用户级属性（永久生效，适用于用户标签、用户分层等场景） #

• 前置权限配置：在Google Cloud控制台中找到你的Firebase项目，启用Google Analytics Admin API，同时给Firebase Functions的默认服务账号（格式为<项目ID>@appspot.gserviceaccount.com）授予Analytics Admin Editor角色，避免接口调用权限不足报错。
• 安装依赖库：在你的Firebase Functions项目根目录执行安装命令：
  npm install @google-analytics/admin
• 编写Functions代码示例：

const functions = require('firebase-functions');
const { AnalyticsAdminServiceClient } = require('@google-analytics/admin');
const adminClient = new AnalyticsAdminServiceClient();

// 可以按需选择HTTP触发器或者云函数触发器，这里以可调用云函数为例
exports.setAnalyticsUserProperty = functions.https.onCall(async (data, context) => {
  // 入参从调用方获取，也可以自己在函数内固化逻辑
  const { targetUserId, propertyKey, propertyValue } = data;
  // 替换为你自己的GA4资源ID，可在Firebase Analytics设置页面查询，格式为properties/xxxxxxxxx
  const GA4_RESOURCE_ID = 'properties/123456789';

  await adminClient.createUserProperty({
    parent: GA4_RESOURCE_ID,
    userProperty: {
      name: propertyKey,
      scope: 'USER',
      valueType: 'STRING',
      userPropertyValues: [
        {
          value: propertyValue,
          userFilter: {
            user_id: targetUserId
          }
        }
      ]
    }
  });

  return { success: true };
});

路径2：临时关联用户属性（仅对上报的事件生效，适用于单次事件标记场景） #

如果不需要给用户永久打标签，只需要给特定上报事件关联用户属性，可以直接调用Measurement Protocol完成：

• 首先在Firebase Analytics控制台的「管理」-「数据流」-「Measurement Protocol API密钥」中生成你的API密钥
• 编写函数调用逻辑，上报时附带userProperties字段即可，上报时必须传入对应用户的user_id或者app_instance_id和客户端匹配。

注意事项 #

• 用户属性的key命名不能超过24个字符，value不能超过36个字符，禁止使用firebase_、google_、ga_开头的保留字段作为属性key。
• 路径1设置的持久化用户属性最长需要24小时才能在Analytics报表中生效，实时看板不会立即展示。
• 该方案仅支持GA4属性，已经停止服务的Universal Analytics不支持该操作。

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