您的 GA4 渠道归因报告存在漏洞。上个月的推送发送显示没有媒介和来源,因此在表面上它们看起来像是直接流量,而不是挽回的收入。您将其追溯到一个 UTM 参数,该参数从未在您的团队安装时设置的占位符之外填写。本 pushengage 网站设置配置指南之所以存在,是因为今天修复一个字段意味着登录仪表板,找到正确的选项卡,然后一次性重新输入所有其他默认字段,因为表单不允许您只编辑一个字段。
这才是 PushEngage 网站设置的实际成本:不是任何单一设置都难以理解,而是网站详细信息、广告系列默认设置和服务工作程序配置位于不同的位置,很少被触及以至于没有人记得它们在哪里,并且需要完整的表单重新输入才能修复一个字段。本指南涵盖了您实际上会重新访问的三种设置组——网站详细信息、广告系列默认设置和服务工作程序设置——以及如何通过向连接到 PushEngage MCP 服务器的 AI 助手发出简单语言请求来更改它们,而不是在仪表板选项卡中搜寻。
为什么 PushEngage 网站设置配置会变成支持工单,而不是五分钟的修复
网站设置不是一次性配置好然后忘记的。它们会在业务形态发生变化时被重新访问:新市场意味着时区更改,新的归因要求意味着 UTM 参数更新,品牌重塑意味着“Powered By PushEngage”开关需要重新审视,平台迁移意味着检查服务工作程序文件是否仍然位于 PushEngage 期望的位置。由于这些设置中的每一个都位于仪表板的不同角落,因此实际的障碍不是编辑本身。而是重新找到选项卡,然后重新输入您本不想更改的字段,这项任务您将在三个月后再次执行,因为届时又会有其他事情发生变化。
三种故障模式出现的频率足够高,值得关注,而且它们都不会在发生时抛出错误:
- UTM 默认值缺失。广告系列默认值附带占位符或空白 UTM 参数,因此该窗口中的每次推送发送都会在 GA4 中显示为没有媒介或来源,在渠道归因报告中不可见。
- 缺少备用通知。未细分的订阅者,即不匹配任何受众规则的订阅者,将收到空消息或通用副本,而不是您的团队选择的特定默认消息。
- 网站迁移后服务工作程序路径过时。这会完全阻止通知传递,而不会产生指向导致此问题的设置的明显错误消息。
这三者都会悄悄地让您损失数据、覆盖范围或传递能力,直到有人偶然发现,通常是在查看一份不匹配的报告时。
对于将站点设置视为定期检查而非一次性安装步骤的情况,以及对于更改检查方式的情况,都是如此。
入门:将 PushEngage MCP 服务器连接到您的助手
@pushengage/mcp 是 PushEngage 的官方模型上下文协议服务器,本指南中的每个工具都通过它运行。使用命令 npx -y @pushengage/mcp 将其添加到您客户端的 MCP 配置中 — Claude Desktop 的 claude_desktop_config.json、Cursor 的 ~/.cursor/mcp.json 或 Claude Code 自带的 MCP 配置 —。无需全局安装。
您第一次让助手登录时,它会打开一个浏览器标签页来授权连接,因此您的 PushEngage 密码永远不会接触到助手本身,生成的令牌会存储在您本地计算机上。之后,请求查看您的 PushEngage 站点并选择您要处理的站点;下面的所有设置工具都默认使用您当前选择的站点。有关完整的演练,包括解决连接问题的故障排除,请参阅 完整的 PushEngage MCP 设置指南。
站点详情:名称、URL、时区、地理位置和品牌切换
pushengage_get_site_details 读取您当前的配置;pushengage_update_site_details 更改它。它们共同涵盖了 PushEngage 自己的入门文档中称为“添加站点详细信息”的字段:
- 站点名称
- 站点 URL
- 时区
- 地理位置跟踪
- 仪表板小部件上的“Powered By PushEngage”品牌切换
如果您在初始安装后需要更正任何一个 pushengage 站点详细信息,那么这一对工具可以访问所有五个字段,并且在您假设某些配置有误之前,读取这些字段也是使用同一对工具。
时区比看起来更重要。它是每次计划发送和您运行的每条基于订阅者时区的调度的参考点。如果设置错误,早上 9 点的发送会在您的列表的一部分用户那里变成凌晨 2 点,当真正的原因是某个字段配置错误时,这会被视为定位失败。
地理位置默认关闭,必须先显式打开,然后 PushEngage 才能将城市、州和国家数据附加到订阅者记录中,这是地理位置定位所依赖的基础。如果您的细分受众群体引用了位置但数字看起来很少,那么在假设您的订阅者群没有您预期的地理分布之前,值得检查一下。
品牌切换更简单:它控制“Powered By PushEngage”是否显示在您的仪表板小部件上,这对于运行白标支持或聊天体验的团队来说最重要,因为这些团队会仔细审查每一个可见的供应商标记。
这些都不需要支持工单或在嵌套的设置菜单中进行搜索。README 本身的示例就是遵循的模式:问你的助手,“将我的网站时区更改为 Asia/Kolkata 并启用地理定位”,这两个字段都会在一个请求中更新。在域名更改后更正你的网站网址,或在品牌重塑后更正你的网站名称,都遵循相同的模式。
广告系列默认值:悄悄控制每次发送的归因和覆盖范围的设置
pushengage_get_campaign_defaults 和 pushengage_update_campaign_defaults 涵盖四个字段。这些 PushEngage 广告系列默认值并非表面功夫。它们是每次发送的基础设置,无论团队成员是否还记得它们的存在,其中任何一个设置出错都不会明显失败到让任何人立即注意到。
- UTM 参数:在 GA4 或其下游任何分析堆栈中使用 UTM 参数跟踪推送通知的基线。跳过此设置,每次发送都会继承空白的归因:发送时没有来源或媒介,收入无法归因,这个空白没人注意到,直到月度报告出现问题。这就是打开本文的渠道归因报告。
- 备用通知:当订阅者不匹配任何受众规则时触发的内容。将其留空,这些订阅者将一无所获。
- 备用属性:为同一未细分群组提供的个性化令牌,以便他们的副本看起来是故意的,而不是损坏或通用的。没有匹配属性的订阅者不应在本应显示其名字的地方看到空白。
- 默认通知到期时间:在 PushEngage 删除之前,未发送的通知会排队多长时间。一个 7 天到期时间的闪购通知,可能在促销结束后几天才送达,误导订阅者,而不是悄无声息地失败,这比通知从未送达对双方关系更糟。
设置 7 天的默认到期时间是一个简单的请求:“将我的默认通知到期时间设置为 7 天”,直接来自 README 的示例。相同的模式涵盖了未匹配订阅者的备用通知、该群组个性化的备用属性,或完整的 UTM 参数设置,以便每次发送都能正确地将归因回溯到 GA4。在大型发送窗口之前查看你当前的 PushEngage 广告系列默认值,而不是在报告出现空白之后,是值得培养的习惯。
服务工作者设置:注册、子文件夹支持和工作者文件路径
pushengage_get_service_worker_settings 和 pushengage_update_service_worker_settings 涵盖了注册、子文件夹支持和 worker 文件路径:这些是推送通知能够到达浏览器的机制。这三者中任何一个出错,失败模式都是相同的。通知会悄无声息地停止发送,没有任何明显的错误指向导致问题的设置,而任何人注意到的第一个症状是发送量下降,但原因不明。
子文件夹支持是那些平台限制不允许根目录 worker 文件的网站容易遇到的问题:例如 CMS、子目录安装或共享单个域的多站点设置。如果您的 worker 文件位于根目录以外的某个位置,则路径设置必须精确匹配该位置,包括目录和文件名,否则注册将悄无声息地失败。
这是网站迁移或平台更改后首先值得检查的内容:让您的助手提取您当前的 pushengage service worker 设置,并确认注册路径是否仍然与文件实际所在位置匹配,这与 PushEngage 自己的 针对平台受限设置的服务 worker 配置 以解决相同问题的方式类似。
注册本身也值得定期关注,尤其是在更改网站加载脚本的方式之后。内容安全策略更新、新的标签管理器容器或剥离标头的缓存层都可能以意想不到的方式干扰注册,而唯一的表现就是已送达通知数量的悄然下降。在进行送达率检查的同时提取您的 pushengage service worker 设置,这是一种五分钟的习惯,可以在问题花费您整个报告周期之前就将其捕获。
部分编辑而无需重新输入所有内容:合并行为为何重要
这就是让请求 AI 助手比仪表板更快(而不仅仅是不同)的细节:pushengage_update_campaign_defaults 会将您的更改合并到当前值之上,而不是替换整个记录。请求仅更改默认通知到期时间,而您的 UTM 参数、备用通知和备用属性将保持不变。您无需重新指定您无意触及的字段。
与典型的设置表单相比,在已保存的块中更改一个字段通常意味着整个表单会重新加载,所有字段都可编辑,并且在不相关的字段上发生的一个小失误就会悄无声息地覆盖掉原本正常工作的某些内容。“将我的默认通知到期时间设置为 7 天”只会更改一项内容,而不会触及您其他广告系列默认设置。这就是有针对性的编辑与每次仅需调整单个设置就进行完全重新保存之间的区别,而正是这种区别将每月设置审查从一项耗时十五分钟的繁琐任务,变回了它本应始终如一的、只需一句话的请求。
准确的设置实际保护的是:可送达性和归因,而不仅仅是整洁性
这一切都与整洁无关。错误的timezone会破坏您列表中一部分的预定发送时间。缺失的UTM默认值会破坏每次发送的归因,直到有人发现为止。注册不正确的service worker会完全破坏传递,并且是静默发生的。这些设置中的每一个都位于您的团队运行的每个广告系列之下。广告系列不会大声失败;其上方的报告只会悄悄地停止与现实匹配。
这才是将网站详细信息、广告系列默认设置和服务worker配置视为您需要例行检查的AI助手推送通知设置的实际情况,就像您检查送达率仪表板一样,而不是一次性设置步骤,您配置一次后就再也不去查看了。将这些视为AI助手推送通知设置,而不是一个隐藏的仪表板选项卡,意味着检查本身只需要输入请求的时间。在一个请求中捕获一个错误的UTM默认值或一个过时的worker路径,可以保护与您的留存报告所依赖的相同的收入恢复数字,而无需等待IT工单或重新入职电话来修复只需一句话就能说出来的事情。
一旦您的PushEngage MCP服务器连接成功,请按照本pushengage网站设置配置指南中介绍的三种设置组进行操作,就像您运行任何其他留存审核一样:快速地,并按照您自己的时间表进行,而不是等到报告出现问题时才进行。它适用于所有PushEngage计划,包括免费套餐,因此在连接MCP服务器和实际使用它来检查您的pushengage网站详细信息、广告系列默认设置和服务worker设置之前,没有任何障碍,以免它们损害您的归因或覆盖范围。