Advertiser LLM 编码代理的 public API 迁移参考
将客户端集成从用户获取管理 API (legacy)迁移到 Ads 统一平台 public API 的 LLM 编码代理的参考。
阅读时间50 分钟最后更新于 2 天前
受众:此文件将被写入 LLM 编码Agent(Claude 代码 或 similar)负责从 Legacy Unity“Advertise API”迁移客户端集成 (,/advertise/v1/...服务)到新建 Unity Ads 广告主 public API (mz-advertiser-public-api)。它被拆分为独立的 实体。每个代码块说明_更改的内容_以及_具体操作_。阅读 概念模型 Change 和 全局 changes 部分先出现,然后应用于每个代码块。/ads/advertiser/public/v1/...
如何使用该文件(Agent 的说明)
- 将两个合同视为真相的音频源,而不是此散文。Legacy =
.新建 =
mz-advertiser-public-api/openapi/specs/advertise-v1.yml.本指南涵盖 仅限Legacy v1;如果客户端调用ads-unified-platform/openapi/advertiser/platform-public-v1-routes.yaml,则不同规格 (/advertise/v2alpha1/...)单独使用,并向人类表面任何仅限 v2 的用途。advertise-v2-alpha.yml - 按给定的 Order(Apps → Attribution → Creatives →)迁移一个实体代码块
Creative Packs → Campaign Management → Campaigns → Bids → Budget → Targeting → Assignment)。执行
在代码块依赖 ON 编译/通过之前,不启动代码块。应用程序优先:所有内容都以
新建。立即归因(即应用关卡),而 Campaign 管理查找 (
applicationId/sdk-event-names) 位于广告系列之前,因为它们提供 广告系列设置。eligibility - 当 Legacy 功能列在 🚫 No equivalent 下时,不要发明或猜测
终端。停止并将其作为 Open 问题向人类表面。最重要的例子是
(应用程序生命周期现在归 USF 所有)和已弃用 Retention 商品区域(留存率出价/资格)--请参阅代码块。
DELETE app - 在每个代码块之后,根据 Field 表重新映射 Field 名称;永远不要假设 Field 已结转 未更改,除非表显示“未更改”。
- 货币更改单位(美元 → 微美元)和应用标识符更改类型 (24 个字符十六进制 → UUID)。这两个变换几乎触及每个代码块。先找到他们
概念模型 Change(先阅读此内容)
该 API 已重新托管到统一平台上,并从“广告系列设置”(app)重新居中
作为平台 (UUID) 的 24 个字符的 Mongo id,将子 Resource 读取折叠到
广告系列对象,五个单独的广告终端合并为一个。
ApplicationLegacy 模型
Organization└─ App (campaignSetId, 24-char hex) ← 路径中的“apps” ├──广告素材 ├─广告素材包 └──广告系列(目标:安装量|留存率|ROAS|creativeTesting|eventOptimization) ├── cpi-bids | source-bids | roas-bids | retention-bids | event-optimization-bids │(5 个单独的子资源,每个子资源为 GET/PUT/PATCH,美元字符串) ├── 定向投放 (GET + PATCH) ├─预算(GET + PATCH,美元;每日或每日每个国家/地区映射) └── assigned-creative-packs(POST/删除 一时间一个)
新模型
Organization└─ 应用程序 (applicationId, UUID ← 路径中的“Applications” ├──广告素材(现在还包括补丁 + 删除) ├─广告素材包 ├──归因(GET + PATCH,应用关卡) ← 新建归因广告位 └── Campaign (optimizationType: cpi|legacyRetention|roas|appEventConversion; isCreativeTesting) ├──出价(ONE PATCH .../bids; ROAS|用户手册|manualSource|appEvent) ├──定向投放(仅限 PATCH) ├──预算上限(仅限补丁,微美元;countryGroupDailyLimits) ├── assign-creative-pack/unassign-creative-pack(基于列表的 PATCH/DELETE) └─(出价/预算/定向投放/资源包的读取来自 GET 广告系列?includeFields=…)Organization└─广告系列(新建的宽组织广告系列列表,按 appId 过滤器)
驱动以下每个变换的变化:
# | Shift | 迁移的后果 |
|---|---|---|
| 1 | | Resource 路径细分段已重命名。id 从 |
| 2 | 金钱 → 微美元 | 所有出价/预算都是美元字符串( |
| 3 | 5 个出价终端 → 1 | |
| 4 | Sub-Resource 内容折叠在中 | Legacy |
| 5 | | 广告系列类型 enum 发生更改和拆分( |
| 6 | 已重新定位归因 | Legacy 在 campaign 创建主体和 app 上设置归因 URL。新建 API:广告系列更新需要 |
| 7 | 分配基于列表 | Legacy 为每个请求分配/取消分配一个打包。新建 API 在一次调用中用 array |
全局更改(Apply to All终端)
方面 | Legacy | 新建 |
|---|---|---|
| Host | | |
| 路径前缀 | | |
| 应用路径细分段 | | |
| 完整示例 | | |
| 身份验证 | HTTP Basic(service-帐户 Key) | HTTP Basic 仍然有效;也接受 Bearer JWT( |
| Org id | 路径中的 |
路径中的 |
| App ID(类型更改) | | |
| 金钱 | 美元小数字符串( | 微美元作为整数字符串/数字 ( |
| 广告系列/广告素材/打包 ID | 24 个字符十六进制数 — 未更改(仍然 | 24 个字符十六进制 — 未更改 |
| 列表信封 | | ⚠️ **不一致:**广告系列和广告素材使用 |
| 分页参数 | | ON
|
授权(角色/权限) — 在假设 403 为错误之前阅读
Authentication 没有变化(相同的 Basic 凭据),但授权没有变化:每次新建
终端由在网关处检查的权限字符串进行门禁(在新建的
在下指定)。广告主路由需要
权限(、、、
、、 等),通过
Unity Cloud Dashboard 中的组织范围服务帐户角色(例如“Advertise API Apps”)。
Editor" grant )。共享
终端接受或发布者端的。
x-unity-gateway.authorization.rulesadvertise.*advertise.campaigns.*advertise.creatives.*advertise.creative_packs.*advertise.bids.updateadvertise.targeting.updateadvertise.apps.*advertise.apps.get/list/create/update/delete…/applicationsadvertise.apps.*monetize.projects.*Agent 说明:
- 在迁移之前,请让人Confirm客户端的服务帐户包含所需的 新建 API 的广告主角色 - 不假定 Legacy API 授权会延续。
- 如果 ON Legacy API 有效的请求在新建的请求上返回 403 且具有相同 凭据,将其视为缺失角色授权,而不是请求错误。停止并表面处理; 请勿尝试“修复”请求。
Rate限制(更更新客户端回退)
操作类 | Legacy | 新建 |
|---|---|---|
读取( | 429 个已定义;每个Resource | 每个资源限制器20/s + 8000/小时 |
创建 ( | (批处理) | 1/s + 60/hour( |
更新( | (批处理) | 1/s + 200/小时( |
| 出价更新 | (批处理数组) | 20/s + 12000/hour( |
| 广告系列管理 | — | 6/s + 8000/小时( |
Master 终端映射
Legacy 操作 | Legacy route | New operationId | 新建路由 | 代码块 |
|---|---|---|---|---|
| | | | A |
| | | | A |
| | | | A |
| | | | A |
| | — | 🚫 无删除应用程序终端 | A |
| | | | B |
| | | | B |
| | | | B |
| — | — | |
| )
B |
| — | — | |
| )
B |
| | | | C |
| | | | C |
| | | | C |
| | | | C |
| | | | C |
| )
|
|
|
D |
| | | | D |
| | | | D |
| | | | D |
| | | | D |
| | | | E |
| …SourceBids | | | | E |
| …RoasBids | | | | E |
| …EventOptimizationBids | | | | E |
| …RetentionBids | | — | 🚫 保留出价已弃用 — 不再支持 | E |
| | —(通过广告系列阅读) | | F |
| | | | F |
|
|
—(通过广告系列阅读) | | 上的字段)
G |
| | | | G |
| | —(通过广告系列阅读) | | H |
| | | | H |
| | | | H |
| | | | I |
| | | | I |
|
|
— | 🚫 ROAS 不再需要资格;已弃用 | 保留I |
| —(归因为 ON campaign/app) | ( | | | J |
代码块 A — Apps → Applications
更改的内容
- 路径细分段 →
apps;idapplications(24 个字符十六进制) →campaignSetId(UUID)。这是高风险重新映射 — 每个广告系列/广告素材/打包调用都是嵌套的 下。版本并在迁移期间保留applicationId映射。legacy campaignSetId → new applicationId - 现在是 ON 创建的必需显式 Field(由
platform隐式表示)。store - 应用关卡归因 URL(/
appAttributionClickUrl)已移至 专用归因终端 — 请参阅代码块 J。appAttributionStartUrl - 没有等效项(已确认为故意)。应用程序程序Lifecycle已移出 广告作用域 Unity Services Foundation (USF),而应用程序程序删除当前为 Disabled 平台宽。新建Applications程序Resource仅显示 列表创建更新。如果 客户端通过 API 删除应用程序,停止并表面。
DELETE app - **列表更改了形状并丢失了分页/过滤器。**返回的 Legacy 带有
GET …/apps/offset和limit/filter[store]的filter[storeId]查询参数。新建{ total, offset, limit, results[] }返回所有 org 的 Bare json Array Applications — 无信封、无分页、无过滤器。删除参数并过滤器/分页 客户端。GET …/applications
Field Mapping — 创建 (advertise-createApp → CreateApplicationPublicDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 不变 |
| | 重新映射枚举 → |
| | 不变值 |
| — | | **新建,必填。**派生自 Legacy |
| — | 🚫 应用程序响应没有 Field。如果客户端依赖于表面,则为表面。 |
| | 呈现在响应上;不是创建输入 — 设置服务器端。 |
| 归因 | **已移动。**创建后通过 |
| 归因 | **已移动。**通过 |
| — | | 新建可选隐私对象 |
| — | | 新建可选分组(共享发布者/广告主应用模型) |
新建 enum:、、、、、
, , , .新建 enum:、、、
, , , , , , , , , .
storeGooglePlayAppleAppStoreSamsungGalaxyAmazonAppStoreMacAppStoreUDPMicrosoftStoreHuaweiAppGalleryAPKplatformAndroidiOSOSXWindowsLinuxWebGLWindows_StorePS4PS5XboxOnetvOSSwitchVisionOSLegacy → 新建(已确认): → ; →
; → 取决于实际存储 — Samsung →
、华为 → ;当无法识别存储时
平台将其贴图到 。
store{store, platform}apple{AppleAppStore, iOS}google{GooglePlay, Android}standalone_android{SamsungGalaxy, Android}{HuaweiAppGallery, Android}{APK, Android}Field Mapping — 响应 (app → ApplicationPublicResponseDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | **类型 Change。**持久化 Mapping。 |
| | unchanged |
| | enum 重新映射(上图) |
| | 未更改(整数,可 null) |
| —(请参阅 | 移至归因资源 |
| — | 🚫 消失 |
| —(不在 DTO 上) | 未在应用响应上公开 |
| — | | new |
⚠️ id 重新映射是风险最高的步骤持久并重写使用legacy campaignSetId → new {applicationId}的每个下游路径。campaignSetId
代码块 B — 广告素材
更改的内容
- 嵌套在 而不是
applications/{applicationId}下。apps/{campaignSetId} - 仍然为 ,首先
multipart/form-datajson,然后是 Binary 文件 Field。creativeInfo - 新建操作:(重命名)和
PATCH …/creatives/{creativeId}。DELETE …/creatives/{creativeId} - enum 值已重命名 (snake_case)。重新映射。
type - 图像 Upload Limit 提高到 20 MB(为 5 MB);可播放项 10 MB。
- 视频上传()的工作方式与 Legacy 完全相同(经 API 所有者确认)。OpenAPI 记录视频创建变体的架构于 2026 年 7 月下旬登陆 — 如果您复制了新建的 规范缺少视频
videoFile变体,请刷新规范,而不是假设不支持视频。oneOf
type enum 重新映射
Legacy | 新建 |
|---|---|
| |
| |
| |
| |
| |
| |
| |
| 🚫 不支持 — 仅存在纵向/横向视频。表面。 |
| — | |
status enum
未更改的设置:、、、、、
.
uploadedprocessingprocessingFailedpendingModerationapprovedrejected多部分字Field名称
creativeInfosquareEndCardFileportraitEndCardFilelandscapeEndCardFileplayableFilecreativeInfofileNameorientationlandscapeportraitbothCreativePublicResponseDtoidnamelanguagetypestatusfiles[]{name,url}createdAtupdatedAt代码块 C — 广告素材包
更改的内容
- 在 下嵌套。CRUD 动词相同(GET/POST/GET/PATCH/删除)。
applications/{applicationId} - 获得
type值:banner、video、playable、video+playable。banner - 列表信封是 Legacy 样式(与广告系列/广告素材不同)。
{ total, offset, limit, results[] } - 响应更丰富:添加 、
applicationId(moderationStatus/pending/approved、 nullable)、rejected(nullable)、ageRating、assignedCampaignIds[]/createdAt。updatedAt
Field Mapping — 创建 (createCreativePack → CreateCreativePackPublicDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 不变 |
| | 未更改(24 个字符的十六进制广告素材 ID) |
| | 相同值 + 新建 |
| | 未更改(可为空) |
| | 未更改(UUID,可 null) |
FieldMapping — 响应
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 24 个字符十六进制 — 未更改 |
| 相同 | 不变 |
| | 已重命名 |
| — | | 新 |
代码块 D — 广告系列
更改的内容
- 在 下嵌套。Get/Update/Delete 是每个应用;现在 列出 org 宽(
applications/{applicationId}、过滤器GET …/organizations/{orgId}/campaigns)—没有每个应用的列表。appIds - →
goal(+optimizationType布尔值 +isCreativeTesting)。appEventType - **归因 URL 不再是广告系列创建的一部分。**通过广告系列创建后设置它们
(
PATCH)或应用归因终端(代码块 J)。attributionLinks - 不是创建 Field,创建只需要
scheduleEnd;通过start设置PATCH。end - 支持
GET campaign(includeFields、bids、budget、creativePacks)—此 就是您现在读取出价/预算/分配的包的方式。application - 值采用大写并已展开:
postInstallWindow、D0、D1、D3、D7、D14。D28
goal → optimizationType 重新映射
Legacy | 新建 |
|---|---|
| |
| |
| |
| |
| |
Field Mapping — 创建 (createCampaign → CreateCampaignDto)
Legacy | 新建 |
|---|---|
| |
| |
| |
| |
| |
Field Mapping — 更新(updateCampaign → UpdateCampaignPublicDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 不变 |
| | date → datetime; |
| | 反转意义 — |
| | uppercased |
| | 现在是一个嵌套对象; |
⚠️ 更新响应是更瘦的对象(:CampaignPublicDetailsResponseDto、id、name、start、end、autoStart、paused),而不是完整的广告系列。 如果客户端关闭 PATCH 响应读取 Other Campaign 字段,请通过attributionLinks重新获取。GET campaign
Field Mapping — 响应(Legacy campaign → CampaignPublicResponseDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 24 个字符十六进制 — 未更改 |
| | 不变 |
| | 上面的重新映射表(反向) |
| | ⚠️ Inverted sense ON read too — |
| — | 🚫 未 ON 新建响应。表面,如果客户端在其上分支。 |
| | date → datetime; |
| | renamed + value Change ( |
| | 已重命名;仅与 |
| — | 🚫 Retention bids 已弃用 — 无写入支持;将 Any 读取值视为仅Legacy |
| | 仅使用 |
| | enum 重命名;单一 → Array |
| | 大写; |
| | 不变 |
| — | | new — 请参阅新规范 |
通过 includeFields 读取
Legacy 读取广告系列的出价/预算/分配的包使用单独的 GET。现在:
.Bid 数组、
、 和完整会返回到广告系列对象。
GET …/campaigns/{campaignId}?includeFields=bids,budget,creativePacks,applicationbudgetcreativePackIds[]application代码块 E — 出价(五个终端 → 一个)
更改的内容
五个 Legacy 子资源(、、、、
),每个 // 超过美元字符串,折叠成一个
键入主体上的单一**(以微美元**为单位)。有
no GET - 通过 读取当前出价。
cpi-bidssource-bidsroas-bidsretention-bidsevent-optimization-bidsGETPUTPATCHPATCH …/campaigns/{campaignId}/bidsGET campaign?includeFields=bids端点 + 身体重新映射
Legacy 子资源 | 在 | 每个入口形状(新建) |
|---|---|---|
| | |
| | |
| | |
| | |
| 🚫 已弃用 — 不支持 | Legacy |
资金变换(关键)
Legacy dollar 字符串 → 新建微美元:乘以 1_000_000。 → 。ROAS
/(已确认):Legacy ROAS 是一个百分比字符串( = 12.34%);
新建是小数比率 - 除以 100( → ; 10% → )。
语义(由 API 所有者确认):
"0.201"201000goaltargetgoal"12.34"target"12.34"0.12340.10Legacy PUT/PATCH 模型 | 新建模型 |
|---|---|
| 单一 |
清除出价(已确认):为中的该出价类型发送空 Array - 相同
作为 Legacy 的特效。
PATCH[]PUT []⚠️ 由于新建取代了而不是合并了 LegacyPATCH的纯粹端口(MERGE) Calls 将悄悄丢弃请求中未包含的每个出价。转换旧版合并样式 对完全设置的写入的更新:通过PATCH读取当前出价,Apply delta 本地,并发送完整的 Array。GET campaign?includeFields=bids
F 代码块 — Budget → Budget Cap
更改的内容
- 已消失 → 通过
GET …/budget读取。GET campaign?includeFields=budget - →
PATCH …/budget.PATCH …/campaigns/{campaignId}/budget-cap - 美元 → 微美元(字符串)。
- 每个国家映射()替换为 指定国家组(
dailyPerCountry: { "US": "123.45", … })。countryGroupDailyLimits: [{ name, countries[], limit }] - ON 响应新建显式类型鉴别器:(
campaignLimitType/unlimited)、total(dailyLimitType/daily/countryDaily).unlimited
Field Mapping(budget → PatchBudgetCapDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | ×1e6。Cap 表示语义继承自 Legacy(每个 API 所有者): |
| | ×1e6 |
| | **重组:**每个 |
| —(通过广告系列预算读取) | 显示 ON 广告系列预算已读,而不是 PATCH 响应 |
代码块 G — 定向投放
更改的内容
- 消失→ 关闭
GET …/targeting读取定向字段。GET campaign - 仍然存在,但主体已重组,大多数 Legacy 设备字段 已丢弃(它们已经是 Legacy 规范中的
PATCH …/targeting)。deprecated
Field Mapping(targetingOptions → UpdateCampaignPublicTargetingDto)
Legacy Field | 新建 Field | 注意 |
|---|---|---|
| | 已重命名(音频源应用程序 ID) |
| | 现在提供程序指定的 Category 列表 |
| | 重组 |
| | 重组 |
| | 现在基于 Subdivision-id |
| — | 🚫已移除(已确认 — 无法统一配置 ON)。删除设置它们的客户端代码;向人类提及放置。 |
代码块 H — 已分配的广告素材包(现在基于列表)
更改的内容
- Legacy 已分配/未分配每个请求打包(/
POST)。DELETE …/assigned-creative-packs - 新建 API 在列表上运行:
- 与
{ creativePackIds: [...] }— 将分配的设置替换为提供的 ID。PATCH …/campaigns/{campaignId}/assign-creative-pack - 与
{ creativePackIds: [...] }— 删除列出的 ID。DELETE …/campaigns/{campaignId}/unassign-creative-pack
- 与
- 当前分配的包列表:(
GET campaign?includeFields=creativePacks)。creativePackIds[]
迁移方法
收集客户端分配给广告系列的所有包,然后 make one
使用完整 Array(而不是 N )。语义已确认:终端取代了
使用提供的完成分配 - 始终发送所需的完整设置,或
Array 中省略的包未分配。
PATCH assign-creative-packPOSTcreativePackIds代码块 I — 推广受众智能定位 → 广告系列管理
更改的内容
Legacy | 新建 |
|---|---|
| |
| |
| 🚫 已移除 — ROAS 广告系列不再需要资格;删除任何门控逻辑 |
| 🚫 已移除 — 留存已完全弃用;表面 Active 留存用途 |
sdk-event-names{ total, results[]{ eventOptimizationType, sdkEventNames[] } }eligibility{ total, results[]{ eventOptimizationType, countries[] } }代码块 J — 归因(已重新分配)
更改的内容
以前在应用程序上设置过归因 URL(/)并通过
进入广告系列创建。新建 API 有一个专用应用关卡归因资源 Plus
ON 广告系列更新的每个广告系列。
appAttributionClickUrlStartUrlattributionLinks- →
GET …/applications/{applicationId}/attribution.{ id, startUrl, clickUrl, viewUrl?, partner, type?, createdAt, updatedAt } - 与
{ startUrl?, clickUrl?, viewUrl? }。PATCH …/applications/{applicationId}/attribution
partnerotheradjustairbridgeappsflyerbranchbytebrewkochavamailrusingulartenjinyandextypeuserLevelnonUserLevelmixed迁移方法
- Move 应用关卡 /
appAttributionClickUrl→appAttributionStartUrl(PATCH …/attribution/clickUrl).startUrl - Move campaign-创建 /
attributionClickUrl→ ON 广告系列的attributionStartUrl(PATCH)创建广告系列后。attributionLinks.{clickUrl,startUrl,viewUrl} - 是新建的(可选)。
viewUrl和其他网址宏:验证规则来自共享的 Legacy 和新建 API(已确认)都使用的归因验证库,因此宏 行为不变 — 保持 Legacy URL 原样。{ifa}
建议的迁移算法(Agent的确定性Order)
- **配置:**将主机交换为 、路径前缀
…/ads/advertiser→/advertise/v1以及/public/v1细分段 →apps。保持 Basic 身份验证。applications - **应用程序(代码块 A):**对于每个 Legacy 应用程序,(重新映射
POST …/applications→store)。持久{store, platform}。不发送归因 此处的 URL。legacy campaignSetId → new applicationId - **归因(代码块 J):**与旧的应用关卡 URL 。
PATCH …/applications/{id}/attribution - **创作者(代码块 B):**重新 Upload/重新映射,转换enum。持久
type是否重新铸造了 ID(验证是否保留了 ID)。legacy creativeId → new creativeId - **广告素材包(代码块 C):**创建引用新建广告素材 ID 的包。
- **广告系列管理(代码块 I):**重新点受众定位查找 —
→
…/audience-pinpointer/sdk-event-names,然后…/applications/{id}/sdk-event-names→…/audience-pinpointer/event-optimization-info.只读; 使用结果向广告系列…/applications/{id}/eligibility/appEventType和符合条件的国家/地区提供信息。 可以直接删除 ROAS 信息门控逻辑(不再需要资格);Retention 信息是 与已已弃用的Retention商品一起消失(请参阅步骤 13)。sdkEventNames - **广告系列(代码块 D):**使用 创建 (+
optimizationType/isCreativeTesting/appEventType),仅限roasType。然后start设置PATCH、end、attributionLinks、autoStart。paused - 出价(代码块 E):兑换美元 → 微美元(ROAS 目标:百分比 → 小数比率,
÷100); 发送一个,其中包含每个出价类型的完整所需设置(PATCH) 替换,从不合并;
PATCH …/bids清除)。留存出价已弃用,请勿迁移它们; 表面 Any 用法。[] - **Budget(代码块 F):**以微美元为单位的;转换
PATCH …/budget-cap映射 →dailyPerCountry.countryGroupDailyLimits[] - **定向投放(代码块 G):**重组为 /
appleDevice/音频源+ Category 列表; 放置已移除的设备字段(将它们表面)。androidDevice - **分配(代码块 H):**每个广告系列一个基于列表的。
PATCH assign-creative-pack - **阅读:**将所有替换为
GET …/{bids,budget,targeting,assigned-creative-packs}.GET campaign?includeFields=… - 已移除功能(表面对人类):(USF 拥有的应用程序生命周期;删除 当前已Disabled)、已已弃用的Retention商品(出价 + 资格)、ROAS 资格 门禁(不再需要 - 将其删除)、Legacy 已弃用的目标字段、
DELETE app和adomain广告素材。squareVideo
验证核对表(迁移后运行)
- 请求路径不包含 、
/advertise/v1、/apps/、/cpi-bids、/source-bids,/roas-bids,/retention-bids,/event-optimization-bids,/audience-pinpointer或/assigned-creative-packs(现为…/budget)。budget-cap - 每个应用程序路径都使用新建的 UUID ,而不是 24 个字符的十六进制
applicationId。campaignSetId - All money values are micro dollars(整数), never dollars decimals like .
"2500.20" - 出价转到单一;读取使用
PATCH …/bids。GET campaign?includeFields=bids - 每个广告都会发送其广告类型的完整设置(替换语义 - 部分 send 会丢弃省略的出价)LegacyMERGE样式的更新已转换为 read-Modify-write。
PATCH - ROAS 目标已从百分比字符串转换为小数比(→
"12.34")。0.1234 - Budget 使用 +
budget-cap(无countryGroupDailyLimits[]映射)。dailyPerCountry - 广告系列已重新映射到
goal(+optimizationType) 和归因 URL 是通过isCreativeTesting/attributionLinks设置的,而不是广告系列创建。…/attribution - Creative 使用新建的 snake_case 值(
type、end_card_square等)。video_portrait - Legacy 的每次读取都重新映射到
enabled,意义反转 (paused⇒enabled:true) — ON 列表、获取和更新响应。paused:false - 关闭广告系列响应时,没有任何内容会解析完整的广告系列字段(它会返回瘦身 细节对象);通过
PATCH重新获取完整状态。GET campaign?includeFields=… - 应用程序列表解析需要裸数组(没有包络)并且不再 发送
{total, results}/offset/limit/filter[store]。filter[storeId] - 分配使用每个广告系列一个基于列表的调用,而不是 N 个单一个分配。
- 、已弃用 Retention 用途(出价/资格)、
DELETE app广告素材以及 Any 已移除的目标字段作为空白显示给人类(如果客户端使用了它们);ROAS 删除了资格审查。squareVideo
快速参考:已移除 / 无等效内容(请勿迁移或制作 - All confirmed by API owner)
- — 没有删除应用程序终端;应用程序生命周期归 USF 所有,删除 当前在平台宽内Disabled。
DELETE app - ROAS 信息 — 已移除;ROAS 广告系列不再需要资格。删除门控逻辑。
- ** Retention(整个商品区域)** - 已弃用:和 Retention 出价没有 继承者。表面 Active Retention 广告系列/出价。
retention-info - 获取出价/预算/定向投放/分配资源包 — 替换为 。
GET campaign?includeFields=… - Legacy 已弃用的目标字段(、
limitedAdTracking、connectionType、screenSize、screenDensity、allowedDevices)和应用**osMax** — 无法 ON Configured unified;删除客户端代码。adomain - 广告素材类型 — 不支持;仅支持
squareVideo/video_portrait。video_landscape