如何使用 Telegram 广告 API：功能、预算与替代方案

官方的 Telegram 广告 API 允许自动创建和管理赞助消息。其起价为每千次浏览 (CPM) 0.1 TON，但需要高额预算，并使用一套记录在 Telegram 核心平台上的特定函数 (blockmm.ai)。本指南将解释使用 Telegram 广告 API 的技术现实，并比较官方平台与第三方及 Bot API。

Telegram 的广告 API 是一个用于在 Telegram 广告平台内以编程方式管理赞助消息的工具。这是一个受限制的接口，主要面向能够满足高额预算要求的大型广告商。其主要目的是为大型公开频道中的帖子自动化广告创建、预算控制和性能分析。

对于开发者来说，Bot API、核心 API (TDLib) 和广告 API 之间的区别可能令人困惑。本指南旨在澄清这些差异，解释技术和财务门槛，并详细说明如何将广告功能构建到你的服务中。

什么是 Telegram 广告 API (它不是什么)？

Telegram 广告 API 是一个特定的、经过身份验证的接口，用于在 Telegram 广告平台上管理赞助消息。它不是一个公开、开放注册的 API。访问权限受限，通常保留给满足高预算水平的广告商。该 API 的主要功能是为出现在拥有海量受众的公开频道中的赞助帖子自动化广告任务。

区分广告 API 与开发者常用的其他 Telegram API 至关重要：

• Bot API：这是用于创建和管理 Telegram 机器人的最常见 API。机器人可以发送消息、管理群组并提供互动服务。然而，Bot API 没有任何用于创建官方赞助消息的功能。你无法通过机器人运行广告活动。
• Telegram API (TDLib - Telegram 数据库库)：这是一个用于构建自定义 Telegram 客户端的强大库。虽然它可以与 Telegram 生态系统的许多功能进行交互，但它并非为投放广告而设计。其目的是客户端开发，而非广告管理。

Telegram 广告 API 是一个为高预算广告商以编程方式管理赞助消息的封闭系统。它在功能上与面向公众的 Bot API 和 TDLib 客户端开发库是分开的。

简而言之，如果你的目标是投放带有“sponsored”标签的官方广告，那么 Bot API 和 TDLib 都是错误的工具。你必须使用 Telegram 广告平台，无论是通过其网页界面还是其受限制的 API。

官方广告 API 如何运作？

直接访问 Telegram 广告 API 无法通过简单的注册获得。这是一个封闭的系统，需要 Telegram 的人工批准和重大的财务承诺。例如，该流程是为主要品牌和广告代理商设计的，而非小型企业。

一旦获得访问权限，交互将通过 Telegram 的自定义协议 MTProto 进行，而不是简单的 REST API。开发者必须使用能够处理 MTProto 请求的库来调用特定的广告相关方法。核心功能围绕创建、更新和检索广告统计数据展开。

关键 API 方法包括：

• ads.createAd：提交新广告、定位参数和预算。
• ads.updateAds：修改现有的广告活动。
• ads.getAdsAll：检索与账户关联的所有广告列表。
• ads.getAdsStatistics：获取特定广告的浏览量等效果数据。

这些方法是平台核心功能的一部分，如官方 MTProto 架构文档中所述。MTProto 的技术壁垒，加上高昂的财务入门门槛，使得大多数人直接访问 API 变得不切实际。因此，这催生了一个作为中介的 Telegram 广告服务提供商市场。

官方与第三方 API 访问权限对比

对于开发者和代理商来说，选择在于寻求官方 API 的直接访问权限，还是使用第三方经销商 API。经销商 API 处理了官方平台的复杂性和高成本，提供了一个更易于使用的入口。下表概述了主要区别。

集成程序化广告：TgFather API 方案

对于那些需要在不满足官方严苛要求的情况下，将 Telegram 广告投放置入其应用程序的开发者而言，经销商 API 是一个切实可行的解决方案。TgFather API 通过充当官方平台之上的服务层来满足这一目的。

我们的 API 允许你通过一个简单的、有文档记录的 REST 接口，在 Telegram 上以编程方式投放官方赞助消息。你无需处理 MTProto 和巨额预算，而是可以通过我们的系统以低得多的财务承诺来管理广告订单。这种方法专为希望向自己的用户提供广告服务的经销商和开发者设计。

需要明确的是，TgFather API 并非原始的 Telegram 广告 API。它是一项代你在官方平台上执行广告订单的服务。其好处是进入门槛更低，多种服务合并计费，以及集成简单直接。对于任何正在构建多服务社交媒体管理工具的人来说，这种模式都是理想选择。

主要限制和成本是什么？

