# app-ads.txt

_为了建立一个透明的、安全的以及反作弊的 App 内部广告生态, Chartboost 现在已全面支持 app-ads.txt, 一个由_ [_IAB_](https://iabtechlab.com/wp-content/uploads/2018/11/IABTechLab_-App-ads.txt_publisher_advisory.pdf) _发起的 App 反作弊标准。维护 app-ads.txt 是广告发行商最大化在程序化购买中变现的关键，并能预防未经授权的应用内流量变现，以及应用欺诈。_



## 开始

1.  参照 IAB 技术实验室提供的标准  [Authorized Sellers for Apps specification v1.0](https://iabtechlab.com/wp-content/uploads/2019/03/app-ads.txt-v1.0-final-.pdf) 创建您的 app-ads.txt 文件。
2.  请确保广告发行商的应用在 Apple App Store 和 Google Play Store 上列出的开发者URL (Developer URL) 可用且为最新版。
3.  登陆 Chartboost 控制面板（Dashboard)，点击[Tools > App-ads.txt](https://platform.chartboost.com/tools/app-ads-txt).
4.  点击 SCAN ALL APPS 开始对 app-ads.txt 文件进行扫描和验证。扫描速度很快，应在一分钟内完成
    - 注意：仅支持 iOS 和 Google Play 应用进行 app-ads.txt 验证。_
5.  刷新页面查看每个应用程序的验证状态。
6.  查看详细信息并根据需要更新您的 app-ads.txt 文件。



## 使用 Chartboost App-ads.txt 验证工具

Chartboost App-ads.txt 验证工具帮助广告发行商检查其 app-ads.txt 文件是否可被检测到，并且是否包含所有必要内容，以帮助广告发行商在 Chartboost 平台获取最大收入。



### 工作原理

1.  符合条件的应用程序将显示在 App-ads.txt 验证工具的概览页面(Overview)。这些应用程序必须符合以下条件:  
    - 已成功集成 Chartboost SDK。  
    - 已在 iOS 或 Google Play Store 上上线。  
    - 已通过应用发布审核。
2.  获取每个应用程序 App Store 页面上发布的开发者URL (Developer URL)，并生成可获取 app-ads.txt 文件的URL（有关 app-ads.txt 文件应该托管在何处的详细信息，请参考IAB[规范](https://iabtechlab.com/wp-content/uploads/2019/03/app-ads.txt-v1.0-final-.pdf)）。
3.  用户点击  **SCAN ALL APPS** 开始进行验证扫描。
4.  对于每个唯一的 app-ads.txt URL，我们将尝试获取该文件，并将其内容与当前所需内容进行比较，包括特定账户的 chartboost.com,<publisher id>,DIRECT 行。
5.  扫描结果将在刷新页面后存储和显示在页面上。
6.  如果成功获取和扫描了文件，则**状态**(status)列将指示在文件中是否找到了所有必需的行，否则将显示匹配行数与总预期行数的情况。
7.  点击**详细信息**（details) 图标将带您进入指定应用程序的**扫描详细信息**(scan details page)页面。在此页面上，您将找到一个最新的所需行列表，并在每一行旁边的指示器中了解已找被找到或缺失的行。
8.  点击**复制全部(COPY ALL)**或**仅复制缺失(COPY MISSING ONLY)**按钮将把相应的行复制到剪贴板中，然后可以直接粘贴到您的 app-ads.txt 文件中进行更新。



### 将 Chartboost 所需的行添加到您的 app-ads.txt 文件中：

如果您是第一次向 app-ads.txt 文件添加 Chartboost 行：

1.  在完成扫描后，点击任何一个应用旁边的**详细信息**(details)图标。此时**状态**(status)并不重要。
2.  点击**复制全部**(COPY ALL)按钮。
3.  然后，您可以直接将这些行粘贴到您的 app-ads.txt 文件中。


如果您已有一些必需的行，只是要更新您的 app-ads.txt 到最新版本：

1.  在完成扫描后，点击具有**N/N行匹配** (N/N Lines Matched) 状态的应用旁边的**详细信息**(details) 图标。
2.  点击**仅复制缺失**(COPY MISSING ONLY)按钮。
3.  然后，您可以直接将这些行粘贴到您的 app-ads.txt 文件中。


**注意：**如果您在多个Chartboost账户中管理发布应用，请确保在 App-ads.txt 验证工具中为每个账户添加不同的 `chartboost.com,<publisher id>,DIRECT` 行。在当前登录的账户上，该页面会自动填充广告发行商 ID(Publisher ID)。对于平台上的任何账户，所有其他行都是相同的。


确保您所有应用的开发者 URL(Developer URL)在应用商店页面上列出并为最新版本。这是 Chartboost 和我们的需求合作伙伴用于查找 app-ads.txt 文件并验证销售授权的 URL。


提示：

-   开发者URL(Developer URL)**必须**托管在发布者管理的域名/子域名上。无效域名的示例包括 Facebook/Twitter 链接、Github页面、YouTube 频道等。
-   如果您发现需要更改应用商店上列出的开发者 URL(Developer URL)，请注意可能需要几天时间才能在应用商店页面和 Chartboost 中反映出更改。



### 苹果应用商店 Apple App Store

在应用的  [App Store Connect](https://appstoreconnect.apple.com/apps)  页面中，**营销网址**(Marketing URL)项请填写发布在应用的 App Store 页面上的开发者网站链接(Developer Website)。这是用于查找您的 app-ads.txt 文件的域名。

-   只有通过 App Store Connect 发布和提交新版本，才能更新 Apple App Store 中应用的营销网址。
-   强烈建议您在每次向商店发布新版本的时候检查营销网址是否是最新的。



### Google Play Store

在 Google Play Store 中，应用的落地页上的**访问网站**(Visit website)链接在 Google Play Store 控制台(Console)中管理：

1.  导航到**商店设置**(Store Settings)页面（增长Grow > 店铺信息 Store Presence > 商店设置Store Settings）。
2.  向下滚动到**商店列表联系方式** (Store listing contact details)。
3.  添加或更新您的网站。



## 常见问题

### 给定应用的 URL 显示错误，我该怎么办？

1.  检查应用的 App 设置页面上的  **iTunes ID（iOS）**或  **Google Play Store ID（Android）**是否正确。如果不正确，请联系 Support 更新为正确的ID。
2.  检查应用商店页面上的**开发者 URL**(Developer URL) 是否为最新版本。如果不是，请按照上面的步骤进行更新。
3.  检查您的文件是否托管在正确的位置。请参考[规范](https://iabtechlab.com/wp-content/uploads/2019/03/app-ads.txt-v1.0-final-.pdf)以获取详细信息。
4.  如果步骤1至步骤3都正确，那么请联系 Support，并提供 App ID 和正确的 URL，以便我们进一步调查此问题。



### 我对 app-ads.txt 文件所做的更改需要多长时间才能在 app-ads.txt 验证工具的扫描结果中反映出来？

如果向现有的 app-ads.txt 文件添加新行，这些更改通常会在下一次扫描时立即反映出来。然而，这取决于可能存在的缓存策略。例如，如果文件由 CDN 提供的，请咨询您的网站管理员，了解app-ads.txt 文件的 CDN 缓存过期策略是否可以设置为一个小时或更短的时间。



### 我对开发者 URL 所做的更改需要多长时间才能在 app-ads.txt 验证工具的扫描结果中反映出来？

这主要取决于应用商店，可能需要几天时间才能反映出来。一旦新的 URL 在应用商店上正常显示，请再给它 24-48 小时的时间在 Chartboost 中反映出来。如果在此时间后仍然显示过时，请联系我们。



### 我可以将我的 app-ads.txt 文件托管在免费的托管提供商（例如 GitHub Pages）上吗？

发布者必须管理开发者 URL 的子域名或域名，因为 app-ads.txt 文件要求位于其根目录下。

例如，如果您的开发者 URL是 `https://user123.github.io/home`，那么买家和 Chartboost 将使用的 app-ads.txt URL是 `user123.github.io/app-ads.txt`，这是有效的。

但是，如果您的开发者 URL 是`https://twitter.com/user123`，那么买家和 Chartboost 将使用的 app-ads.txt URL 是 `twitter.com/app-ads.txt`，这是_无效_的。



### 如何找到我的广告发行商 ID(Publisher ID)？

只需进入您帐户中任何应用的扫描详细信息（scan details) 页面，您的广告发行商 ID(Publisher ID) 可以在第一行 `chartboost.com,<publisher id>,DIRECT` 中找到。



### 如果我在 Chartboost 拥有多个账户，是否需要多次添加所有行？

对于每个与 Chartboost 合作进行应用程序变现的账户，您需要添加 chartboost.com，<publisher id>，DIRECT行。在平台上，除了第一行chartboost.com，<publisher id>，DIRECT 之外，app-ads.txt 扫描详情中的其他行对于所有账户都是相同的。因此，如果您有多个账户，请确保登录到每个账户并将此行添加到每个账户的app-ads.txt文件中。



### 在管理 app-ads.txt 文件时，Chartboost 有什么建议？

在app-ads.txt文件中创建部分（section），可以通过添加注释行（以#字符开头的行）并注明广告网络/合作伙伴的名称，每个部分之间用空行和换行符分隔。这样做可以更轻松地找到、替换和更新每个网络的行。

_示例:_

```
# Chartboost  
<line1>  
<line2>  
etc.  

# Another Ad Network  
<line1>  
<line2>  
etc.
```