文档
Slack、Teams 与 webhook
将定时的 Search Console 报告和告警发送到 Slack、Microsoft Teams 或任意 HTTPS 端点,所有设置都在同一个页面中管理,并附有投递记录。
AutoPSEO 可以通过两种方式把数据推送到应用之外:一是定时报告,汇总某个资源的 Search Console 核心指标;二是告警,在检测器发现点击量、CTR、排名、索引状态、跟踪的关键词排名或审核结果出现变化时触发。两者都会发送到你预先添加的渠道:Slack incoming webhook、Microsoft Teams Workflows URL,或任何可接收签名 JSON 的公开 HTTPS 端点。这一切都在同一个页面中管理。
入口位置
在左侧边栏中打开 Slack, Teams & Webhooks,或进入 Account,在 Slack、Teams 与 webhook 卡片上选择 Manage(在应用中打开)。页面按目标类型分为多个区块(Slack - Connected workspaces、Microsoft Teams、Outbound webhooks),其后依次是 Scheduled reports、Alerts 和 Delivery history。
渠道、规则与投递
该功能由三个部分组成。
- 渠道:一个目标 URL,标记为 Slack、Microsoft Teams 或 Webhook。AutoPSEO 会加密存储该 URL,之后只显示其主机名和末尾几个字符。每个账户最多可以有 25 个渠道。
- 规则:一份定时报告或一条告警,且只指向一个渠道。一个渠道可以对应任意数量的规则,每个账户最多 50 条规则。若要让同一条告警同时发送到 Slack 和 Teams,请创建两条规则。
- 投递:一次发送消息的尝试。Delivery history 会保留所有渠道最近 50 次尝试(包括测试和一次性摘要),并记录状态(已发送、失败或已跳过)、HTTP 状态码、目标端响应所用的时间,以及失败时返回的原因。
渠道和规则归属于你自己的登录账号。如果团队成员希望在自己的渠道中接收告警,需要自行设置。
从零到第一条消息
- 连接要生成报告的 Search Console 资源(连接 Search Console)。每个选择器中都会出现演示资源,因此在你自己的数据就绪之前,也可以先试用规则。
- 通过 Add to Slack、New Teams channel 或 New webhook 添加渠道:填写名称并粘贴 URL。各类 URL 的获取方式:Slack、Microsoft Teams、webhook。
- 点击渠道所在行的 Send test,确认消息已送达。
- 通过 New scheduled report 或 New alert 创建规则。在至少存在一个渠道之前,这两个按钮都是灰色不可用状态。
消息的发送时机
每个整点(UTC)都会运行一个任务,计算出当前到期需要发送的内容。
| 消息 | 发送时机 |
|---|---|
| 定时报告 | 在你选定的整点发送,按每日、每周或每月的周期,每个周期最多一次 |
| 针对点击量、CTR、排名、丢失查询词、排名跟踪或审核的告警 | 每天检查一次,在 06:00 UTC 的任务中执行 |
| 针对索引状态翻转的告警 | 每小时检查一次 |
| Send test、Send now、Test rule | 立即发送 |
| 报告页面中的 Send to Slack | 立即发送(在 Slack 中使用 AutoPSEO) |
由于 Search Console 发布数据存在延迟,报告和告警的统计窗口截止到运行日的前一天。每条消息都会注明所用的日期范围,无需猜测。
使用前提
- 有效的套餐或正在进行的试用。试用结束后若未选择套餐,定时报告和告警将停止;在你选择套餐之前,新建渠道、修改规则、测试和发送都会被拒绝(套餐与计费)。
- 一个由你掌控的目标端:在 Slack 中创建 incoming webhook 的权限、在 Teams 渠道中创建 Workflows webhook 的权限,或你自己的 HTTPS 端点。
留意谁能读取该渠道
每条消息都包含搜索表现数据:点击量、展示量、查询词和页面地址。任何能够读取该 Slack 或 Teams 渠道,或 webhook 背后系统的人,都能看到这些内容,因此请将客户资源的消息发送到私密渠道。目标 URL 同样属于机密:持有它的人就能向你的渠道发帖,正如 Slack 对其 webhook 的提示。这也是 AutoPSEO 在你保存后不再显示该 URL 的原因。
延伸阅读
- 使用 incoming webhook 连接 Slack:在 Slack 中创建 URL、添加 URL,以及 Slack 可能返回的错误。
- 定时报告:报告类型、统计周期、发送频率和每周期一次的规则。
- 告警:九种检测器、阈值、严重程度和静音。
- 在 Slack 中使用 AutoPSEO:消息包含的内容以及 Send to Slack 的工作方式。
- Microsoft Teams:Workflows URL 与 Adaptive Card。
- 出站 webhook:JSON 请求体、事件类型和签名校验。
本节内容
使用 incoming webhook 连接 Slack
为频道创建 Slack incoming webhook,将其添加到 AutoPSEO,发送测试消息,并排查发送失败时 Slack 返回的错误。
在 Slack、Teams 或 webhook 中接收定时报告
按日、周或月向频道推送媒体资源的点击量、展示次数、CTR 和排名,并附上热门查询、页面或排名变动情况。
告警:检测器、阈值与严重程度
九种检测器监控点击量、CTR、排名位置、流失查询词、索引状态变化、排名和审计结果,仅在越过阈值时才向渠道发送消息。
在 Slack 中使用 AutoPSEO
AutoPSEO 的 Slack 消息包含哪些内容,如何通过"发送到 Slack"把任意报告表格发到频道,以及哪些操作可以在 Slack 中完成、哪些不可以。
Microsoft Teams 告警与报告
在 Teams 频道中创建 Workflows webhook,将其添加到 AutoPSEO,即可以按严重程度着色的 Adaptive Card 形式接收告警和定时报告。
出站 Webhook:载荷与签名
通过任意 HTTPS 端点接收带签名的 JSON 格式 AutoPSEO 告警和报告:包括请求头、请求体字段、事件类型以及签名验证方法。