在投入开发之前，了解 Telegram 广告系统的限制至关重要。该平台以隐私为先的方法，与其他社交网络相比，造成了显著的限制。

广告成本

你的成本将根据你的访问方式而有所不同。

• 官方平台：此途径需要大笔初始财务承诺。例如，Telegram 曾要求代理商存入 100 万欧元以获得访问权限。广告本身按 CPM 模型运行。

• 经销商 API：这些服务无需大额押金。你按需为你的广告活动付费，但 CPM 会包含提供商的利润。这是为了换取更高的可访问性和更低的前期成本。

平台限制

• 隐私优先的定位：这是与 Meta 等平台最显著的区别。你不能根据个人数据来定位用户。相反，定位仅限于公开频道的上下文。你可以按国家、语言、主题、设备定位用户，也可以定位特定频道 (拥有超过 1,000 名订阅者)、特定机器人或搜索查询 (Adsly)。
• 严格的内容政策：Telegram 严格限制广告内容的类型。禁止的类别包括欺骗性产品、赌博、恶意软件和政治内容。Telegram 团队会手动审核所有广告，且不保证一定能通过批准。你可以在官方广告平台上阅读完整的规则列表。
• API 速率限制：所有 API 都会施加速率限制以防止滥用。虽然 Telegram 的官方速率限制并未公开，但任何经销商 API 都会有其明确的限制，规定你每分钟或每小时可以发出的请求数量。

我应该如何准备集成？

在投入资源进行集成项目之前，请评估以下关键点，以确定 Telegram 广告 API (无论是直接访问还是通过经销商) 是否符合你的目标。

• 评估你的预算。你能否满足直接访问所需的高额最低存款和消费要求？如果不能，经销商 API 是你实现自动化的唯一可行途径。
• 查阅 Telegram 的广告政策。仔细阅读 promote.telegram.org 网站上的内容限制。确保你的产品或服务合规，以避免白费力气。
• 定义你的目标受众。你能否使用 Telegram 宽泛的、基于主题和频道的定位来有效触达你的受众？如果你需要详细的人口统计定位，那么这不是合适的平台。
• 评估你的技术能力。你的团队是否具备使用 MTProto 协议的专业知识？或者，像 TgFather API 这样的提供商提供的标准 REST API 是否是更实际的途径？
• 考虑替代方案。对于某些目标，通过托管服务购买官方赞助消息或直接与频道所有者协商私人广告位，可能比程序化广告提供更好的回报。

接下来该做什么

准备好开始使用程序化 Telegram 广告了吗？以下是现在需要采取的三个基本步骤：

1. 估算你的预算：使用 0.1 TON 的最低 CPM 来预测潜在的广告活动成本 (blockmm.ai)。确定你的预算是适合直接访问，还是经销商更合适。
2. 选择你的路径：根据你的预算和技术资源，决定是寻求直接 API 访问，还是与经销商 API 集成。
3. 查阅 API 文档：如果你选择经销商，请研究其 API 文档，以了解集成所需的端点、请求格式和身份验证方法。

常见问题

我可以用 Telegram Bot API 来投放广告吗？

不可以。Bot API 用于创建交互式机器人和管理消息。它没有任何功能可以在官方 Telegram 广告平台上创建、管理或支付赞助消息。投放广告需要直接使用广告平台或通过授权的中介机构。

通过 API 投放 Telegram 广告的最低价格是多少？

直接 API 访问需要重大的财务承诺。例如，Telegram 曾要求代理商存入 100 万欧元。广告本身按 CPM (每千次浏览成本) 模型定价，起价为 2 欧元。经销商 API 提供了低得多的入门门槛，允许你用更小、更灵活的预算来运行广告活动。

有没有官方的 Python 库可用于 Telegram 广告 API？

没有，Telegram 不为广告 API 提供像 Python 或 JavaScript 这样的语言的官方客户端库。直接集成需要使用 MTProto 协议，这是一项复杂的任务。这个技术壁垒是许多开发者选择提供标准 REST 端点的经销商 API 的主要原因。

Telegram 广告 API 与 Meta 广告 API 有何不同？

Telegram 广告 API 的功能要有限得多。它缺乏 Meta 广告 API 那种基于个人数据的用户级定位。Telegram 的定位以隐私为中心，仅基于公开频道的主题和语言。该 API 的公开可访问性也远低于 Meta。

我可以用广告 API 直接定位用户吗？

不可以。Telegram 的广告系统保护用户隐私。你不能定位单个用户或他们的任何个人信息。你只能定位拥有超过 1,000 名订阅者的公开频道的受众，可以通过选择特定频道或选择其总体主题来实现。