ORTB
中 / EN

App§3.2.14 · Bid Request

当承载广告的内容是非浏览器应用(通常为移动端)而非网站时,应包含该对象。一个竞价请求不得同时包含 Site、App、DOOH 对象中的多个。至少提供应用 ID 或 bundle 是有用的,但这并非严格要求。译稿校对中ENThis object should be included if the ad supported content is a non-browser application (typically in mobile) as opposed to a website. A bid request must not contain more than one of a Site, App or DOOH object. At a minimum, it is useful to provide an App ID or bundle, but this is not strictly required.

AttributeTypeDescription
id
string交易平台(exchange)专用的应用 ID。译稿校对中ENExchange-specific app ID.
name
string应用名称(应发布方要求可使用化名)。译稿校对中ENApp name (may be aliased at the publisher's request).
bundle
string应用在应用商店中的应用商店 ID(store ID)。关于 CTV 应用商店预期字符串的更多细节,参见 OTT/CTV 商店分配应用标识指南。对于 Google Play 商店中的移动应用,应为包名(bundle 或 package name,如 com.foo.mygame);对于 Apple App Store 中的应用,应为数字 ID。译稿校对中ENThe store ID of the app in an app store. See OTT/CTV Store Assigned App Identification Guidelines for more details about expected strings for CTV app stores. For mobile apps in Google Play Store, these should be bundle or package names (e.g. com.foo.mygame). For apps in Apple App Store, these should be a numeric ID.
domain
string应用的域名(如 “mygame.foo.com”)。译稿校对中ENDomain of the app (e.g., "mygame.foo.com").
storeurl
string已安装应用的应用商店 URL;用于满足 IQG 2.1 合规要求。译稿校对中ENApp store URL for an installed app; for IQG 2.1 compliance.
cattax
default 1
integer所使用的分类体系(taxonomy)。取值参见 AdCOM 列表:分类体系(List: Category Taxonomies)。译稿校对中ENThe taxonomy in use. Refer to the AdCOM List: Category Taxonomies for values.
枚举 Category Taxonomies · 10 个值
1IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
2IAB Tech Lab Content Category Taxonomy 2.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
3IAB Tech Lab Ad Product Taxonomy 1.0.
4IAB Tech Lab Audience Taxonomy 1.1
5IAB Tech Lab Content Taxonomy 2.1
6IAB Tech Lab Content Taxonomy 2.2
7IAB Tech Lab Content Taxonomy 3.0
8IAB Tech Lab Ad Product Taxonomy 2.0
9IAB Tech Lab Content Taxonomy 3.1
500+Vendor-specific codes.
cat
string[]应用的 IAB Tech Lab 内容分类数组。所使用的分类体系由 cattax 字段定义;未提供 cattax 时,假定使用内容分类体系 1.0。译稿校对中ENArray of IAB Tech Lab content categories of the app. The taxonomy to be used is defined by the cattax field. If no cattax field is supplied Content Category Taxonomy 1.0 is assumed.
sectioncat
string[]描述应用当前版块的 IAB Tech Lab 内容分类数组。所使用的分类体系由 cattax 字段定义。译稿校对中ENArray of IAB Tech Lab content categories that describe the current section of the app. The taxonomy to be used is defined by the cattax field.
pagecat
string[]描述应用当前页面或视图的 IAB Tech Lab 内容分类数组。所使用的分类体系由 cattax 字段定义。译稿校对中ENArray of IAB Tech Lab content categories that describe the current page or view of the app. The taxonomy to be used is definied by the cattax field.
ver
string应用版本号。译稿校对中ENApplication version.
privacypolicy
integer指示该应用是否有隐私政策:0 = 否,1 = 是。译稿校对中ENIndicates if the app has a privacy policy, where 0 = no, 1 = yes.
paid
integer0 = 应用免费,1 = 应用为付费版本。译稿校对中EN0 = app is free, 1 = the app is a paid version.
publisher
object应用的发布方 Publisher 的详细信息(参见第 3.2.15 节)。译稿校对中ENDetails about the Publisher (Section 3.2.15) of the app.
content
object应用内的内容 Content 的详细信息(参见第 3.2.16 节)。译稿校对中ENDetails about the Content (Section 3.2.16) within the app.
keywords
string关于应用的关键词列表,以逗号分隔。keywords 与 kwarray 只能出现其一。译稿校对中ENComma separated list of keywords about the app. Only one of keywords or kwarray may be present.
kwarray
string[]关于应用的关键词数组。keywords 与 kwarray 只能出现其一。译稿校对中ENArray of keywords about the app. Only one of keywords or kwarray may be present. | inventorypartnerdomain | string | A domain to be used for inventory authorization in the case of inventory sharing arrangements between an app owner and content owner. This field is typically used by authorization crawlers to establish the domain of the content owner, who has the right to monetize some portion of ad inventory within the app. The content owner's domain should be listed in the app owner's app-ads.txt file as an inventorypartnerdomain. Authorization for supply from the inventorypartnerdomain will be published in the ads.txt file on the root of that domain. Refer to the ads.txt 1.1 spec for more details. | ext | object | Placeholder for exchange-specific extensions to OpenRTB.
inventorypartnerdomain
string在应用所有者与内容所有者存在库存共享安排时,用于库存授权的域名。该字段通常被授权爬虫(authorization crawlers)用于确认内容所有者的域名——内容所有者有权将应用内部分广告库存变现。内容所有者的域名应以 inventorypartnerdomain 形式列于应用所有者的 app-ads.txt 文件中;来自该 inventorypartnerdomain 的供给授权将发布在该域名根目录的 ads.txt 文件中。详见 ads.txt 1.1 规范。译稿校对中ENA domain to be used for inventory authorization in the case of inventory sharing arrangements between an app owner and content owner. This field is typically used by authorization crawlers to establish the domain of the content owner, who has the right to monetize some portion of ad inventory within the app. The content owner's domain should be listed in the app owner's app-ads.txt file as an inventorypartnerdomain. Authorization for supply from the inventorypartnerdomain will be published in the ads.txt file on the root of that domain. Refer to the ads.txt 1.1 spec for more details.
ext
object供交易平台对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB.

译注

译者注

App 的三方互斥:2.6 中分发渠道为 Site ⊕ App ⊕ DOOH 三方互斥,同一请求至多包含其一;至少提供应用 ID 或 bundle 是有用的。译稿校对中

bundle 语义的扩展:2.6 将 bundle 从“平台专属应用标识符”明确为“应用商店 ID”,并纳入 CTV 场景(OTT/CTV 商店分配应用标识指南);CTV 应用的标识形态与传统移动端(Android 包名/iOS 数字 ID)不同,接入 CTV 流量时应按指南核对取值格式。译稿校对中

id vs bundle:id 是交易平台专属标识,离开该平台即失效;bundle 是商店侧标识,跨链路稳定,是应用级匹配、归因与反欺诈的核心字段。译稿校对中

storeurl 与 app-ads.txt:storeurl 供买方核验应用真伪(IQG 2.1 要求);与 app-ads.txt 授权核验配套使用,缺失 storeurl 会削弱供应链核验能力。译稿校对中

inventorypartnerdomain(应用侧):与 Site 同名字段机制一致,差别在于授权声明位于应用所有者的 app-ads.txt(而非 ads.txt);核验时应抓取对应应用的 app-ads.txt。译稿校对中

字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中