Web端Firebase SDK获取app_instance_id/client_id用于GA4 API遇格式错误

问题场景 #

想通过Web端Firebase SDK（而非gtag.js）获取可用于GA4 API请求的app_instance_id或client_id，使用firebase/installations的代码获取ID后，在GA4 API验证时触发错误：

description: "Measurement app_instance_id is expected to be a 32 digit hexadecimal number but was [22] digits."
fieldPath: "app_instance_id"
validationCode: "VALUE_INVALID"

原使用代码：

const installationId = await installations.getId(
  installations.getInstallations()
);

问题原因 #

Firebase Installations生成的ID是22位Base64编码格式，而GA4要求的app_instance_id必须是32位十六进制字符串，两者格式不匹配，因此无法通过验证。

解决方法 #

Web端需通过Firebase Analytics SDK的getAppInstanceId()方法获取符合GA4格式要求的ID，代码示例：

// 导入所需模块
import { getAnalytics, getAppInstanceId } from "firebase/analytics";

// 确保已完成Firebase初始化，获取Analytics实例
const analytics = getAnalytics();
// 获取兼容GA4的app_instance_id
const appInstanceId = await getAppInstanceId(analytics);

说明：

• Web场景下，Firebase Analytics的app_instance_id与gtag.js中的client_id为同一值，可直接用于GA4 API请求。
• 需确保使用的Firebase Analytics SDK版本支持getAppInstanceId()方法（建议使用最新稳定版）。

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