在 Ad Manager 中创建 ads.txt/app-ads.txt

本文介绍了如何使用 Google Ad Manager 创建和管理 ads.txt 和 app-ads.txt 文件。ads.txt 文件用于指定哪些卖方有权销售网站广告资源，app-ads.txt 文件用于指定哪些卖方有权销售应用广告资源。

正确实现这些文件对于防止因“未经授权的卖方 (Ads.txt)”或“供应链中未经授权的卖方”错误而造成的收入损失至关重要，这些错误可能会阻碍订单项的正常投放。

您可在 Ad Manager 中为您的广告资源网创建 ads.txt/app-ads.txt 文件。Ad Manager 会根据您广告资源网的卖方信息生成文件内容、验证文件语法，并允许您查看哪些卖方有权销售您的广告资源。

如果您要为网站创建 ads.txt 文件，请直接跳转到第 1 步：创建 ads.txt/app-ads.txt 文件。如果您要创建 app-ads.txt 文件，则请继续阅读确定开发者网站的前提条件。

创建 app-ads.txt 文件的前提条件：确定开发者网站

开发者网站可供用户进一步了解您的应用和其他内容，而且还是 app-ads.txt 标准在确定应用所有者时所采用的依据。您的开发者网站必须已关联到您在 Google Play 或 App Store 中的商品详情，以便 Ad Manager 和其他广告平台确立您的应用的所有权。

您无需在应用商品详情中列出完整的 app-ads.txt 网址。

如果您在商品详情中添加或更新开发者网站，Ad Manager 需要过一段时间才能检测到这些更改：

商店	检测延迟时间
Google Play	最多需要 24 小时
Apple App Store	最多需要 7 天

要在应用商店商品详情中添加开发者网站，请执行以下操作：

Google Play 商店

在应用详情的联系信息中添加网站网址：

1. 登录您的 Play 管理中心。
2. 选择相应的应用。
3. 在左侧菜单中，依次点击商店发布和商店设置。
4. 滚动到商品详情中的详细联系信息。
5. 添加您的开发者网站网址。

Apple App Store

在商品详情的营销网址字段中添加您的开发者网站。

联网电视应用商店

对于某些联网电视 (CTV) 应用商店，您可能无法通过应用商店的开发者门户将 app-ads.txt 与应用相关联，因为该应用商店可能只面向部分地区提供。例如，Samsung TV 应用商店目前仅包括美国的应用，但不包括欧洲的联网电视应用。Ad Manager 将与买方合作，确保他们不会为目前不支持此工作流程的联网电视平台强制执行 app-ads.txt 授权状态。

第 1 步：在 Ad Manager 中创建 ads.txt/app-ads.txt 文件

如果您的 Android 移动应用和 Android TV 具有相同的应用详情，那么 app-ads.txt 文件将同时适用于这两个平台。请相应地更新您的 app-ads.txt 文件。

1. 登录 Google Ad Manager。

2. 依次点击管理和 Ads.txt 管理。

   要查看此页面，您的 Ad Manager 广告联盟必须拥有至少 1 个已关联的 Ad Exchange 账号，并且您的用户获分配的角色必须具有“Ads.txt 管理”权限。

3. 决定是为网站还是应用创建文件。
   • 对于网站：点击网站 ads.txt 标签页，然后点击创建 ads.txt 文件。
   • 对于应用：点击 app-ads.txt 标签页，然后点击创建 ads.txt 文件。
4. 在随即显示的对话框窗口中，查看 Google 提供的自动生成的文本。
   
   每一行都代表一个独立的卖方账号，这些账号可获得销售您广告资源的授权。如需删去某个卖方并撤消其授权，请从对话框窗口中删除包含其信息的那一行。
   了解如何验证 ads.txt/app-ads.txt 语法。
   我们的 ads.txt/app-ads.txt 生成器只能为 Google 卖方账号提供信息。如果您使用其他 SSP/广告交易平台，则要自己负责在这些广告交易平台上添加卖方账号的信息，以确保相应网域上的查询能获得授权。 请务必提供其网域、您在该平台上的卖方/发布商 ID，以及关系类型（DIRECT 或 RESELLER）。

   默认情况下，自动生成的行可能会在字段 3 中包含值“DIRECT”，这表示与相应卖方账号存在直销关系。如果相应网域不是归您所有并经营，请将此值更新为“RESELLER”。 如果同一卖方 ID 存在冲突的条目（例如，一个标记为“DIRECT”，另一个标记为“RESELLER”），如果您直接拥有相应广告资源并与该卖方有直销关系，通常可以放心地移除标记为“RESELLER”的行。

第 2 步：在您的网站上发布 ads.txt/app-ads.txt 文件

5. 点击下列按钮之一：
   • 将文本复制到剪贴板，以复制文本并将其粘贴到您自己的 ads.txt/app-ads.txt 文件中。
   • 下载 ads.txt 文件，以将其下载为新的文本 (.txt) 文件。
6. 将该文件发送给您的网站站长，请他们将其上传到您的根网域（例如 https://example.com/ads.txt 或 https://example.com/app-ads.txt）。

第 3 步：检查您的 ads.txt/app-ads.txt 文件是否已经过验证

7. 24 小时后，确保 ads.txt/app-ads.txt 文件可被抓取。
8. 定期回来查看您网域的授权状态。

您应负责确保您的 ads.txt/app-ads.txt 文件正确无误且是最新版本。我们会验证文件语法，但无法阻止您上传格式不正确或包含未关联账号的文件。

常见问题排查

• “未经授权的卖方”错误：如果因“未经授权的卖方 (Ads.txt)”或“供应链中未经授权的卖方”错误而导致订单项无法投放，请仔细检查您的 ads.txt/app-ads.txt 文件是否正确声明了所有授权卖方及其网域、您针对相应卖方的特定卖方/发布商 ID，以及正确的关系类型（DIRECT 或 RESELLER）。
• 不完整的供应链：如果出价请求因供应链不完整而被过滤，请确保出价请求中的供应链对象完整且指示完整：1。出价请求中的 inventorypartnerdomain 也应进行声明，并与 ads.txt 文件中的条目相匹配。
• sellers.json：虽然不是 ads.txt 的直接组成部分，但请确保您的 sellers.json 文件（如果适用，通常由与您合作的广告交易平台管理）已正确设置且可供访问，因为它可以与 ads.txt 相辅相成，共同提升透明度。

app-ads.txt 文件是公开的，可供广告交易平台、供应方平台 (SSP) 以及其他买方和第三方供应商抓取。