Shopify 的 Adgora ads.txt 错误说明

定义：这类错误在 Shopify 上是什么意思

“Shopify 商店上的 Adgora ads.txt 错误”表示 Adgora 检查了你的商店，但没有按预期读取到 ads.txt 文件。通常对应四种情况之一：文件缺失、文件被阻止、文件放在了错误的主机上，或者文件里没有可见的 Adgora 卖家行。这也是很多人搜索 Shopify ads.txt 错误 时最常遇到的根源。

这个说法听起来很技术化，但实际问题很简单。Adgora 想在商店公开根目录找到一个纯文本文件；如果 Shopify 在那里提供了别的内容，检查就会失败。少了一行就足够出问题。

可以把 ads.txt 想成一份简短的公开声明。一个小小的文本行，可能比大段主题修改更关键。如果爬虫无法匹配商店域名和预期的 Adgora 条目，平台就可能给商店打标，即使店铺前台对买家看起来一切正常。

这就是为什么这个错误会让人觉得奇怪：主页能打开，商品能打开，结账也正常，但 Adgora 仍然把商店标记出来。问题其实出在文件路径、主机，或者具体文本上。

Shopify ads.txt：Shopify 如何处理这个文件

Shopify 通过自己的店铺级机制来处理 Shopify ads.txt，而不是通过主题页面或博客文章。这一点很重要，因为主题编辑器里的文本文件，并不等于商店根目录下公开可访问的 ads.txt 文件。

实际使用中，Shopify 期望 ads.txt 文件能在域名根目录被访问到，方便爬虫直接请求。像 /pages/ads-txt 这样的页面不算，主题 liquid 里的片段也不算，除非 Shopify 真的把文件发布到了正确的公开位置。

这一点每周都会让人踩坑。店主可能把 Adgora 那一行贴进主题里，保存后就以为完成了，但这并不是 Adgora ads.txt 怎么修复 的正确思路。

Shopify 也会关注哪个主机是主域。如果商店使用自定义域名，文件仍然必须能在 Adgora 实际检查的主机上正确解析，而不仅仅是在测试地址或店铺的另一个版本上可用。

一个小细节就可能改变结果。如果根目录文件存在于 www 版本，但 Adgora 检查的是裸域，或者反过来，爬虫可能根本看不到那一行，这也是 Shopify ads.txt 主域名设置 是否正确的关键所在。

导致 Adgora ads.txt 错误的常见 Shopify 原因

有几种 Shopify 设置会引发同样的错误。最常见的是域名不匹配：商店还没完成指向主域名的配置，所以 Adgora 检查的是一个主机，而 Shopify 却把文件放在另一个主机上提供。

重复的店铺主机也会制造麻烦。商店可能同时出现在自定义域名、www 版本，以及有时在设置期间出现的 Shopify 分配地址上，但其中只有一个应该是规范主机。如果 Adgora 抓取了错误的那个版本，即使文件在别处存在，也可能报告 ads.txt 缺失。

应用生成的文件冲突也是来源之一。一些应用或脚本会尝试创建或重写站点文件，这可能覆盖 Shopify ads.txt 的设置。中午看起来正确的文件，到了下午就可能不见了。

重定向行为也很重要。如果对 /ads.txt 的根请求跳到了奇怪的页面、返回了软错误，或者把爬虫带离了商店真正的根路径，Adgora 可能不会接受这个结果。这不是主题问题，而是主机和响应问题。

还有一种简单情况：条目不完整。Adgora 的卖家关系行可能缺失、不完整，或者复制时用了错误的标识符。差一个字符都可能出错。

正在迁移中的商店风险更高。在域名转移期间，旧主机可能仍在响应请求，而新主机已经面向买家上线，这种分裂会让 Adgora 的文件检查感到困惑。

修复 Shopify 上的 ads.txt：最稳妥的最短路径

要修复 Shopify 上的 ads.txt，先从主域开始。打开店铺设置，确认哪个主机是规范域名，因为文件必须能在 Adgora 实际查找的位置正常工作。

接着，确认由 Shopify 负责发布这个文件。不要依赖主题片段、博客页面或隐藏内容块。这个文件应该以根目录纯文本文件的形式可访问，而不是普通网页。

