基础
Ads API 的层级结构与术语
要在 Ads API 上取得良好效果，理解 X Ads 中各实体之间的关联至关重要。本教程将概述 X Ads 对象层级结构的基础知识。
广告组在 Ads API 中称为 line items，隶属于广告系列，用于针对一组 X 用户进行定向与竞价。广告主可通过将 Post 或媒体（例如作为 In-stream 广告投放的视频）与某个 line item 关联来进行推广。另请参见 Ad Group。
在广告账户中上传并作为账户媒体管理的一组创意素材，其中可能包含可推广的视频前贴片素材（也称为贴片内投放广告/in-stream ads），以及可在 X Audience Platform 上推广的图片。
在 X Ads 的层级结构中，最上层是广告账户。一个广告账户可以由多个 X 用户管理。@Furni（我们的演示家具商店）就是管理广告账户的用户示例。我们通过 account_id 来标识广告账户，它是一个 base36 的字母数字字符串。
在每个账户下，我们会存储若干可在多个广告活动中复用的实体类型，例如可用于定向的定制受众、账户媒体（视频或图片），以及卡片（可展开的创意，您可以将其添加到一条 Post 中）。
在上传视频资产时，上传方可以为视频指定类别（例如 Tweet Video、Tweet Gif、Tweet Image 和 Amplify Video）。当你要上传用于流内广告投放的视频时，必须选择 Amplify Video 类别。此类视频需要特殊处理以确保可投放，因此必须使用 Amplify Video 媒体类别。
分析指标帮助合作伙伴和广告主了解他们在 X 上推广内容的表现。这包括展示次数、点击量、视频观看量和投放花费等信息。此外，合作伙伴和广告主还能获取其触达受众各细分群体的详细指标。
Ads API 支持两种获取广告系列详细表现指标的方式：同步和异步。
通过同步分析请求，所请求的指标会随响应直接返回。同步端点支持较短的时间范围，适合查询广告系列的实时表现。
通过异步分析端点，所请求的指标会在关联的“作业”处理完成后，以可下载结果文件的形式提供。异步端点支持更长时间范围的指标请求，可返回细分数据，旨在获取更大规模的数据——非常适合用于生成报告或历史数据回填。
每个广告主投放的广告系列都必须在现有的资金工具下创建。广告系列可用于定义广告活动的名称、排期和预算等内容。延续 Furni 的示例，我们可以创建一个名为“Furni 家居装饰”的广告系列。
需要注意：每个广告账户最多可有 200 个活跃广告系列；该上限可由广告主的客户经理提高。广告系列在达到结束时间或预算耗尽之前均被视为活跃。暂停的广告系列在计算广告系列数量时仍视为活跃。
Cards 提供了一种方式，可将 Tweet 以更直观的形式扩展，加入图片、视频或 UI 元素。Ads API 支持多种可用于 Tweet 的卡片类型，可进一步在广告活动中投放推广。
广告主可以在包含创意素材的广告活动中推广 Tweet，例如图片、GIF 和视频。这些创意素材可以与 X 卡片关联，使 Tweet 能附加更丰富的照片、视频和媒体体验。创意素材也可以直接附加到 Tweet。比如，你可以包含文本和一个视频（或最多 3 张图片），从而创建一条推广 Tweet。
每个 line item 必须至少关联一个创意素材才能投放。可用的创意素材选项包括用于获取新关注者的 Promoted Accounts、适用于 TX Audience Platform 各类 line item 的 Media Creatives（如图片或视频），或 Promoted Posts。
广告账户下还包含资金工具，即广告主为配合 X Ads 使用而设置的不同资金来源，范围从与 X 签署的插播订单，到绑定在账户上的信用卡。
在一个广告系列中，您可以包含一个或多个广告组，在 Ads API 中也称为 line items。可以将 line items 理解为广告系列的不同细分，每个细分都有各自的定向设置和创意。包含多个 line items 的广告系列通常被称为“广告组广告系列”。
在单个广告系列中使用多个 line items 的优势之一是，您可以创建更丰富的定向与创意组合。
在我们的“Furni 家居装饰”广告系列下，我们可能希望创建两个 line items：一个是“旧金山的购房者”，另一个是“伦敦的购房者”。
每个广告系列最多允许 100 个 line items，且一个广告账户在所有广告系列中合计最多可拥有 4,000 个处于活动状态的 line items。
移动应用推广（MAP）是一套产品，帮助广告主通过 X 推广移动应用，覆盖应用安装、转化和重新唤起/再参与等目标。
X 的移动应用推广衡量功能可帮助广告主跟踪在 X 上以推动安装或其他应用内转化为目标的广告活动效果。X 的移动衡量合作伙伴为广告主提供管理能力，以决定并管理他们希望从在 X 上推广的应用中跟踪哪些转化事件。MACT 概览
媒体库端点用于管理 X Ads 账户中的图片、GIF 和视频。库中的媒体资产可用于发布 Post 和创建卡片，也可在多个创意中复用，从而无需重复上传相同资产。
推广账号（粉丝广告系列）是“关注推荐”的一部分，该功能会向用户推荐他们尚未关注但可能感兴趣的账号。推广账号有助于向用户介绍更多他们可能喜欢的账号。
推广账号使广告主能够推广其账号并在 X 上扩大受众。粉丝广告系列会在 X 平台的多个位置展示——包括首页时间线、“关注推荐”和搜索结果——并会标注为“推广”，以区别于其他推荐账号。
每个 X Ads 账户可以拥有一个或多个可推广用户，即可通过该广告账户进行推广的用户。Furni 的 @Furni 账号是 Furni 广告账户下的一个 FULL 可推广用户示例，这意味着我们可以为 @Furni 及其 Tweets 投放所有类型的广告系列。一个广告账户只能有一个 FULL 可推广用户。
请注意，广告账户下也可以有其他类型的可推广用户。例如，如果我们想推广 @Jack 关于 Furni 产品的 Tweets，他将在该账户中被设置为仅限转推的可推广用户，标识为 RETWEETS_ONLY。广告主应联系其 X 客户经理，了解将转推用户添加到其广告账户的相关信息。
推广视频是指由广告主付费投放、包含在推广 Tweet 中的视频。它们会出现在主页时间线、X 上的搜索结果顶部以及平台的其他位置，并会清晰标注为“推广”。
参见 X Audience Platform。
预定发布的 Tweet 使广告主或用户可以创建一条 Tweet，并安排在稍后的日期发布。除创建和管理这些 Tweet 外，API 还支持将这些 Tweet 关联到某个 line item，以便在 Tweet 发布后进行推广。这使广告主能够预先准备原生 Tweet，并在任何关键举措之前提前规划其活动素材。例如，在新产品发布公告的同时，让预先准备好的 Tweet 素材立即上线。
分群使合作伙伴和广告主能够按特定的定向维度（例如年龄、设备或语言）拆分并获取指标，该功能仅可通过我们的异步分析端点使用。要请求分群指标，请使用 segmentation_type 请求参数。有关分群选项的更多详细信息，请参阅 Metrics and Segmentation。
基于列表的定向受众是三种定向受众类型之一，通过上传包含您自有用户和客户数据的文件创建。您的列表会与 X 上的用户进行匹配，便于您在广告系列中直接触达他们。请查看以下限制。
“来自网页的定制受众”是三种定制受众类型之一，由访问过你网站的 X 用户构成。要使用来自网页的定制受众，你必须在你的网站上安装我们的 X 像素，或使用我们认可的任一标签管理器合作伙伴。请查阅这些限制条件。
如前所述，定向条件与广告项目（line item）关联。我们提供多种定向方式，从位置、关键词、性别到更细分的属性（如用户行为和兴趣）。对于“Home Buyers in San Francisco”这一广告项目，我们可以同时定向“home buying”行为和“San Francisco”位置。
有关可用定向类型的更多信息，请访问我们开发者网站的 Targeting Overview 页面。
Twitter Object Nest（TON）用于存放通过 Media Upload 端点上传的媒体和各类资产，以供作为创意素材使用。
每个投放单元必须至少关联一个创意素材才能投放。可用的创意素材包括用于获取新关注者的“推广帐号”、适用于 X Audience Platform 各类投放单元的“媒体创意”（如图片或视频），以及“推广 Post”。下面是一个 @Furni 可以推广并用作创意素材的示例 Post。