进阶 docs.writesonic.com 2026-10-09 08:02:29 · 0 阅读
第54章 Writesonic GEO 与 Looker Studio 集成指南
Writesonic GEO 与 Looker Studio 集成：连接你的 AI 搜索可见性数据至 Google Looker Studio
什么是 Writesonic GEO 存在连接器？
Google Looker Studio 的 Writesonic GEO 存在连接器允许你将 AI 搜索可见性数据直接导入 Looker Studio。你可以利用来自 ChatGPT、Perplexity、Claude 和 Gemini 等 AI 平台的品牌表现数据，创建自定义 BI 仪表板和报告。
功能亮点
实时数据访问：直接连接你的 GEO 存在项目，获取最新可见性指标
自定义可视化：创建符合报告需求的图表、图形和数据表
团队协作：与利益相关者及团队成员共享仪表板
快速开始
准备工作：
拥有具备 GEO 存在访问权限的 Writesonic 账户
你的企业 API 密钥
拥有 Looker Studio 访问权限的 Google 账户
步骤 1：访问连接器
打开 Looker Studio
点击 创建 → 数据源
在连接器库中搜索 Writesonic GEO 存在
步骤 2：授权连接
点击“授权”开始身份验证
如提示，请使用你的 Google 账户登录
授予必要的权限
步骤 3：配置数据源
输入来自 Writesonic 的 API 密钥
输入你的站点 URL——必须与 GEO 存在项目仪表板中显示的站点 URL 完全匹配，确保是精确匹配。
示例：
如果仪表板显示 https://example.com/，请输入 https://example.com/
如果仪表板显示 https://example.com，请输入 https://example.com。 两者被视为不同的值。不匹配将导致错误。 选择 1 个或多个数据源 第 4 步：连接与验证 点击 CONNECT 查看可用字段 点击 CREATE REPORT/EXPORT 开始构建 了解数据源 该连接器提供 10 个数据源的访问权限： 性能数据源（需要日期范围） 网站整体性能——按网站汇总跟踪品牌表现指标，包括随时间变化的总提示数、提及次数、可见性得分和排名。 提示性能——分析单个提示的性能指标，展示哪些查询在 AI 平台（如 ChatGPT、Claude、Gemini 等）中驱动了最多的可见性和提及。 单个 AI 回复——访问完整的 AI 生成回复，包括全文、品牌提及、平台详情和竞争背景。 内容数据源（需要日期范围） 内容引用与来源——发现 AI 平台引用为来源的网站和域名，包括引用 URL、域名及相关品牌提及。 关键词性能指标——从 AI 回复中提取关键词和主题，以了解哪些术语和话题与你的品牌相关联。 配置数据源（无需日期） 可用主题——所有用于组织提示和按主题分析性能的主题类别参考数据。 可用平台——正在追踪的 AI 平台和模型（ChatGPT、Claude、Gemini 等）的参考数据。 追踪网站——所有正在监控的网站（包括你自己的网站和竞争对手）的参考数据，包括 logo 和网站类型等元数据。 提示信息——所有已配置提示及其主题、标签、状态和国家代码的参考数据。 可用标签——用于组织和过滤提示的所有标签参考数据。 Looker Studio 中的维度是什么？ 维度是用于分组、过滤或细分数据的分类或描述性字段。维度不会被聚合；它们代表属性或类别。 维度的特征： 用于分组和过滤（例如，按日期、类别、名称） 不被聚合（文本、日期、ID、类别） 出现在图表的行、列或过滤器中 用于细分指标 来自你的连接器的示例 日期——按日期对数据进行分组 Performance Website Name——按网站分组 Performance Topic Name——按主题分组 Answer Platform Name——按 AI 平台分组 Prompt Type——将提示细分为“品牌化”或“非品牌化” Config Website Is Self——布尔过滤器 Looker Studio 中的指标是什么？ 指标是可以被聚合（求和、平均、计数等）的数值字段。
指标表示可量化的数值，用于衡量表现、分析趋势及计算统计数据。 指标的特征包括： 属于可聚合的数值（如求和、平均值、计数、最小值、最大值） 用于衡量表现、数量或计算值 在图表中作为数值呈现（Y 轴数值、表格数值、图表数据点） 可按维度进行细分以分析模式 指标可以通过多种方式进行聚合。 连接器示例 Performance Total Prompts —— 分析提示词的数量 Performance Total Mentions —— 品牌提及总数 Performance Visibility Score —— 可见度百分比（0-100） Performance Rank —— 平均排名位置 Performance Avg Visibility Score —— 跨模型的平均可见度 维度与指标：它们的用途有何不同？ 维度 定义 —— 类别性或描述性字段（文本、日期、ID、布尔值） 目的 —— 对数据进行分组、过滤和分片 呈现位置 —— 行/列表头、过滤器控件、图表轴（X 轴） 示例 —— Performance Website Name 按网站分组数据 指标 定义 —— 可聚合的数值字段（求和、平均值、计数等） 目的 —— 衡量表现、数量或计算值 呈现位置 —— 表格数值、图表数据点、Y 轴数值、记分卡 示例 —— Performance Total Mentions 统计提及发生的次数 协同工作机制 维度提供背景和类别（例如“按网站”或“按日期”） 指标提供可量化的结果（例如“总提及数”或“可见度评分”） 示例：在 X 轴使用 Performance Website Name（维度），在 Y 轴使用 Performance Total Mentions（指标）的图表展示了每个网站的提及数量，从而支持表现对比和趋势分析。 Writesonic GEO 连接器的完整维度参考 关于元字段（Meta Fields） 在下文的维度表中，你会看到部分字段标记为（meta field）。元字段指包含数据本身信息的字段，例如用于连接数据源的唯一标识符或用于跟踪时间戳。 通用维度（适用于所有数据源） | 字段类型 | 描述 | 用例 | 数据源类型 | | :--- | :--- | :--- | :--- | | Text | 标识数据来源的端点 | 在混合报告中过滤以显示特定数据类型 | Date | | Date (YYYYMMDD) | 指标数据的日期 | 时间序列图表、趋势分析、日期对比 | Last Refresh Time | | DateTime | 数据从 API 最后获取的时间。由 Looker Studio 添加 | 监控数据新鲜度，排查同步问题 | | 整体网站性能维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Performance Website ID (meta field) | Text | 网站的唯一标识符 | 可用于将图表与其他数据源（如引用视图）连接 | | Performance Website Name | Text | 品牌或网站名称 | 按品牌分组指标，比较自身与竞争对手 | | Performance Website URL | URL | 完整的网站 URL | 用于查看域名及/或网站的完整链接 | 提示词性能维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Performance Prompt ID (meta field) | Text | 提示词的唯一标识符 | 可用于与 Prompts Information 连接以查看提示词的详细信息 | | Performance Prompt Text | Text | 实际的 AI 查询文本 | 识别哪些问题驱动了可见度 | | Performance Topic ID | Text | 主题类别标识符 | 可用于与主题配置数据连接以查看特定主题 | | Performance Topic Name | Text | 人类可读的主题名称 | 按主题类别分组分析 | | Performance Prompt Tags | Text | 逗号分隔的标签列表 | 通过标签过滤以查看你希望看到的具体提示词 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | 按提示词类型过滤或分组，以对比品牌与非品牌表现 | 单个 AI 响应维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Answer Response ID (meta field) | Text | AI 响应的唯一标识符 | 跟踪单个响应 | | Answer Prompt | Text | 生成该响应的提示词 | 查看具体的问题和答案 | | Answer Platform ID | Text | AI 平台标识符 | 与平台配置数据连接 | | Answer Platform Name | Text | 提供商名称（如 OpenAI、Anthropic 等） | 跨提供商对比表现 | | Answer Platform | Text | 具体模型 | 分析哪些模型提及了你的品牌 | | Answer Topic ID | Text | 关联的主题标识符 | 可用于在其他数据源中按主题分组（meta field） | | Answer Topic | Text | 主题名称 | 分类分析 | | Answer AI Response | Text | 完整的 LLM 响应文本 | 阅读实际的 AI 生成内容 | | Answer Brand Mentions | Text | 包含排名的品牌提及摘要 | 快速了解竞争格局 | | Answer Prompt Tags | Text | 与提示词关联的标签 | 活动策略过滤 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | 按提示词类型过滤或分组，以对比品牌与非品牌表现 | 内容引用与来源维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Citation ID (meta field) | Text | 引用的唯一标识符 | 可用于与 Tracked Websites 视图连接以获取更多引用信息 | | Citation Title | Text | 被引用来源的页面标题 | 识别哪些内容被引用 | | Citation URL | URL | 引用的完整 URL | 查看引用的完整来源链接 | | Citation Domain | Text | 引用的域名 | 域名级别的引用视图 | | Citation First Seen | DateTime | 首次检测到引用的时间 | 该特定引用发生的时间戳 | | Citation Mentioned Websites | Text | 提及的品牌 | 查看哪些品牌一起出现 | | Citation Responses | Text | 使用了该引用的响应 | 理解 AI 响应中的引用情况 | 关键词性能指标维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Keyword ID (meta field) | Text | 关键词的唯一标识符 | 跟踪特定关键词 | | Keyword | Text | 提取的关键词或短语 | 识别重要关键词 | | Theme | Text | 高层级主题类别 | 主题分析 | | Sub-theme | Text | 更具体的子类别 | 详细的内容分析 | | Keyword First Seen | DateTime | 首次检测到关键词的时间 | 跟踪关键词首次出现的时间 | | Keyword Responses | Text | 关键词出现时的上下文 | 理解关键词用法及其出现的相干上下文 | 配置维度 可用主题 | 字段类型 | 描述 | | :--- | :--- | | Config Topic ID (meta field) | Text | 唯一主题标识符 | | Config Topic Name | Text | 主题显示名称 | | Config Topic Created At | DateTime | 创建时间戳 | | Config Topic Updated At | DateTime | 最后修改时间戳 | 可用平台 | 字段类型 | 描述 | | :--- | :--- | | Config Platform ID (meta field) | Text | 唯一平台标识符 | | Config Platform Name | Text | 模型名称 | | Config Platform Provider | Text | 提供商（如 OpenAI、Anthropic 等） | | Config Platform Category ID | Text | 平台类别标识符 | | Config Platform Category | Text | 类别名称 | 受跟踪网站 | 字段类型 | 描述 | | :--- | :--- | | Config Website ID (meta field) | Text | 唯一网站标识符 | | Config Website Name | Text | 品牌/网站名称 | | Config Website URL | URL | 网站 URL | | Config Website Is Competitor | Boolean | 如果是竞争对手则为 True | | Config Website Is Self | Boolean | 如果是你自己的网站则为 True | | Config Website Logo URL | URL | 品牌标志 URL | | Config Website Created At (meta field) | DateTime | 创建时间戳 | | Config Website Updated At (meta field) | DateTime | 更新时间戳 | 提示词信息 | 字段类型 | 描述 | | :--- | :--- | | Config Prompt ID (meta field) | Text | 唯一提示词标识符 | | Config Prompt Text | Text | 完整提示词文本 | | Config Prompt Topic ID | Text | 关联主题 | | Config Prompt Topic | Text | 主题名称 | | Config Prompt Country Code | Text | 市场/地区代码 | | Config Prompt Status | Text | 提示词状态（如 ACTIVE 等） | | Config Prompt Tags | Text | 关联标签 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | | Config Prompt Created At (meta field) | DateTime | 创建时间戳 | | Config Prompt Updated At (meta field) | DateTime | 更新时间戳 | 可用标签 | 字段类型 | 描述 | | :--- | :--- | | Tag ID (meta field) | Text | 唯一标签标识符 | | Tag Name | Text | 标签显示名称 | | Tag Slug | Text | URL 安全的标签标识符 | | Tag Prompt Count | Number | 具有此标签的提示词数量 | | Tag Created At (meta field) | DateTime | 创建时间戳 | | Tag Updated At (meta field) | DateTime | 更新时间戳 | 完整指标参考 性能摘要指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Performance Total Prompts | Number | 针对该网站分析的提示词总数 | 越高越好（覆盖范围更广） | 跟踪问题量的趋势 | | Performance Total Results | Number | 收到的成功 AI 响应数 | 应接近 Total Prompts | 监控数据完整性 | | Performance Total Mentions | Number | 你的品牌被提及的次数 | 越高越好 | 品牌可见度的关键 KPI | | Performance Visibility Score | Number (0-100) | 提及品牌的响应百分比 | 60% 以上为优秀，40-60% 为良好 | 主要成功指标 | | Performance Rank | Number | 被提及时的平均位置（1 为第一） | 越低越好（1-3 为理想） | 在 AI 响应中的显著度 | 计算说明 Visibility Score —— (Total Mentions / Total Results) × 100 Rank —— 在所有提及中取平均值（仅当品牌被提及时才计数） 性能提示词指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Performance Total Platforms | Number | 作出响应的 AI 模型数量 | 越高越好 | 跨平台触达分析 | | Performance Prompt Total Mentions | Number | 该特定提示词的总提及数 | 因提示词类型而异 | 识别表现优异的问题 | | Performance Avg Visibility Score | Number (0-100) | 跨所有平台的平均可见度 | 50% 以上为强劲 | 提示词级别的绩效跟踪 | | Performance Avg Rank | Number | 跨平台的平均排名 | 1-3 为优秀 | 提示词显著度分析 | 性能回答指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Answer Brand Mention Count | Number | 响应中提及的品牌数量 | 取决于策略 | 每个响应的竞争格局 | | Answer Avg Rank | Number | 你品牌的平均排名 | 1-3 为优秀 | 响应级别的显著度 | | Answer Avg Visibility Score | Number (0-100) | 0 或 100（未提及或提及） | 100 为良好 | 二元提及跟踪 | 内容引用指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Citation Response Count | Number | 使用此引用的响应数量 | 越高 = 权威性越强 | 来源权威性排名 | | Citation Mentioned Website Count | Number | 引用内容中提及的品牌数量 | 因内容而异 | 内容共提及分析 | 内容关键词指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Keyword Response Count | Number | 该关键词在响应中出现的次数 | 越高 = 相关主题越强 | 主题相关性跟踪 | 配置指标 | 指标 | 类型 | 描述 | | :--- | :--- | :--- | | Tag Prompt Count | Number | 标记为此标签的提示词数量 | 指标趋势 Metric Trends 是一个时间序列数据源，针对你整个受跟踪的竞争集合，返回每个（日期 × 网站）的一行数据。与 Performance Summary（仅针对你自己的网站）不同，Metric Trends 展示了你的品牌及每位竞争对手在可见度、声量份额、引用份额、提及数和排名上的每日变化。日期是必需的。该数据源由日期驱动——始终在报告或数据源上设置日期范围，否则数据源将返回错误。 适用场景 跟踪你的可见度或排名随时间的变化 在单一共享指标上对比你的品牌与竞争对手 为部分对整体指标（声量份额、引用份额）构建堆叠面积图/堆叠柱状图 竞争定位气泡图（“谁在哪里？”） 维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Date | Date | 记录指标的日期 | 所有时间序列图表的 X 轴 | | Trends Website ID | Text | 网站的唯一标识符 | 与 Config Websites / Tracked Websites 连接 | | Trends Website Name | Text | 品牌/网站显示名称 | 拆分系列的细分维度，按品牌划分 | | Trends Website URL | URL | 网站 URL | 链接输出和分组 | 指标 | 指标 | 类型 | 聚合方式 | 描述 | 良好表现标准 | | :--- | :--- | :--- | :--- | :--- | | Trends Visibility Score | Number (0–100) | AVG | 当天提及品牌的响应百分比 | 越高越好（60% 以上为优秀） | | Trends Share of Voice | Number | AVG | 品牌在受跟踪集合中总提及的份额 | 越高越好 | | Trends Citation Share | Number | AVG | 品牌在受跟踪集合中引用的份额 | 越高越好 | | Trends Mentions Count | Number | SUM | 品牌被提及的总次数 | 越高越好 | | Trends Rank | Number | AVG | 被提及时的平均位置（1 为第一） | 越低越好（1–3 为理想） | | Trends Total Results | Number | SUM | 当天分析的 AI 响应总数 | 其他指标的上下文背景 | 提示 —— 反转 Rank：由于较低的 Rank 更好，请反转坐标轴（或使用计算字段 0 - Trends Rank），以便在图表中改进趋势向上显示。 数据关系及如何协同使用 连接数据源 将 Performance Summary 与 Website Config 连接 Performance Website ID → Config Website ID 获取绩效数据的品牌名称、标志、竞争对手标记和 URL。 将 Performance Prompts 与 Topic Config 连接 Performance Topic ID → Config Topic ID 使用完整主题元数据丰富提示词绩效。 将 Answers 与 Platforms 连接 Answer Platform ID → Config Platform ID 获取详细的平台信息（提供商、类别）以用于响应分析。 创建你的第一份报告 快速入门：高管仪表板 让我们构建一个回答“我们的 AI 可见度表现如何？”的仪表板。 步骤 1：创建数据源 在 Looker Studio 中，点击 Create → Data source 搜索 Writesonic GEO Presence 使用你的 API key 和 Site URL 进行配置 选择相关的数据源 点击 CONNECT 步骤 2：创建新报告 点击 CREATE REPORT 打开报告编辑器。 步骤 3：添加关键绩效记分卡（示例） 可见度评分卡 添加图表 → 记分卡 指标：Performance Visibility Score 日期范围维度：Date 故障排除 常见问题 “Invalid API Key” 或 “401 Unauthorized” 验证你从 Writesonic 仪表板获取的 API key 确保你使用的是具有 GEO Presence 访问权限的 Business API key 检查复制 key 时是否有额外的空格 “Site URL Not Found” 或 “404 Error” Site URL 必须与 GEO Presence 仪表板中显示的完全一致 —— 包括末尾是否有斜杠。
例如，https://example.com/ 和 https://example.com 被视为不同网址。 请确保该网站已在你的 GEO Presence 项目中激活。 复制网址时，注意检查是否包含多余空格。 “无数据可用”或报告为空 检查日期范围：尝试“最近7天”以确认数据是否存在 移除或放宽筛选条件进行测试 验证数据源选择（Config 数据源无需日期） 检查 GEO Presence 仪表板的数据可用性 “连接超时”或加载缓慢 将日期范围缩短至 1-3 天 选择较少的数据源 使用数据提取（Data → Extract data）进行历史分析 限制每页可视化数量（最多 6-8 个） 数据未刷新 手动刷新：Data 菜单 → Refresh data 检查 Last Refresh Time 字段以验证数据时效 等待 5-10 分钟，让 API 缓存过期 获取支持 技术支持 — 邮箱：[email protected]
包含信息：错误详情、账户邮箱、网站网址（勿包含 API 密钥） 销售/企业客户 — 邮箱：[email protected] 常见问题 问：数据更新频率如何？
答：每当新的 prompts 被执行并收集到 AI 响应时，数据即会更新。为保障性能，连接器使用缓存（5-10 分钟）。 问：为何某些 prompts 的可见性显示为 0%？
答：因为在该 prompt 的任何 AI 响应中均未提及你的品牌。这是识别内容缺口的宝贵数据。 问：“Total Mentions”和“Prompt Total Mentions”有什么区别？
答：“Total Mentions”是网站级别（Summary），而“Prompt Total Mentions”是 prompt 级别（Prompts 数据源）。 问：能否在一个报告中跟踪多个网站？
答：可以，但每个数据源仅连接一个网站网址。请创建多个数据源并进行混合。 问：排名值是否考虑竞争对手？
答：是的，排名反映该品牌在响应中所有被提及品牌中的位置。 问：为何竞争对手的可见性得分更高？
答：这指明了机遇所在。分析其被引用的内容和主题，以指导你的策略。 问：能否导出原始数据？
答：可以，使用 Looker Studio 的导出功能，或直接查询 API 获取原始 JSON/CSV。 问：如何计算声量份额（Share of Voice）？
答：你的 Mentions / SUM(All Website Mentions) - 创建此计算字段。 问：“Config Website Is Self = True”是什么意思？
答：它在网站配置中用于识别你的网站与竞争对手。 问：“Prompt Type”维度是什么？
A：Prompt Type 字段将每个提示词分为“品牌类”（直接提到你的品牌名）或“非品牌类”（泛行业查询）。该字段可用于 Prompt Performance、Individual AI Responses 和 Prompts Information 数据源。借助它，你可以对比品牌在被直接问及时与被自然发现时的表现差异。 如需高级功能和企业级集成，请联系 [email protected] 更新于 4 个月前 这个页面对你有帮助吗？
如果仪表板显示 https://example.com，请输入 https://example.com。 两者被视为不同的值。不匹配将导致错误。 选择 1 个或多个数据源 第 4 步：连接与验证 点击 CONNECT 查看可用字段 点击 CREATE REPORT/EXPORT 开始构建 了解数据源 该连接器提供 10 个数据源的访问权限： 性能数据源（需要日期范围） 网站整体性能——按网站汇总跟踪品牌表现指标，包括随时间变化的总提示数、提及次数、可见性得分和排名。 提示性能——分析单个提示的性能指标，展示哪些查询在 AI 平台（如 ChatGPT、Claude、Gemini 等）中驱动了最多的可见性和提及。 单个 AI 回复——访问完整的 AI 生成回复，包括全文、品牌提及、平台详情和竞争背景。 内容数据源（需要日期范围） 内容引用与来源——发现 AI 平台引用为来源的网站和域名，包括引用 URL、域名及相关品牌提及。 关键词性能指标——从 AI 回复中提取关键词和主题，以了解哪些术语和话题与你的品牌相关联。 配置数据源（无需日期） 可用主题——所有用于组织提示和按主题分析性能的主题类别参考数据。 可用平台——正在追踪的 AI 平台和模型（ChatGPT、Claude、Gemini 等）的参考数据。 追踪网站——所有正在监控的网站（包括你自己的网站和竞争对手）的参考数据，包括 logo 和网站类型等元数据。 提示信息——所有已配置提示及其主题、标签、状态和国家代码的参考数据。 可用标签——用于组织和过滤提示的所有标签参考数据。 Looker Studio 中的维度是什么？ 维度是用于分组、过滤或细分数据的分类或描述性字段。维度不会被聚合；它们代表属性或类别。 维度的特征： 用于分组和过滤（例如，按日期、类别、名称） 不被聚合（文本、日期、ID、类别） 出现在图表的行、列或过滤器中 用于细分指标 来自你的连接器的示例 日期——按日期对数据进行分组 Performance Website Name——按网站分组 Performance Topic Name——按主题分组 Answer Platform Name——按 AI 平台分组 Prompt Type——将提示细分为“品牌化”或“非品牌化” Config Website Is Self——布尔过滤器 Looker Studio 中的指标是什么？ 指标是可以被聚合（求和、平均、计数等）的数值字段。
指标表示可量化的数值，用于衡量表现、分析趋势及计算统计数据。 指标的特征包括： 属于可聚合的数值（如求和、平均值、计数、最小值、最大值） 用于衡量表现、数量或计算值 在图表中作为数值呈现（Y 轴数值、表格数值、图表数据点） 可按维度进行细分以分析模式 指标可以通过多种方式进行聚合。 连接器示例 Performance Total Prompts —— 分析提示词的数量 Performance Total Mentions —— 品牌提及总数 Performance Visibility Score —— 可见度百分比（0-100） Performance Rank —— 平均排名位置 Performance Avg Visibility Score —— 跨模型的平均可见度 维度与指标：它们的用途有何不同？ 维度 定义 —— 类别性或描述性字段（文本、日期、ID、布尔值） 目的 —— 对数据进行分组、过滤和分片 呈现位置 —— 行/列表头、过滤器控件、图表轴（X 轴） 示例 —— Performance Website Name 按网站分组数据 指标 定义 —— 可聚合的数值字段（求和、平均值、计数等） 目的 —— 衡量表现、数量或计算值 呈现位置 —— 表格数值、图表数据点、Y 轴数值、记分卡 示例 —— Performance Total Mentions 统计提及发生的次数 协同工作机制 维度提供背景和类别（例如“按网站”或“按日期”） 指标提供可量化的结果（例如“总提及数”或“可见度评分”） 示例：在 X 轴使用 Performance Website Name（维度），在 Y 轴使用 Performance Total Mentions（指标）的图表展示了每个网站的提及数量，从而支持表现对比和趋势分析。 Writesonic GEO 连接器的完整维度参考 关于元字段（Meta Fields） 在下文的维度表中，你会看到部分字段标记为（meta field）。元字段指包含数据本身信息的字段，例如用于连接数据源的唯一标识符或用于跟踪时间戳。 通用维度（适用于所有数据源） | 字段类型 | 描述 | 用例 | 数据源类型 | | :--- | :--- | :--- | :--- | | Text | 标识数据来源的端点 | 在混合报告中过滤以显示特定数据类型 | Date | | Date (YYYYMMDD) | 指标数据的日期 | 时间序列图表、趋势分析、日期对比 | Last Refresh Time | | DateTime | 数据从 API 最后获取的时间。由 Looker Studio 添加 | 监控数据新鲜度，排查同步问题 | | 整体网站性能维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Performance Website ID (meta field) | Text | 网站的唯一标识符 | 可用于将图表与其他数据源（如引用视图）连接 | | Performance Website Name | Text | 品牌或网站名称 | 按品牌分组指标，比较自身与竞争对手 | | Performance Website URL | URL | 完整的网站 URL | 用于查看域名及/或网站的完整链接 | 提示词性能维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Performance Prompt ID (meta field) | Text | 提示词的唯一标识符 | 可用于与 Prompts Information 连接以查看提示词的详细信息 | | Performance Prompt Text | Text | 实际的 AI 查询文本 | 识别哪些问题驱动了可见度 | | Performance Topic ID | Text | 主题类别标识符 | 可用于与主题配置数据连接以查看特定主题 | | Performance Topic Name | Text | 人类可读的主题名称 | 按主题类别分组分析 | | Performance Prompt Tags | Text | 逗号分隔的标签列表 | 通过标签过滤以查看你希望看到的具体提示词 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | 按提示词类型过滤或分组，以对比品牌与非品牌表现 | 单个 AI 响应维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Answer Response ID (meta field) | Text | AI 响应的唯一标识符 | 跟踪单个响应 | | Answer Prompt | Text | 生成该响应的提示词 | 查看具体的问题和答案 | | Answer Platform ID | Text | AI 平台标识符 | 与平台配置数据连接 | | Answer Platform Name | Text | 提供商名称（如 OpenAI、Anthropic 等） | 跨提供商对比表现 | | Answer Platform | Text | 具体模型 | 分析哪些模型提及了你的品牌 | | Answer Topic ID | Text | 关联的主题标识符 | 可用于在其他数据源中按主题分组（meta field） | | Answer Topic | Text | 主题名称 | 分类分析 | | Answer AI Response | Text | 完整的 LLM 响应文本 | 阅读实际的 AI 生成内容 | | Answer Brand Mentions | Text | 包含排名的品牌提及摘要 | 快速了解竞争格局 | | Answer Prompt Tags | Text | 与提示词关联的标签 | 活动策略过滤 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | 按提示词类型过滤或分组，以对比品牌与非品牌表现 | 内容引用与来源维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Citation ID (meta field) | Text | 引用的唯一标识符 | 可用于与 Tracked Websites 视图连接以获取更多引用信息 | | Citation Title | Text | 被引用来源的页面标题 | 识别哪些内容被引用 | | Citation URL | URL | 引用的完整 URL | 查看引用的完整来源链接 | | Citation Domain | Text | 引用的域名 | 域名级别的引用视图 | | Citation First Seen | DateTime | 首次检测到引用的时间 | 该特定引用发生的时间戳 | | Citation Mentioned Websites | Text | 提及的品牌 | 查看哪些品牌一起出现 | | Citation Responses | Text | 使用了该引用的响应 | 理解 AI 响应中的引用情况 | 关键词性能指标维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Keyword ID (meta field) | Text | 关键词的唯一标识符 | 跟踪特定关键词 | | Keyword | Text | 提取的关键词或短语 | 识别重要关键词 | | Theme | Text | 高层级主题类别 | 主题分析 | | Sub-theme | Text | 更具体的子类别 | 详细的内容分析 | | Keyword First Seen | DateTime | 首次检测到关键词的时间 | 跟踪关键词首次出现的时间 | | Keyword Responses | Text | 关键词出现时的上下文 | 理解关键词用法及其出现的相干上下文 | 配置维度 可用主题 | 字段类型 | 描述 | | :--- | :--- | | Config Topic ID (meta field) | Text | 唯一主题标识符 | | Config Topic Name | Text | 主题显示名称 | | Config Topic Created At | DateTime | 创建时间戳 | | Config Topic Updated At | DateTime | 最后修改时间戳 | 可用平台 | 字段类型 | 描述 | | :--- | :--- | | Config Platform ID (meta field) | Text | 唯一平台标识符 | | Config Platform Name | Text | 模型名称 | | Config Platform Provider | Text | 提供商（如 OpenAI、Anthropic 等） | | Config Platform Category ID | Text | 平台类别标识符 | | Config Platform Category | Text | 类别名称 | 受跟踪网站 | 字段类型 | 描述 | | :--- | :--- | | Config Website ID (meta field) | Text | 唯一网站标识符 | | Config Website Name | Text | 品牌/网站名称 | | Config Website URL | URL | 网站 URL | | Config Website Is Competitor | Boolean | 如果是竞争对手则为 True | | Config Website Is Self | Boolean | 如果是你自己的网站则为 True | | Config Website Logo URL | URL | 品牌标志 URL | | Config Website Created At (meta field) | DateTime | 创建时间戳 | | Config Website Updated At (meta field) | DateTime | 更新时间戳 | 提示词信息 | 字段类型 | 描述 | | :--- | :--- | | Config Prompt ID (meta field) | Text | 唯一提示词标识符 | | Config Prompt Text | Text | 完整提示词文本 | | Config Prompt Topic ID | Text | 关联主题 | | Config Prompt Topic | Text | 主题名称 | | Config Prompt Country Code | Text | 市场/地区代码 | | Config Prompt Status | Text | 提示词状态（如 ACTIVE 等） | | Config Prompt Tags | Text | 关联标签 | | Prompt Type | Text | “Branded”（品牌相关）或“Non-Branded”（非品牌相关） | | Config Prompt Created At (meta field) | DateTime | 创建时间戳 | | Config Prompt Updated At (meta field) | DateTime | 更新时间戳 | 可用标签 | 字段类型 | 描述 | | :--- | :--- | | Tag ID (meta field) | Text | 唯一标签标识符 | | Tag Name | Text | 标签显示名称 | | Tag Slug | Text | URL 安全的标签标识符 | | Tag Prompt Count | Number | 具有此标签的提示词数量 | | Tag Created At (meta field) | DateTime | 创建时间戳 | | Tag Updated At (meta field) | DateTime | 更新时间戳 | 完整指标参考 性能摘要指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Performance Total Prompts | Number | 针对该网站分析的提示词总数 | 越高越好（覆盖范围更广） | 跟踪问题量的趋势 | | Performance Total Results | Number | 收到的成功 AI 响应数 | 应接近 Total Prompts | 监控数据完整性 | | Performance Total Mentions | Number | 你的品牌被提及的次数 | 越高越好 | 品牌可见度的关键 KPI | | Performance Visibility Score | Number (0-100) | 提及品牌的响应百分比 | 60% 以上为优秀，40-60% 为良好 | 主要成功指标 | | Performance Rank | Number | 被提及时的平均位置（1 为第一） | 越低越好（1-3 为理想） | 在 AI 响应中的显著度 | 计算说明 Visibility Score —— (Total Mentions / Total Results) × 100 Rank —— 在所有提及中取平均值（仅当品牌被提及时才计数） 性能提示词指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Performance Total Platforms | Number | 作出响应的 AI 模型数量 | 越高越好 | 跨平台触达分析 | | Performance Prompt Total Mentions | Number | 该特定提示词的总提及数 | 因提示词类型而异 | 识别表现优异的问题 | | Performance Avg Visibility Score | Number (0-100) | 跨所有平台的平均可见度 | 50% 以上为强劲 | 提示词级别的绩效跟踪 | | Performance Avg Rank | Number | 跨平台的平均排名 | 1-3 为优秀 | 提示词显著度分析 | 性能回答指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Answer Brand Mention Count | Number | 响应中提及的品牌数量 | 取决于策略 | 每个响应的竞争格局 | | Answer Avg Rank | Number | 你品牌的平均排名 | 1-3 为优秀 | 响应级别的显著度 | | Answer Avg Visibility Score | Number (0-100) | 0 或 100（未提及或提及） | 100 为良好 | 二元提及跟踪 | 内容引用指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Citation Response Count | Number | 使用此引用的响应数量 | 越高 = 权威性越强 | 来源权威性排名 | | Citation Mentioned Website Count | Number | 引用内容中提及的品牌数量 | 因内容而异 | 内容共提及分析 | 内容关键词指标 | 指标 | 类型 | 描述 | 良好表现标准 | 用例 | | :--- | :--- | :--- | :--- | :--- | | Keyword Response Count | Number | 该关键词在响应中出现的次数 | 越高 = 相关主题越强 | 主题相关性跟踪 | 配置指标 | 指标 | 类型 | 描述 | | :--- | :--- | :--- | | Tag Prompt Count | Number | 标记为此标签的提示词数量 | 指标趋势 Metric Trends 是一个时间序列数据源，针对你整个受跟踪的竞争集合，返回每个（日期 × 网站）的一行数据。与 Performance Summary（仅针对你自己的网站）不同，Metric Trends 展示了你的品牌及每位竞争对手在可见度、声量份额、引用份额、提及数和排名上的每日变化。日期是必需的。该数据源由日期驱动——始终在报告或数据源上设置日期范围，否则数据源将返回错误。 适用场景 跟踪你的可见度或排名随时间的变化 在单一共享指标上对比你的品牌与竞争对手 为部分对整体指标（声量份额、引用份额）构建堆叠面积图/堆叠柱状图 竞争定位气泡图（“谁在哪里？”） 维度 | 字段类型 | 描述 | 用例 | | :--- | :--- | :--- | | Date | Date | 记录指标的日期 | 所有时间序列图表的 X 轴 | | Trends Website ID | Text | 网站的唯一标识符 | 与 Config Websites / Tracked Websites 连接 | | Trends Website Name | Text | 品牌/网站显示名称 | 拆分系列的细分维度，按品牌划分 | | Trends Website URL | URL | 网站 URL | 链接输出和分组 | 指标 | 指标 | 类型 | 聚合方式 | 描述 | 良好表现标准 | | :--- | :--- | :--- | :--- | :--- | | Trends Visibility Score | Number (0–100) | AVG | 当天提及品牌的响应百分比 | 越高越好（60% 以上为优秀） | | Trends Share of Voice | Number | AVG | 品牌在受跟踪集合中总提及的份额 | 越高越好 | | Trends Citation Share | Number | AVG | 品牌在受跟踪集合中引用的份额 | 越高越好 | | Trends Mentions Count | Number | SUM | 品牌被提及的总次数 | 越高越好 | | Trends Rank | Number | AVG | 被提及时的平均位置（1 为第一） | 越低越好（1–3 为理想） | | Trends Total Results | Number | SUM | 当天分析的 AI 响应总数 | 其他指标的上下文背景 | 提示 —— 反转 Rank：由于较低的 Rank 更好，请反转坐标轴（或使用计算字段 0 - Trends Rank），以便在图表中改进趋势向上显示。 数据关系及如何协同使用 连接数据源 将 Performance Summary 与 Website Config 连接 Performance Website ID → Config Website ID 获取绩效数据的品牌名称、标志、竞争对手标记和 URL。 将 Performance Prompts 与 Topic Config 连接 Performance Topic ID → Config Topic ID 使用完整主题元数据丰富提示词绩效。 将 Answers 与 Platforms 连接 Answer Platform ID → Config Platform ID 获取详细的平台信息（提供商、类别）以用于响应分析。 创建你的第一份报告 快速入门：高管仪表板 让我们构建一个回答“我们的 AI 可见度表现如何？”的仪表板。 步骤 1：创建数据源 在 Looker Studio 中，点击 Create → Data source 搜索 Writesonic GEO Presence 使用你的 API key 和 Site URL 进行配置 选择相关的数据源 点击 CONNECT 步骤 2：创建新报告 点击 CREATE REPORT 打开报告编辑器。 步骤 3：添加关键绩效记分卡（示例） 可见度评分卡 添加图表 → 记分卡 指标：Performance Visibility Score 日期范围维度：Date 故障排除 常见问题 “Invalid API Key” 或 “401 Unauthorized” 验证你从 Writesonic 仪表板获取的 API key 确保你使用的是具有 GEO Presence 访问权限的 Business API key 检查复制 key 时是否有额外的空格 “Site URL Not Found” 或 “404 Error” Site URL 必须与 GEO Presence 仪表板中显示的完全一致 —— 包括末尾是否有斜杠。
例如，https://example.com/ 和 https://example.com 被视为不同网址。 请确保该网站已在你的 GEO Presence 项目中激活。 复制网址时，注意检查是否包含多余空格。 “无数据可用”或报告为空 检查日期范围：尝试“最近7天”以确认数据是否存在 移除或放宽筛选条件进行测试 验证数据源选择（Config 数据源无需日期） 检查 GEO Presence 仪表板的数据可用性 “连接超时”或加载缓慢 将日期范围缩短至 1-3 天 选择较少的数据源 使用数据提取（Data → Extract data）进行历史分析 限制每页可视化数量（最多 6-8 个） 数据未刷新 手动刷新：Data 菜单 → Refresh data 检查 Last Refresh Time 字段以验证数据时效 等待 5-10 分钟，让 API 缓存过期 获取支持 技术支持 — 邮箱：[email protected]
包含信息：错误详情、账户邮箱、网站网址（勿包含 API 密钥） 销售/企业客户 — 邮箱：[email protected] 常见问题 问：数据更新频率如何？
答：每当新的 prompts 被执行并收集到 AI 响应时，数据即会更新。为保障性能，连接器使用缓存（5-10 分钟）。 问：为何某些 prompts 的可见性显示为 0%？
答：因为在该 prompt 的任何 AI 响应中均未提及你的品牌。这是识别内容缺口的宝贵数据。 问：“Total Mentions”和“Prompt Total Mentions”有什么区别？
答：“Total Mentions”是网站级别（Summary），而“Prompt Total Mentions”是 prompt 级别（Prompts 数据源）。 问：能否在一个报告中跟踪多个网站？
答：可以，但每个数据源仅连接一个网站网址。请创建多个数据源并进行混合。 问：排名值是否考虑竞争对手？
答：是的，排名反映该品牌在响应中所有被提及品牌中的位置。 问：为何竞争对手的可见性得分更高？
答：这指明了机遇所在。分析其被引用的内容和主题，以指导你的策略。 问：能否导出原始数据？
答：可以，使用 Looker Studio 的导出功能，或直接查询 API 获取原始 JSON/CSV。 问：如何计算声量份额（Share of Voice）？
答：你的 Mentions / SUM(All Website Mentions) - 创建此计算字段。 问：“Config Website Is Self = True”是什么意思？
答：它在网站配置中用于识别你的网站与竞争对手。 问：“Prompt Type”维度是什么？
A：Prompt Type 字段将每个提示词分为“品牌类”（直接提到你的品牌名）或“非品牌类”（泛行业查询）。该字段可用于 Prompt Performance、Individual AI Responses 和 Prompts Information 数据源。借助它，你可以对比品牌在被直接问及时与被自然发现时的表现差异。 如需高级功能和企业级集成，请联系 [email protected] 更新于 4 个月前 这个页面对你有帮助吗？