然后检查 Adgora 那一行本身。那一行必须按要求原样出现在公开文件里，而且只能出现在正确的主机上。如果商店使用自定义域名，请同时测试裸域和 www 版本，确认到底哪个能解析到文件。

之后，重新发布或重新检查店铺。有时更新会立刻生效，有时爬虫需要一些时间重新访问文件。一次新的抓取就可能清除过期告警。

如果在检查干净后问题仍然存在，请检查文件的线上响应。即使返回 200，如果内容不对，或者主机不是 Adgora 期望的那个，也仍然不算通过。

下面把实操顺序放在一起：

1. 确认主域名。
2. 打开线上 /ads.txt URL。
3. 确认是 Shopify 在提供这个文件。
4. 核对 Adgora 那一行。
5. 在店铺更新后重新检查。

Adgora 行应该放在 Shopify 商店的哪里

Adgora 那一行应放在域名根目录下公开的 ads.txt 文件中。这是爬虫检查时唯一重要的位置。

不要只放在主题代码里。不要只放在页面、菜单项或博客文章里。搜索引擎可能会收录这些页面，但 ads.txt 校验针对的是特定文件路径，而不是一般网站内容。

如果商店以裸域作为主域，就先测试那个精确域名；如果 www 是规范域，就先测试 www。这两种版本不一致，会造成误报。

一个实用习惯是：在浏览器里打开这个文件，仔细看地址栏。地址应该是当前店铺主机加上 /ads.txt，不多不少。多一次重定向都可能扭曲结果。

对于拥有多语言或地区版本的商店，把 ads.txt 文件放在 Adgora 检查的主站主机上。法语落地页或其他市场子路径，不能替代根目录文件。

顺带一提：很多商家对主题编辑器过于信任。主题是用来做前台设计的，ads.txt 是文件校验。

Shopify 商店的 ads.txt 示例条目

下面是一个看起来像是有效 Shopify ads.txt 的 Adgora 行示例：

这个示例只可作为格式参考，不是最终答案。具体的 Adgora publisher 或 seller 值必须与账户数据一致。

另一个常见错误，是没有使用正确的分隔符就写入一行。少一个逗号，或者标识符损坏，都会让条目无法读取，即使肉眼看起来差不多。

错误格式示例：把一行普通文本直接粘到首页段落里。那是内容，不是 ads.txt。

错误主机示例：文件存在于 shop-name.myshopify.com，但商店现在使用的是自定义域名。Adgora 可能会检查自定义域名，然后发现那里什么也没有。

如果你想更全面地了解这类设置周边的广告形式，ई-कॉमर्स 商店的加密广告指南说明了商店流量和文件检查常常如何在同一个运营节点上交汇。

相关术语以及下一步检查什么

ads.txt 是列出授权卖家的公开文本文件。它不是页面，不是横幅，也不是隐藏的主题备注。

Primary domain 是 Shopify 为商店使用的主机。如果这里设置错了，文件检查就可能指向错误的位置。

Canonical host 是应该优先响应请求的域名版本。对于 Shopify 商店来说，它可以是裸域，也可以是 www，但不能两个都作为竞争的主导版本。

Seller relationship line 是 Adgora 期望在文件中看到的精确条目。如果这行缺失或格式错误，即使文件已经公开，错误也可能持续存在。

Crawler 是抓取文件的机器人。它不关心你的主题设置，只关心 URL、响应，以及它能读到的文本。

Storefront overwrite 指的是应用、同步工具或部署步骤在你修复后又把文件替换掉。这就是为什么问题可能在一次成功更新后又回来。

如果浏览器里文件是正确的，但 Adgora 在重新检查一次后仍然报告问题，请准备两样东西：一张线上 /ads.txt 页面截图，以及你测试时使用的准确 URL。然后带着这些细节联系支持。证据越具体，审核越快。

最后一次检查应少于 5 分钟。打开线上文件，确认主机，读取 Adgora 行，并在任何 Shopify 更改后再测一次。如果文件位置变了，错误也可能跟着一起变。

对于也在其他格式投放广告的团队，店铺流量的运营部分可参考 加密广告网络定向选项指南；一旦文件稳定、商店恢复正常检查，这份内容会很有帮助。