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