如何获取Google Marketplace SDK可指定使用的Google Analytics ID

针对此前查阅相关技术问答未找到匹配方案的场景——即基于Google Marketplace SDK开发的扩展程序完成平台审核、生成正式访问URL后，配置适配场景Google Analytics ID的过程中遇到的数据流选型、URL填写问题，两个常见的配置坑可直接按照以下规则规避：

1. Google Sheets扩展程序的数据流类型选择 #

必须选择Web类型的数据流，不需要选择App、智能大屏设备等其他类型的数据流。
Google Sheets扩展的前端交互界面、Workspace Marketplace的应用详情页，均为基于Web标准实现的页面组件，完全适配GA4 Web数据流的事件采集逻辑。其余类型数据流的采集协议是针对原生移动端、大屏端独立应用设计的，和这类嵌入Web场景的埋点规则不兼容，无法正常接收上报的事件数据。

2. Web类型数据流的正确URL填写规则 #

由于Sheets扩展的用户访问链路涉及两个独立的域名域，无法通过单个数据流覆盖全量埋点，需要按照访问场景分别配置对应数据流：

• 针对Workspace Marketplace应用列表页的埋点采集：填写平台根域名workspace.google.com。该域名是所有用户查看应用详情、触发安装操作的统一承载域名，填写根域名即可自动匹配该域名下对应应用详情页的所有子路径，无需填写单个应用页的具体路径。
• 针对Sheets内嵌扩展交互界面的埋点采集：填写Sheets服务的根域名docs.google.com。扩展前端界面是作为嵌入组件挂载在Sheets页面下的子路径，属于docs.google.com域下的资源，配置该根域名的数据流即可正常采集用户在扩展操作界面的所有行为事件。

配置避坑提示

• 不要填写本地调试域名、Google Cloud项目控制台的后台域名，这类域名不在真实用户的访问链路中，配置后无法采集到有效用户行为数据
• 拿到对应数据流的GA4测量ID（格式为G-XXXXXXXXXX）后，需将该ID回填到Marketplace SDK的应用分析配置模块，平台才会自动将应用详情页的浏览、安装、卸载等系统预设事件同步上报到对应的GA数据流中

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