sino-bc-cli 1.8.7 → 1.8.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -7
- package/dist/SKILL.md +1 -1
- package/dist/affordance/biz-line.md +22 -28
- package/dist/api-doc/oapi/biz-line-query.md +3 -3
- package/dist/api-doc/oapi/biz-line-strategy.md +344 -82
- package/dist/api-doc/oapi/sso.md +1 -1
- package/dist/generated/api-catalog.json +1336 -205
- package/dist/index.js +1 -1
- package/dist/skills/default/sino-bc-shared/references/config-and-env.md +1 -1
- package/dist/skills/default/sino-bc-shared/references/write-approval.md +4 -2
- package/dist/skills/oapi/sino-bc-biz-line/SKILL.md +10 -11
- package/dist/skills/oapi/sino-bc-biz-line/references/long-tail-api.md +10 -11
- package/dist/skills/oapi/sino-bc-sso/SKILL.md +1 -1
- package/dist/skills/oapi/sino-bc-sso/references/long-tail-api.md +1 -1
- package/package.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
[
|
|
2
2
|
{
|
|
3
|
-
"name": "
|
|
3
|
+
"name": "biz-line-list",
|
|
4
4
|
"displayName": "查询业务线分页列表",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "查询业务线分页列表。需要查询业务线关联项目和广告账号,使用业务线ID查询【业务线关联项目列表】。",
|
|
6
6
|
"group": "业务线策略",
|
|
7
7
|
"method": "POST",
|
|
8
8
|
"path": "/sino-opti-hive/biz-line/list",
|
|
@@ -136,13 +136,17 @@
|
|
|
136
136
|
"description": "周消耗环比筛选,DOWN_20 = 周消耗下降20%及以上",
|
|
137
137
|
"title": "周消耗环比"
|
|
138
138
|
}
|
|
139
|
-
}
|
|
139
|
+
},
|
|
140
|
+
"required": [
|
|
141
|
+
"pageNum",
|
|
142
|
+
"pageSize"
|
|
143
|
+
]
|
|
140
144
|
}
|
|
141
145
|
},
|
|
142
146
|
{
|
|
143
|
-
"name": "
|
|
147
|
+
"name": "biz-line-detail",
|
|
144
148
|
"displayName": "业务线详情",
|
|
145
|
-
"description": "
|
|
149
|
+
"description": "业务线详情",
|
|
146
150
|
"group": "业务线策略",
|
|
147
151
|
"method": "POST",
|
|
148
152
|
"path": "/sino-opti-hive/biz-line/detail",
|
|
@@ -154,11 +158,22 @@
|
|
|
154
158
|
"summary": "业务线详情",
|
|
155
159
|
"docFile": "biz-line-strategy.md",
|
|
156
160
|
"requestSchema": {
|
|
157
|
-
"
|
|
161
|
+
"type": "object",
|
|
162
|
+
"properties": {
|
|
163
|
+
"id": {
|
|
164
|
+
"type": "integer",
|
|
165
|
+
"format": "int64",
|
|
166
|
+
"title": "业务线ID",
|
|
167
|
+
"example": 1251
|
|
168
|
+
}
|
|
169
|
+
},
|
|
170
|
+
"required": [
|
|
171
|
+
"id"
|
|
172
|
+
]
|
|
158
173
|
}
|
|
159
174
|
},
|
|
160
175
|
{
|
|
161
|
-
"name": "
|
|
176
|
+
"name": "biz-line-save",
|
|
162
177
|
"displayName": "新建业务线",
|
|
163
178
|
"description": "⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。",
|
|
164
179
|
"group": "业务线策略",
|
|
@@ -172,13 +187,169 @@
|
|
|
172
187
|
"summary": "新建业务线",
|
|
173
188
|
"docFile": "biz-line-strategy.md",
|
|
174
189
|
"requestSchema": {
|
|
175
|
-
"
|
|
190
|
+
"type": "object",
|
|
191
|
+
"properties": {
|
|
192
|
+
"name": {
|
|
193
|
+
"type": "string",
|
|
194
|
+
"description": "业务线名称,业务/产品线名称不可重复",
|
|
195
|
+
"title": "业务线名称",
|
|
196
|
+
"example": "示例业务线"
|
|
197
|
+
},
|
|
198
|
+
"mediaChannels": {
|
|
199
|
+
"type": "array",
|
|
200
|
+
"items": {
|
|
201
|
+
"type": "integer",
|
|
202
|
+
"format": "int32"
|
|
203
|
+
},
|
|
204
|
+
"description": "投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code;名称见同接口 name",
|
|
205
|
+
"title": "投放渠道"
|
|
206
|
+
},
|
|
207
|
+
"strategyControlDegree": {
|
|
208
|
+
"type": "integer",
|
|
209
|
+
"format": "int32",
|
|
210
|
+
"description": "策略掌控程度:1弱(以客户策略为主) 2强(以我方提供策略) 3中(与客户共创)",
|
|
211
|
+
"title": "策略掌控程度",
|
|
212
|
+
"example": 3
|
|
213
|
+
},
|
|
214
|
+
"adCategoryIndustryIds": {
|
|
215
|
+
"type": "array",
|
|
216
|
+
"items": {
|
|
217
|
+
"type": "integer",
|
|
218
|
+
"format": "int64"
|
|
219
|
+
},
|
|
220
|
+
"description": "投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id",
|
|
221
|
+
"title": "投放行业ID"
|
|
222
|
+
},
|
|
223
|
+
"adCategoryProjectIds": {
|
|
224
|
+
"type": "array",
|
|
225
|
+
"items": {
|
|
226
|
+
"type": "integer",
|
|
227
|
+
"format": "int64"
|
|
228
|
+
},
|
|
229
|
+
"description": "投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id;选其他时可为空,改填 adCategoryOther",
|
|
230
|
+
"title": "投放品类ID"
|
|
231
|
+
},
|
|
232
|
+
"adCategoryOther": {
|
|
233
|
+
"type": "string",
|
|
234
|
+
"description": "投放品类-其他说明",
|
|
235
|
+
"title": "投放品类-其他"
|
|
236
|
+
},
|
|
237
|
+
"customerTypeIds": {
|
|
238
|
+
"type": "array",
|
|
239
|
+
"items": {
|
|
240
|
+
"type": "integer",
|
|
241
|
+
"format": "int64"
|
|
242
|
+
},
|
|
243
|
+
"description": "客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id",
|
|
244
|
+
"title": "客户类型ID"
|
|
245
|
+
},
|
|
246
|
+
"customerTypeOther": {
|
|
247
|
+
"type": "string",
|
|
248
|
+
"description": "客户类型-其他说明",
|
|
249
|
+
"title": "客户类型-其他"
|
|
250
|
+
},
|
|
251
|
+
"amUserIds": {
|
|
252
|
+
"type": "array",
|
|
253
|
+
"items": {
|
|
254
|
+
"type": "integer",
|
|
255
|
+
"format": "int32"
|
|
256
|
+
},
|
|
257
|
+
"description": "AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId;也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
|
|
258
|
+
"title": "AM用户ID"
|
|
259
|
+
},
|
|
260
|
+
"pmUserIds": {
|
|
261
|
+
"type": "array",
|
|
262
|
+
"items": {
|
|
263
|
+
"type": "integer",
|
|
264
|
+
"format": "int32"
|
|
265
|
+
},
|
|
266
|
+
"description": "PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId;也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
|
|
267
|
+
"title": "PM用户ID"
|
|
268
|
+
},
|
|
269
|
+
"customerInfrastructure": {
|
|
270
|
+
"type": "array",
|
|
271
|
+
"items": {
|
|
272
|
+
"type": "integer",
|
|
273
|
+
"format": "int32"
|
|
274
|
+
},
|
|
275
|
+
"description": "1=数据追踪方式:AdJust,2=数据追踪方式:AF,3=数据追踪方式:其他MMP,4=数据追踪方式:客户BI,5=数据追踪方式:媒体后台,6=素材产出方式:CB,7=素材产出方式:客户提供,8=素材产出方式:内部设计师制作,9=素材产出方式:无需素材(ASA、推流等),10=基建情况:基建完善,11=基建情况:三方回传数据异常,12=基建情况:APP埋点异常",
|
|
276
|
+
"title": "客户基建情况"
|
|
277
|
+
},
|
|
278
|
+
"coreIndex": {
|
|
279
|
+
"type": "string",
|
|
280
|
+
"description": "核心指标",
|
|
281
|
+
"title": "核心指标",
|
|
282
|
+
"example": "ROAS"
|
|
283
|
+
},
|
|
284
|
+
"monthlyMaterialCount": {
|
|
285
|
+
"type": "string",
|
|
286
|
+
"description": "月度上新素材量",
|
|
287
|
+
"title": "月度上新素材量",
|
|
288
|
+
"example": "20"
|
|
289
|
+
},
|
|
290
|
+
"projectInitStatus": {
|
|
291
|
+
"type": "string",
|
|
292
|
+
"description": "项目初始化状态",
|
|
293
|
+
"title": "项目初始化状态"
|
|
294
|
+
},
|
|
295
|
+
"projectBrief": {
|
|
296
|
+
"type": "string",
|
|
297
|
+
"description": "项目 Brief",
|
|
298
|
+
"title": "项目Brief"
|
|
299
|
+
},
|
|
300
|
+
"corporationIds": {
|
|
301
|
+
"type": "array",
|
|
302
|
+
"items": {
|
|
303
|
+
"type": "string"
|
|
304
|
+
},
|
|
305
|
+
"description": "关联签约主体 ID(字符串)。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID",
|
|
306
|
+
"title": "关联签约主体ID"
|
|
307
|
+
},
|
|
308
|
+
"projectIds": {
|
|
309
|
+
"type": "array",
|
|
310
|
+
"items": {
|
|
311
|
+
"type": "integer",
|
|
312
|
+
"format": "int64"
|
|
313
|
+
},
|
|
314
|
+
"description": "关联项目 ID",
|
|
315
|
+
"title": "关联项目ID"
|
|
316
|
+
},
|
|
317
|
+
"ssoTeamCode": {
|
|
318
|
+
"type": "string",
|
|
319
|
+
"description": "组别 code,单选,必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
|
|
320
|
+
"title": "组别code",
|
|
321
|
+
"example": "TEAM_DEMO"
|
|
322
|
+
},
|
|
323
|
+
"businessRegion": {
|
|
324
|
+
"type": "string",
|
|
325
|
+
"description": "EAST_CHINA=华东,SOUTH_CHINA=华南,NORTH_CHINA=华北。必填",
|
|
326
|
+
"title": "商务地区",
|
|
327
|
+
"example": "CN"
|
|
328
|
+
},
|
|
329
|
+
"projectRating": {
|
|
330
|
+
"type": "string",
|
|
331
|
+
"description": "S、A、B、C。非新客必填",
|
|
332
|
+
"title": "项目评级",
|
|
333
|
+
"example": "A"
|
|
334
|
+
},
|
|
335
|
+
"newCustomerTag": {
|
|
336
|
+
"type": "string",
|
|
337
|
+
"description": "NEW_TAG=是(新客),NONE_NEW_TAG=否(非新客)",
|
|
338
|
+
"title": "新客标签",
|
|
339
|
+
"example": "OLD"
|
|
340
|
+
}
|
|
341
|
+
},
|
|
342
|
+
"required": [
|
|
343
|
+
"name",
|
|
344
|
+
"ssoTeamCode",
|
|
345
|
+
"businessRegion"
|
|
346
|
+
]
|
|
176
347
|
}
|
|
177
348
|
},
|
|
178
349
|
{
|
|
179
|
-
"name": "
|
|
180
|
-
"displayName": "
|
|
181
|
-
"description": "
|
|
350
|
+
"name": "biz-line-update",
|
|
351
|
+
"displayName": "更新业务线",
|
|
352
|
+
"description": "更新业务线信息",
|
|
182
353
|
"group": "业务线策略",
|
|
183
354
|
"method": "POST",
|
|
184
355
|
"path": "/sino-opti-hive/biz-line/update",
|
|
@@ -187,15 +358,187 @@
|
|
|
187
358
|
"domain": "biz-line",
|
|
188
359
|
"shortcut": "+update",
|
|
189
360
|
"risk": "write",
|
|
190
|
-
"summary": "
|
|
361
|
+
"summary": "更新业务线",
|
|
191
362
|
"docFile": "biz-line-strategy.md",
|
|
192
363
|
"requestSchema": {
|
|
193
|
-
"
|
|
364
|
+
"type": "object",
|
|
365
|
+
"properties": {
|
|
366
|
+
"id": {
|
|
367
|
+
"type": "integer",
|
|
368
|
+
"format": "int64",
|
|
369
|
+
"description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
|
|
370
|
+
"title": "业务线ID",
|
|
371
|
+
"example": 1251
|
|
372
|
+
},
|
|
373
|
+
"status": {
|
|
374
|
+
"type": "integer",
|
|
375
|
+
"format": "int32",
|
|
376
|
+
"description": "状态:1进行中 2已完成 3已暂停",
|
|
377
|
+
"title": "状态",
|
|
378
|
+
"example": 1
|
|
379
|
+
},
|
|
380
|
+
"name": {
|
|
381
|
+
"type": "string",
|
|
382
|
+
"description": "业务线名称,业务/产品线名称不可重复",
|
|
383
|
+
"title": "业务线名称",
|
|
384
|
+
"example": "示例业务线"
|
|
385
|
+
},
|
|
386
|
+
"mediaChannels": {
|
|
387
|
+
"type": "array",
|
|
388
|
+
"items": {
|
|
389
|
+
"type": "integer",
|
|
390
|
+
"format": "int32"
|
|
391
|
+
},
|
|
392
|
+
"description": "投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code;名称见同接口 name",
|
|
393
|
+
"title": "投放渠道"
|
|
394
|
+
},
|
|
395
|
+
"strategyControlDegree": {
|
|
396
|
+
"type": "integer",
|
|
397
|
+
"format": "int32",
|
|
398
|
+
"description": "策略掌控程度:1弱(以客户策略为主) 2强(以我方提供策略) 3中(与客户共创)",
|
|
399
|
+
"title": "策略掌控程度",
|
|
400
|
+
"example": 3
|
|
401
|
+
},
|
|
402
|
+
"adCategoryIndustryIds": {
|
|
403
|
+
"type": "array",
|
|
404
|
+
"items": {
|
|
405
|
+
"type": "integer",
|
|
406
|
+
"format": "int64"
|
|
407
|
+
},
|
|
408
|
+
"description": "投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id",
|
|
409
|
+
"title": "投放行业ID"
|
|
410
|
+
},
|
|
411
|
+
"adCategoryProjectIds": {
|
|
412
|
+
"type": "array",
|
|
413
|
+
"items": {
|
|
414
|
+
"type": "integer",
|
|
415
|
+
"format": "int64"
|
|
416
|
+
},
|
|
417
|
+
"description": "投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id;选其他时可为空,改填 adCategoryOther",
|
|
418
|
+
"title": "投放品类ID"
|
|
419
|
+
},
|
|
420
|
+
"adCategoryOther": {
|
|
421
|
+
"type": "string",
|
|
422
|
+
"description": "投放品类-其他说明",
|
|
423
|
+
"title": "投放品类-其他"
|
|
424
|
+
},
|
|
425
|
+
"customerTypeIds": {
|
|
426
|
+
"type": "array",
|
|
427
|
+
"items": {
|
|
428
|
+
"type": "integer",
|
|
429
|
+
"format": "int64"
|
|
430
|
+
},
|
|
431
|
+
"description": "客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id",
|
|
432
|
+
"title": "客户类型ID"
|
|
433
|
+
},
|
|
434
|
+
"customerTypeOther": {
|
|
435
|
+
"type": "string",
|
|
436
|
+
"description": "客户类型-其他说明",
|
|
437
|
+
"title": "客户类型-其他"
|
|
438
|
+
},
|
|
439
|
+
"amUserIds": {
|
|
440
|
+
"type": "array",
|
|
441
|
+
"items": {
|
|
442
|
+
"type": "integer",
|
|
443
|
+
"format": "int32"
|
|
444
|
+
},
|
|
445
|
+
"description": "AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId;也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
|
|
446
|
+
"title": "AM用户ID"
|
|
447
|
+
},
|
|
448
|
+
"pmUserIds": {
|
|
449
|
+
"type": "array",
|
|
450
|
+
"items": {
|
|
451
|
+
"type": "integer",
|
|
452
|
+
"format": "int32"
|
|
453
|
+
},
|
|
454
|
+
"description": "PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId;也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
|
|
455
|
+
"title": "PM用户ID"
|
|
456
|
+
},
|
|
457
|
+
"customerInfrastructure": {
|
|
458
|
+
"type": "array",
|
|
459
|
+
"items": {
|
|
460
|
+
"type": "integer",
|
|
461
|
+
"format": "int32"
|
|
462
|
+
},
|
|
463
|
+
"description": "1=数据追踪方式:AdJust,2=数据追踪方式:AF,3=数据追踪方式:其他MMP,4=数据追踪方式:客户BI,5=数据追踪方式:媒体后台,6=素材产出方式:CB,7=素材产出方式:客户提供,8=素材产出方式:内部设计师制作,9=素材产出方式:无需素材(ASA、推流等),10=基建情况:基建完善,11=基建情况:三方回传数据异常,12=基建情况:APP埋点异常",
|
|
464
|
+
"title": "客户基建情况"
|
|
465
|
+
},
|
|
466
|
+
"coreIndex": {
|
|
467
|
+
"type": "string",
|
|
468
|
+
"description": "核心指标",
|
|
469
|
+
"title": "核心指标",
|
|
470
|
+
"example": "ROAS"
|
|
471
|
+
},
|
|
472
|
+
"monthlyMaterialCount": {
|
|
473
|
+
"type": "string",
|
|
474
|
+
"description": "月度上新素材量",
|
|
475
|
+
"title": "月度上新素材量",
|
|
476
|
+
"example": "20"
|
|
477
|
+
},
|
|
478
|
+
"projectInitStatus": {
|
|
479
|
+
"type": "string",
|
|
480
|
+
"description": "项目初始化状态",
|
|
481
|
+
"title": "项目初始化状态"
|
|
482
|
+
},
|
|
483
|
+
"projectBrief": {
|
|
484
|
+
"type": "string",
|
|
485
|
+
"description": "项目 Brief",
|
|
486
|
+
"title": "项目Brief"
|
|
487
|
+
},
|
|
488
|
+
"corporationIds": {
|
|
489
|
+
"type": "array",
|
|
490
|
+
"items": {
|
|
491
|
+
"type": "string"
|
|
492
|
+
},
|
|
493
|
+
"description": "关联签约主体 ID(字符串)。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID",
|
|
494
|
+
"title": "关联签约主体ID"
|
|
495
|
+
},
|
|
496
|
+
"projectIds": {
|
|
497
|
+
"type": "array",
|
|
498
|
+
"items": {
|
|
499
|
+
"type": "integer",
|
|
500
|
+
"format": "int64"
|
|
501
|
+
},
|
|
502
|
+
"description": "关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取;按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds",
|
|
503
|
+
"title": "关联项目ID"
|
|
504
|
+
},
|
|
505
|
+
"ssoTeamCode": {
|
|
506
|
+
"type": "string",
|
|
507
|
+
"description": "组别 code,单选,必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
|
|
508
|
+
"title": "组别code",
|
|
509
|
+
"example": "TEAM_DEMO"
|
|
510
|
+
},
|
|
511
|
+
"businessRegion": {
|
|
512
|
+
"type": "string",
|
|
513
|
+
"description": "EAST_CHINA=华东,SOUTH_CHINA=华南,NORTH_CHINA=华北。必填",
|
|
514
|
+
"title": "商务地区",
|
|
515
|
+
"example": "CN"
|
|
516
|
+
},
|
|
517
|
+
"projectRating": {
|
|
518
|
+
"type": "string",
|
|
519
|
+
"description": "S、A、B、C。非新客必填",
|
|
520
|
+
"title": "项目评级",
|
|
521
|
+
"example": "A"
|
|
522
|
+
},
|
|
523
|
+
"newCustomerTag": {
|
|
524
|
+
"type": "string",
|
|
525
|
+
"description": "NEW_TAG=是(新客),NONE_NEW_TAG=否(非新客)",
|
|
526
|
+
"title": "新客标签",
|
|
527
|
+
"example": "OLD"
|
|
528
|
+
}
|
|
529
|
+
},
|
|
530
|
+
"required": [
|
|
531
|
+
"id",
|
|
532
|
+
"status",
|
|
533
|
+
"name",
|
|
534
|
+
"ssoTeamCode",
|
|
535
|
+
"businessRegion"
|
|
536
|
+
]
|
|
194
537
|
}
|
|
195
538
|
},
|
|
196
539
|
{
|
|
197
|
-
"name": "
|
|
198
|
-
"displayName": "
|
|
540
|
+
"name": "biz-line-status-update",
|
|
541
|
+
"displayName": "更新业务线状态",
|
|
199
542
|
"description": "⚠️ 写操作。仅更新状态与操作人;成功时 result 为 Boolean。status:1进行中 2已完成 3已暂停。",
|
|
200
543
|
"group": "业务线策略",
|
|
201
544
|
"method": "POST",
|
|
@@ -205,14 +548,33 @@
|
|
|
205
548
|
"domain": "biz-line",
|
|
206
549
|
"shortcut": "+status",
|
|
207
550
|
"risk": "write",
|
|
208
|
-
"summary": "
|
|
551
|
+
"summary": "更新业务线状态",
|
|
209
552
|
"docFile": "biz-line-strategy.md",
|
|
210
553
|
"requestSchema": {
|
|
211
|
-
"
|
|
554
|
+
"type": "object",
|
|
555
|
+
"properties": {
|
|
556
|
+
"id": {
|
|
557
|
+
"type": "integer",
|
|
558
|
+
"format": "int64",
|
|
559
|
+
"title": "业务线ID",
|
|
560
|
+
"example": 1251
|
|
561
|
+
},
|
|
562
|
+
"status": {
|
|
563
|
+
"type": "integer",
|
|
564
|
+
"format": "int32",
|
|
565
|
+
"description": "状态:1进行中 2已完成 3已暂停;对应 BizLineStatusEnum",
|
|
566
|
+
"title": "状态",
|
|
567
|
+
"example": 1
|
|
568
|
+
}
|
|
569
|
+
},
|
|
570
|
+
"required": [
|
|
571
|
+
"id",
|
|
572
|
+
"status"
|
|
573
|
+
]
|
|
212
574
|
}
|
|
213
575
|
},
|
|
214
576
|
{
|
|
215
|
-
"name": "
|
|
577
|
+
"name": "biz-line-del",
|
|
216
578
|
"displayName": "删除业务线",
|
|
217
579
|
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否删除成功。",
|
|
218
580
|
"group": "业务线策略",
|
|
@@ -226,141 +588,625 @@
|
|
|
226
588
|
"summary": "删除业务线",
|
|
227
589
|
"docFile": "biz-line-strategy.md",
|
|
228
590
|
"requestSchema": {
|
|
229
|
-
"
|
|
591
|
+
"type": "object",
|
|
592
|
+
"properties": {
|
|
593
|
+
"id": {
|
|
594
|
+
"type": "integer",
|
|
595
|
+
"format": "int64",
|
|
596
|
+
"title": "业务线ID",
|
|
597
|
+
"example": 1251
|
|
598
|
+
}
|
|
599
|
+
},
|
|
600
|
+
"required": [
|
|
601
|
+
"id"
|
|
602
|
+
]
|
|
230
603
|
}
|
|
231
604
|
},
|
|
232
605
|
{
|
|
233
|
-
"name": "
|
|
234
|
-
"displayName": "
|
|
235
|
-
"description": "
|
|
606
|
+
"name": "biz-line-strategy-list",
|
|
607
|
+
"displayName": "查询投放策略分页列表",
|
|
608
|
+
"description": "查询投放策略分页列表",
|
|
236
609
|
"group": "业务线策略",
|
|
237
610
|
"method": "POST",
|
|
238
|
-
"path": "/sino-opti-hive/biz-line/strategy/
|
|
611
|
+
"path": "/sino-opti-hive/biz-line/strategy/list",
|
|
239
612
|
"timeout": 20000,
|
|
240
613
|
"tag": "业务线策略",
|
|
241
614
|
"domain": "biz-line",
|
|
242
|
-
"shortcut": "+
|
|
615
|
+
"shortcut": "+strategies",
|
|
243
616
|
"risk": "read",
|
|
244
|
-
"summary": "
|
|
617
|
+
"summary": "查询投放策略分页列表",
|
|
245
618
|
"docFile": "biz-line-strategy.md",
|
|
246
619
|
"requestSchema": {
|
|
247
|
-
"
|
|
620
|
+
"type": "object",
|
|
621
|
+
"properties": {
|
|
622
|
+
"pageNum": {
|
|
623
|
+
"type": "integer",
|
|
624
|
+
"format": "int32",
|
|
625
|
+
"description": "页码,从 1 开始",
|
|
626
|
+
"title": "页码",
|
|
627
|
+
"example": 1
|
|
628
|
+
},
|
|
629
|
+
"pageSize": {
|
|
630
|
+
"type": "integer",
|
|
631
|
+
"format": "int32",
|
|
632
|
+
"description": "每页条数",
|
|
633
|
+
"title": "每页条数",
|
|
634
|
+
"example": 20
|
|
635
|
+
},
|
|
636
|
+
"sortDirection": {
|
|
637
|
+
"type": "string",
|
|
638
|
+
"description": "创建日期排序 DESC 或 ASC,默认 DESC",
|
|
639
|
+
"title": "排序方向",
|
|
640
|
+
"example": "DESC"
|
|
641
|
+
},
|
|
642
|
+
"bizLineId": {
|
|
643
|
+
"type": "integer",
|
|
644
|
+
"format": "int64",
|
|
645
|
+
"description": "可选,不传则按权限查全部可见业务线。",
|
|
646
|
+
"title": "业务线ID",
|
|
647
|
+
"example": 1251
|
|
648
|
+
},
|
|
649
|
+
"trafficLight": {
|
|
650
|
+
"type": "integer",
|
|
651
|
+
"format": "int32",
|
|
652
|
+
"description": "红绿灯筛选(策略表现):1=绿灯KPI达标,2=黄灯距KPIGAP20%内,3=红灯距KPIGAP20%以上,4=红灯已暂停,5=黄灯存在风险,6=绿灯KPI达标且项目顺利。",
|
|
653
|
+
"title": "红绿灯"
|
|
654
|
+
}
|
|
655
|
+
},
|
|
656
|
+
"required": [
|
|
657
|
+
"pageNum",
|
|
658
|
+
"pageSize"
|
|
659
|
+
]
|
|
248
660
|
}
|
|
249
661
|
},
|
|
250
662
|
{
|
|
251
|
-
"name": "
|
|
252
|
-
"displayName": "
|
|
253
|
-
"description": "
|
|
663
|
+
"name": "biz-line-strategy-spend",
|
|
664
|
+
"displayName": "查询投放策略消耗信息",
|
|
665
|
+
"description": "查询投放策略消耗信息",
|
|
254
666
|
"group": "业务线策略",
|
|
255
667
|
"method": "POST",
|
|
256
|
-
"path": "/sino-opti-hive/biz-line/strategy/
|
|
668
|
+
"path": "/sino-opti-hive/biz-line/strategy/spend",
|
|
257
669
|
"timeout": 20000,
|
|
258
670
|
"tag": "业务线策略",
|
|
259
671
|
"domain": "biz-line",
|
|
260
|
-
"shortcut": "+
|
|
672
|
+
"shortcut": "+spend",
|
|
261
673
|
"risk": "read",
|
|
262
|
-
"summary": "
|
|
674
|
+
"summary": "查询投放策略消耗信息",
|
|
263
675
|
"docFile": "biz-line-strategy.md",
|
|
264
676
|
"requestSchema": {
|
|
265
677
|
"type": "object",
|
|
266
678
|
"properties": {
|
|
267
|
-
"
|
|
679
|
+
"strategyId": {
|
|
680
|
+
"type": "integer",
|
|
681
|
+
"format": "int64",
|
|
682
|
+
"description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id,或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
|
|
683
|
+
"title": "投放策略ID",
|
|
684
|
+
"example": 1
|
|
685
|
+
}
|
|
686
|
+
},
|
|
687
|
+
"required": [
|
|
688
|
+
"strategyId"
|
|
689
|
+
]
|
|
690
|
+
}
|
|
691
|
+
},
|
|
692
|
+
{
|
|
693
|
+
"name": "biz-line-strategy-save",
|
|
694
|
+
"displayName": "新建投放策略",
|
|
695
|
+
"description": "新建投放策略,投放策略按周填写",
|
|
696
|
+
"group": "业务线策略",
|
|
697
|
+
"method": "POST",
|
|
698
|
+
"path": "/sino-opti-hive/biz-line/strategy/save",
|
|
699
|
+
"timeout": 20000,
|
|
700
|
+
"tag": "业务线策略",
|
|
701
|
+
"domain": "biz-line",
|
|
702
|
+
"shortcut": "+strategy-save",
|
|
703
|
+
"risk": "write",
|
|
704
|
+
"summary": "新建投放策略",
|
|
705
|
+
"docFile": "biz-line-strategy.md",
|
|
706
|
+
"requestSchema": {
|
|
707
|
+
"type": "object",
|
|
708
|
+
"properties": {
|
|
709
|
+
"bizLineId": {
|
|
710
|
+
"type": "integer",
|
|
711
|
+
"format": "int64",
|
|
712
|
+
"description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
|
|
713
|
+
"title": "业务线ID",
|
|
714
|
+
"example": 1251
|
|
715
|
+
},
|
|
716
|
+
"periodStart": {
|
|
717
|
+
"type": "string",
|
|
718
|
+
"format": "date",
|
|
719
|
+
"description": "策略周期起(日期)",
|
|
720
|
+
"title": "策略周期起",
|
|
721
|
+
"example": "2026-09-01"
|
|
722
|
+
},
|
|
723
|
+
"periodEnd": {
|
|
724
|
+
"type": "string",
|
|
725
|
+
"format": "date",
|
|
726
|
+
"description": "策略周期止(日期)",
|
|
727
|
+
"title": "策略周期止",
|
|
728
|
+
"example": "2026-09-01"
|
|
729
|
+
},
|
|
730
|
+
"budgetStrategyTags": {
|
|
731
|
+
"type": "array",
|
|
732
|
+
"items": {
|
|
733
|
+
"type": "integer",
|
|
734
|
+
"format": "int64"
|
|
735
|
+
},
|
|
736
|
+
"description": "预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
|
|
737
|
+
"title": "预算策略标签ID"
|
|
738
|
+
},
|
|
739
|
+
"budgetStrategySupplement": {
|
|
740
|
+
"type": "string",
|
|
741
|
+
"description": "预算策略补充说明",
|
|
742
|
+
"title": "预算策略补充说明"
|
|
743
|
+
},
|
|
744
|
+
"mediaStrategyTags": {
|
|
745
|
+
"type": "array",
|
|
746
|
+
"items": {
|
|
747
|
+
"type": "integer",
|
|
748
|
+
"format": "int64"
|
|
749
|
+
},
|
|
750
|
+
"description": "媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
|
|
751
|
+
"title": "媒介策略标签ID"
|
|
752
|
+
},
|
|
753
|
+
"mediaStrategySupplement": {
|
|
754
|
+
"type": "string",
|
|
755
|
+
"description": "媒介策略补充说明",
|
|
756
|
+
"title": "媒介策略补充说明"
|
|
757
|
+
},
|
|
758
|
+
"audienceStrategyTags": {
|
|
759
|
+
"type": "array",
|
|
760
|
+
"items": {
|
|
761
|
+
"type": "integer",
|
|
762
|
+
"format": "int64"
|
|
763
|
+
},
|
|
764
|
+
"description": "受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
|
|
765
|
+
"title": "受众策略标签ID"
|
|
766
|
+
},
|
|
767
|
+
"audienceStrategySupplement": {
|
|
768
|
+
"type": "string",
|
|
769
|
+
"description": "受众策略补充说明",
|
|
770
|
+
"title": "受众策略补充说明"
|
|
771
|
+
},
|
|
772
|
+
"creativeStrategy": {
|
|
773
|
+
"type": "string",
|
|
774
|
+
"description": "素材创意策略说明,最大 5000 字",
|
|
775
|
+
"title": "素材创意策略说明"
|
|
776
|
+
},
|
|
777
|
+
"previewPeriodStart": {
|
|
778
|
+
"type": "string",
|
|
779
|
+
"format": "date",
|
|
780
|
+
"description": "上期(preview)策略周期起;缺省为本期 periodStart 的上一自然周周一",
|
|
781
|
+
"title": "上期策略周期起",
|
|
782
|
+
"example": "2026-09-01"
|
|
783
|
+
},
|
|
784
|
+
"previewPeriodEnd": {
|
|
785
|
+
"type": "string",
|
|
786
|
+
"format": "date",
|
|
787
|
+
"description": "上期(preview)策略周期止;缺省为 previewPeriodStart+6(周日)",
|
|
788
|
+
"title": "上期策略周期止",
|
|
789
|
+
"example": "2026-09-01"
|
|
790
|
+
},
|
|
791
|
+
"previewBudgetStrategyTags": {
|
|
792
|
+
"type": "array",
|
|
793
|
+
"items": {
|
|
794
|
+
"type": "integer",
|
|
795
|
+
"format": "int64"
|
|
796
|
+
},
|
|
797
|
+
"description": "上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
|
|
798
|
+
"title": "上期预算策略标签ID"
|
|
799
|
+
},
|
|
800
|
+
"previewBudgetStrategySupplement": {
|
|
801
|
+
"type": "string",
|
|
802
|
+
"description": "上期预算策略补充说明",
|
|
803
|
+
"title": "上期预算策略补充说明"
|
|
804
|
+
},
|
|
805
|
+
"previewMediaStrategyTags": {
|
|
806
|
+
"type": "array",
|
|
807
|
+
"items": {
|
|
808
|
+
"type": "integer",
|
|
809
|
+
"format": "int64"
|
|
810
|
+
},
|
|
811
|
+
"description": "上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
|
|
812
|
+
"title": "上期媒介策略标签ID"
|
|
813
|
+
},
|
|
814
|
+
"previewMediaStrategySupplement": {
|
|
815
|
+
"type": "string",
|
|
816
|
+
"description": "上期媒介策略补充说明",
|
|
817
|
+
"title": "上期媒介策略补充说明"
|
|
818
|
+
},
|
|
819
|
+
"previewAudienceStrategyTags": {
|
|
820
|
+
"type": "array",
|
|
821
|
+
"items": {
|
|
822
|
+
"type": "integer",
|
|
823
|
+
"format": "int64"
|
|
824
|
+
},
|
|
825
|
+
"description": "上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
|
|
826
|
+
"title": "上期受众策略标签ID"
|
|
827
|
+
},
|
|
828
|
+
"previewAudienceStrategySupplement": {
|
|
829
|
+
"type": "string",
|
|
830
|
+
"description": "上期受众策略补充说明",
|
|
831
|
+
"title": "上期受众策略补充说明"
|
|
832
|
+
},
|
|
833
|
+
"previewCreativeStrategy": {
|
|
834
|
+
"type": "string",
|
|
835
|
+
"description": "上期素材创意策略说明,最大 5000 字",
|
|
836
|
+
"title": "上期素材创意策略说明"
|
|
837
|
+
},
|
|
838
|
+
"trafficLight": {
|
|
839
|
+
"type": "integer",
|
|
840
|
+
"format": "int32",
|
|
841
|
+
"description": "红绿灯:1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利",
|
|
842
|
+
"title": "红绿灯"
|
|
843
|
+
},
|
|
844
|
+
"coreIssueCategories": {
|
|
845
|
+
"type": "array",
|
|
846
|
+
"items": {
|
|
847
|
+
"type": "integer",
|
|
848
|
+
"format": "int32"
|
|
849
|
+
},
|
|
850
|
+
"description": "1=受众策略问题,2=跨媒介策略问题,3=媒介广告产品使用策略问题,4=出价策略问题,5=素材策略问题,6=素材执行问题,7=素材管理问题,8=投放规划问题,9=媒体素材政策/尺度/风控问题,10=媒体适配/潜力问题,11=市场选择/竞争问题,12=客户对接不顺畅,13=客户侧:数据对接问题,14=客户侧:产品问题/投放生命周期问题,15=客户侧:运营/基建问题,16=客户侧:存在投放限制,17=客户侧:转自投,18=客户侧:需求临时无规划,19=客户侧:KPI不合理,20=投放生命周期问题/素材疲劳问题,21=内部团队人员调配问题,22=其他",
|
|
851
|
+
"title": "核心问题分类"
|
|
852
|
+
},
|
|
853
|
+
"issuesAndOpportunities": {
|
|
854
|
+
"type": "string",
|
|
855
|
+
"description": "项目问题&机会,最大 5000 字",
|
|
856
|
+
"title": "项目问题&机会"
|
|
857
|
+
},
|
|
858
|
+
"spend": {
|
|
859
|
+
"type": "string",
|
|
860
|
+
"description": "周期投放消耗(回顾,展示用字符串),最大 50 字",
|
|
861
|
+
"title": "周期投放消耗"
|
|
862
|
+
},
|
|
863
|
+
"customerSatisfaction": {
|
|
864
|
+
"type": "integer",
|
|
865
|
+
"format": "int32",
|
|
866
|
+
"description": "客户满意度:1满意 2不满意",
|
|
867
|
+
"title": "客户满意度"
|
|
868
|
+
},
|
|
869
|
+
"satisfactionReason": {
|
|
870
|
+
"type": "string",
|
|
871
|
+
"description": "满意度原因说明,最大 5000 字",
|
|
872
|
+
"title": "满意度原因说明"
|
|
873
|
+
},
|
|
874
|
+
"coreEffectIndex": {
|
|
875
|
+
"type": "string",
|
|
876
|
+
"description": "核心效果指标,最大 5000 字",
|
|
877
|
+
"title": "核心效果指标"
|
|
878
|
+
},
|
|
879
|
+
"budgetStrategyEffect": {
|
|
880
|
+
"type": "integer",
|
|
881
|
+
"format": "int32",
|
|
882
|
+
"description": "预算策略效果:1有效 2无效 3待观察",
|
|
883
|
+
"title": "预算策略效果"
|
|
884
|
+
},
|
|
885
|
+
"budgetStrategyLearning": {
|
|
886
|
+
"type": "string",
|
|
887
|
+
"description": "预算策略 learning",
|
|
888
|
+
"title": "预算策略learning"
|
|
889
|
+
},
|
|
890
|
+
"mediaStrategyEffect": {
|
|
891
|
+
"type": "integer",
|
|
892
|
+
"format": "int32",
|
|
893
|
+
"description": "媒介策略效果:1有效 2无效 3待观察",
|
|
894
|
+
"title": "媒介策略效果"
|
|
895
|
+
},
|
|
896
|
+
"mediaStrategyLearning": {
|
|
897
|
+
"type": "string",
|
|
898
|
+
"description": "媒介策略 learning",
|
|
899
|
+
"title": "媒介策略learning"
|
|
900
|
+
},
|
|
901
|
+
"audienceStrategyEffect": {
|
|
902
|
+
"type": "integer",
|
|
903
|
+
"format": "int32",
|
|
904
|
+
"description": "受众策略效果:1有效 2无效 3待观察",
|
|
905
|
+
"title": "受众策略效果"
|
|
906
|
+
},
|
|
907
|
+
"audienceStrategyLearning": {
|
|
908
|
+
"type": "string",
|
|
909
|
+
"description": "受众策略 learning",
|
|
910
|
+
"title": "受众策略learning"
|
|
911
|
+
},
|
|
912
|
+
"creativeStrategyEffect": {
|
|
913
|
+
"type": "integer",
|
|
914
|
+
"format": "int32",
|
|
915
|
+
"description": "素材策略效果:1有效 2无效 3待观察",
|
|
916
|
+
"title": "素材策略效果"
|
|
917
|
+
},
|
|
918
|
+
"creativeStrategyLearning": {
|
|
919
|
+
"type": "string",
|
|
920
|
+
"description": "素材策略 learning",
|
|
921
|
+
"title": "素材策略learning"
|
|
922
|
+
}
|
|
923
|
+
},
|
|
924
|
+
"required": [
|
|
925
|
+
"bizLineId",
|
|
926
|
+
"periodStart",
|
|
927
|
+
"periodEnd",
|
|
928
|
+
"budgetStrategyTags",
|
|
929
|
+
"budgetStrategySupplement",
|
|
930
|
+
"mediaStrategyTags",
|
|
931
|
+
"mediaStrategySupplement",
|
|
932
|
+
"audienceStrategyTags",
|
|
933
|
+
"audienceStrategySupplement",
|
|
934
|
+
"creativeStrategy"
|
|
935
|
+
]
|
|
936
|
+
}
|
|
937
|
+
},
|
|
938
|
+
{
|
|
939
|
+
"name": "biz-line-strategy-update",
|
|
940
|
+
"displayName": "更新投放策略",
|
|
941
|
+
"description": "更新投放策略",
|
|
942
|
+
"group": "业务线策略",
|
|
943
|
+
"method": "POST",
|
|
944
|
+
"path": "/sino-opti-hive/biz-line/strategy/update",
|
|
945
|
+
"timeout": 20000,
|
|
946
|
+
"tag": "业务线策略",
|
|
947
|
+
"domain": "biz-line",
|
|
948
|
+
"shortcut": "+strategy-update",
|
|
949
|
+
"risk": "write",
|
|
950
|
+
"summary": "更新投放策略",
|
|
951
|
+
"docFile": "biz-line-strategy.md",
|
|
952
|
+
"requestSchema": {
|
|
953
|
+
"type": "object",
|
|
954
|
+
"properties": {
|
|
955
|
+
"id": {
|
|
956
|
+
"type": "integer",
|
|
957
|
+
"format": "int64",
|
|
958
|
+
"description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id,或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
|
|
959
|
+
"title": "投放策略ID",
|
|
960
|
+
"example": 1
|
|
961
|
+
},
|
|
962
|
+
"version": {
|
|
963
|
+
"type": "integer",
|
|
964
|
+
"format": "int32",
|
|
965
|
+
"description": "乐观锁版本号",
|
|
966
|
+
"title": "乐观锁版本号",
|
|
967
|
+
"example": 1
|
|
968
|
+
},
|
|
969
|
+
"overwrite": {
|
|
970
|
+
"type": "boolean",
|
|
971
|
+
"description": "默认 false:版本冲突则报错;true 强制覆盖",
|
|
972
|
+
"title": "强制覆盖",
|
|
973
|
+
"example": false
|
|
974
|
+
},
|
|
975
|
+
"bizLineId": {
|
|
976
|
+
"type": "integer",
|
|
977
|
+
"format": "int64",
|
|
978
|
+
"description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
|
|
979
|
+
"title": "业务线ID",
|
|
980
|
+
"example": 1251
|
|
981
|
+
},
|
|
982
|
+
"periodStart": {
|
|
983
|
+
"type": "string",
|
|
984
|
+
"format": "date",
|
|
985
|
+
"description": "策略周期起(日期)",
|
|
986
|
+
"title": "策略周期起",
|
|
987
|
+
"example": "2026-09-01"
|
|
988
|
+
},
|
|
989
|
+
"periodEnd": {
|
|
990
|
+
"type": "string",
|
|
991
|
+
"format": "date",
|
|
992
|
+
"description": "策略周期止(日期)",
|
|
993
|
+
"title": "策略周期止",
|
|
994
|
+
"example": "2026-09-01"
|
|
995
|
+
},
|
|
996
|
+
"budgetStrategyTags": {
|
|
997
|
+
"type": "array",
|
|
998
|
+
"items": {
|
|
999
|
+
"type": "integer",
|
|
1000
|
+
"format": "int64"
|
|
1001
|
+
},
|
|
1002
|
+
"description": "预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
|
|
1003
|
+
"title": "预算策略标签ID"
|
|
1004
|
+
},
|
|
1005
|
+
"budgetStrategySupplement": {
|
|
1006
|
+
"type": "string",
|
|
1007
|
+
"description": "预算策略补充说明",
|
|
1008
|
+
"title": "预算策略补充说明"
|
|
1009
|
+
},
|
|
1010
|
+
"mediaStrategyTags": {
|
|
1011
|
+
"type": "array",
|
|
1012
|
+
"items": {
|
|
1013
|
+
"type": "integer",
|
|
1014
|
+
"format": "int64"
|
|
1015
|
+
},
|
|
1016
|
+
"description": "媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
|
|
1017
|
+
"title": "媒介策略标签ID"
|
|
1018
|
+
},
|
|
1019
|
+
"mediaStrategySupplement": {
|
|
1020
|
+
"type": "string",
|
|
1021
|
+
"description": "媒介策略补充说明",
|
|
1022
|
+
"title": "媒介策略补充说明"
|
|
1023
|
+
},
|
|
1024
|
+
"audienceStrategyTags": {
|
|
1025
|
+
"type": "array",
|
|
1026
|
+
"items": {
|
|
1027
|
+
"type": "integer",
|
|
1028
|
+
"format": "int64"
|
|
1029
|
+
},
|
|
1030
|
+
"description": "受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
|
|
1031
|
+
"title": "受众策略标签ID"
|
|
1032
|
+
},
|
|
1033
|
+
"audienceStrategySupplement": {
|
|
1034
|
+
"type": "string",
|
|
1035
|
+
"description": "受众策略补充说明",
|
|
1036
|
+
"title": "受众策略补充说明"
|
|
1037
|
+
},
|
|
1038
|
+
"creativeStrategy": {
|
|
1039
|
+
"type": "string",
|
|
1040
|
+
"description": "素材创意策略说明,最大 5000 字",
|
|
1041
|
+
"title": "素材创意策略说明"
|
|
1042
|
+
},
|
|
1043
|
+
"previewPeriodStart": {
|
|
1044
|
+
"type": "string",
|
|
1045
|
+
"format": "date",
|
|
1046
|
+
"description": "上期(preview)策略周期起;缺省为本期 periodStart 的上一自然周周一",
|
|
1047
|
+
"title": "上期策略周期起",
|
|
1048
|
+
"example": "2026-09-01"
|
|
1049
|
+
},
|
|
1050
|
+
"previewPeriodEnd": {
|
|
1051
|
+
"type": "string",
|
|
1052
|
+
"format": "date",
|
|
1053
|
+
"description": "上期(preview)策略周期止;缺省为 previewPeriodStart+6(周日)",
|
|
1054
|
+
"title": "上期策略周期止",
|
|
1055
|
+
"example": "2026-09-01"
|
|
1056
|
+
},
|
|
1057
|
+
"previewBudgetStrategyTags": {
|
|
1058
|
+
"type": "array",
|
|
1059
|
+
"items": {
|
|
1060
|
+
"type": "integer",
|
|
1061
|
+
"format": "int64"
|
|
1062
|
+
},
|
|
1063
|
+
"description": "上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
|
|
1064
|
+
"title": "上期预算策略标签ID"
|
|
1065
|
+
},
|
|
1066
|
+
"previewBudgetStrategySupplement": {
|
|
1067
|
+
"type": "string",
|
|
1068
|
+
"description": "上期预算策略补充说明",
|
|
1069
|
+
"title": "上期预算策略补充说明"
|
|
1070
|
+
},
|
|
1071
|
+
"previewMediaStrategyTags": {
|
|
1072
|
+
"type": "array",
|
|
1073
|
+
"items": {
|
|
1074
|
+
"type": "integer",
|
|
1075
|
+
"format": "int64"
|
|
1076
|
+
},
|
|
1077
|
+
"description": "上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
|
|
1078
|
+
"title": "上期媒介策略标签ID"
|
|
1079
|
+
},
|
|
1080
|
+
"previewMediaStrategySupplement": {
|
|
1081
|
+
"type": "string",
|
|
1082
|
+
"description": "上期媒介策略补充说明",
|
|
1083
|
+
"title": "上期媒介策略补充说明"
|
|
1084
|
+
},
|
|
1085
|
+
"previewAudienceStrategyTags": {
|
|
1086
|
+
"type": "array",
|
|
1087
|
+
"items": {
|
|
1088
|
+
"type": "integer",
|
|
1089
|
+
"format": "int64"
|
|
1090
|
+
},
|
|
1091
|
+
"description": "上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
|
|
1092
|
+
"title": "上期受众策略标签ID"
|
|
1093
|
+
},
|
|
1094
|
+
"previewAudienceStrategySupplement": {
|
|
1095
|
+
"type": "string",
|
|
1096
|
+
"description": "上期受众策略补充说明",
|
|
1097
|
+
"title": "上期受众策略补充说明"
|
|
1098
|
+
},
|
|
1099
|
+
"previewCreativeStrategy": {
|
|
1100
|
+
"type": "string",
|
|
1101
|
+
"description": "上期素材创意策略说明,最大 5000 字",
|
|
1102
|
+
"title": "上期素材创意策略说明"
|
|
1103
|
+
},
|
|
1104
|
+
"trafficLight": {
|
|
268
1105
|
"type": "integer",
|
|
269
1106
|
"format": "int32",
|
|
270
|
-
"description": "
|
|
271
|
-
"title": "
|
|
272
|
-
"example": 1
|
|
1107
|
+
"description": "红绿灯:1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利",
|
|
1108
|
+
"title": "红绿灯"
|
|
273
1109
|
},
|
|
274
|
-
"
|
|
1110
|
+
"coreIssueCategories": {
|
|
1111
|
+
"type": "array",
|
|
1112
|
+
"items": {
|
|
1113
|
+
"type": "integer",
|
|
1114
|
+
"format": "int32"
|
|
1115
|
+
},
|
|
1116
|
+
"description": "1=受众策略问题,2=跨媒介策略问题,3=媒介广告产品使用策略问题,4=出价策略问题,5=素材策略问题,6=素材执行问题,7=素材管理问题,8=投放规划问题,9=媒体素材政策/尺度/风控问题,10=媒体适配/潜力问题,11=市场选择/竞争问题,12=客户对接不顺畅,13=客户侧:数据对接问题,14=客户侧:产品问题/投放生命周期问题,15=客户侧:运营/基建问题,16=客户侧:存在投放限制,17=客户侧:转自投,18=客户侧:需求临时无规划,19=客户侧:KPI不合理,20=投放生命周期问题/素材疲劳问题,21=内部团队人员调配问题,22=其他",
|
|
1117
|
+
"title": "核心问题分类"
|
|
1118
|
+
},
|
|
1119
|
+
"issuesAndOpportunities": {
|
|
1120
|
+
"type": "string",
|
|
1121
|
+
"description": "项目问题&机会,最大 5000 字",
|
|
1122
|
+
"title": "项目问题&机会"
|
|
1123
|
+
},
|
|
1124
|
+
"spend": {
|
|
1125
|
+
"type": "string",
|
|
1126
|
+
"description": "周期消耗(回顾,展示用字符串),最大 50 字",
|
|
1127
|
+
"title": "周期消耗"
|
|
1128
|
+
},
|
|
1129
|
+
"customerSatisfaction": {
|
|
275
1130
|
"type": "integer",
|
|
276
1131
|
"format": "int32",
|
|
277
|
-
"description": "
|
|
278
|
-
"title": "
|
|
279
|
-
"example": 20
|
|
1132
|
+
"description": "客户满意度:1满意 2不满意",
|
|
1133
|
+
"title": "客户满意度"
|
|
280
1134
|
},
|
|
281
|
-
"
|
|
1135
|
+
"satisfactionReason": {
|
|
282
1136
|
"type": "string",
|
|
283
|
-
"description": "
|
|
284
|
-
"title": "
|
|
285
|
-
"example": "DESC"
|
|
1137
|
+
"description": "满意度原因说明,最大 5000 字",
|
|
1138
|
+
"title": "满意度原因说明"
|
|
286
1139
|
},
|
|
287
|
-
"
|
|
1140
|
+
"coreEffectIndex": {
|
|
1141
|
+
"type": "string",
|
|
1142
|
+
"description": "核心效果指标,最大 5000 字",
|
|
1143
|
+
"title": "核心效果指标"
|
|
1144
|
+
},
|
|
1145
|
+
"budgetStrategyEffect": {
|
|
288
1146
|
"type": "integer",
|
|
289
|
-
"format": "
|
|
290
|
-
"description": "
|
|
291
|
-
"title": "
|
|
292
|
-
"example": 1251
|
|
1147
|
+
"format": "int32",
|
|
1148
|
+
"description": "预算策略效果:1有效 2无效 3待观察",
|
|
1149
|
+
"title": "预算策略效果"
|
|
293
1150
|
},
|
|
294
|
-
"
|
|
1151
|
+
"budgetStrategyLearning": {
|
|
1152
|
+
"type": "string",
|
|
1153
|
+
"description": "预算策略 learning",
|
|
1154
|
+
"title": "预算策略learning"
|
|
1155
|
+
},
|
|
1156
|
+
"mediaStrategyEffect": {
|
|
295
1157
|
"type": "integer",
|
|
296
1158
|
"format": "int32",
|
|
297
|
-
"description": "
|
|
298
|
-
"title": "
|
|
1159
|
+
"description": "媒介策略效果:1有效 2无效 3待观察",
|
|
1160
|
+
"title": "媒介策略效果"
|
|
1161
|
+
},
|
|
1162
|
+
"mediaStrategyLearning": {
|
|
1163
|
+
"type": "string",
|
|
1164
|
+
"description": "媒介策略 learning",
|
|
1165
|
+
"title": "媒介策略learning"
|
|
1166
|
+
},
|
|
1167
|
+
"audienceStrategyEffect": {
|
|
1168
|
+
"type": "integer",
|
|
1169
|
+
"format": "int32",
|
|
1170
|
+
"description": "受众策略效果:1有效 2无效 3待观察",
|
|
1171
|
+
"title": "受众策略效果"
|
|
1172
|
+
},
|
|
1173
|
+
"audienceStrategyLearning": {
|
|
1174
|
+
"type": "string",
|
|
1175
|
+
"description": "受众策略 learning",
|
|
1176
|
+
"title": "受众策略learning"
|
|
1177
|
+
},
|
|
1178
|
+
"creativeStrategyEffect": {
|
|
1179
|
+
"type": "integer",
|
|
1180
|
+
"format": "int32",
|
|
1181
|
+
"description": "素材策略效果:1有效 2无效 3待观察",
|
|
1182
|
+
"title": "素材策略效果"
|
|
1183
|
+
},
|
|
1184
|
+
"creativeStrategyLearning": {
|
|
1185
|
+
"type": "string",
|
|
1186
|
+
"description": "素材策略 learning",
|
|
1187
|
+
"title": "素材策略learning"
|
|
299
1188
|
}
|
|
300
1189
|
},
|
|
301
1190
|
"required": [
|
|
302
|
-
"
|
|
1191
|
+
"id",
|
|
1192
|
+
"version",
|
|
1193
|
+
"bizLineId",
|
|
1194
|
+
"periodStart",
|
|
1195
|
+
"periodEnd",
|
|
1196
|
+
"budgetStrategyTags",
|
|
1197
|
+
"budgetStrategySupplement",
|
|
1198
|
+
"mediaStrategyTags",
|
|
1199
|
+
"mediaStrategySupplement",
|
|
1200
|
+
"audienceStrategyTags",
|
|
1201
|
+
"audienceStrategySupplement",
|
|
1202
|
+
"creativeStrategy"
|
|
303
1203
|
]
|
|
304
1204
|
}
|
|
305
1205
|
},
|
|
306
1206
|
{
|
|
307
|
-
"name": "
|
|
308
|
-
"displayName": "
|
|
309
|
-
"description": "
|
|
310
|
-
"group": "业务线策略",
|
|
311
|
-
"method": "POST",
|
|
312
|
-
"path": "/sino-opti-hive/biz-line/strategy/spend",
|
|
313
|
-
"timeout": 20000,
|
|
314
|
-
"tag": "业务线策略",
|
|
315
|
-
"domain": "biz-line",
|
|
316
|
-
"shortcut": "+spend",
|
|
317
|
-
"risk": "read",
|
|
318
|
-
"summary": "策略周期内关联项目周表消耗汇总",
|
|
319
|
-
"docFile": "biz-line-strategy.md",
|
|
320
|
-
"requestSchema": {
|
|
321
|
-
"$ref": "#/components/schemas/BizLineStrategySpendReqVO"
|
|
322
|
-
}
|
|
323
|
-
},
|
|
324
|
-
{
|
|
325
|
-
"name": "sino-opti-hive-biz-line-strategy-save",
|
|
326
|
-
"displayName": "新建策略",
|
|
327
|
-
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否保存成功。",
|
|
328
|
-
"group": "业务线策略",
|
|
329
|
-
"method": "POST",
|
|
330
|
-
"path": "/sino-opti-hive/biz-line/strategy/save",
|
|
331
|
-
"timeout": 20000,
|
|
332
|
-
"tag": "业务线策略",
|
|
333
|
-
"domain": "biz-line",
|
|
334
|
-
"shortcut": "+strategy-save",
|
|
335
|
-
"risk": "write",
|
|
336
|
-
"summary": "新建策略",
|
|
337
|
-
"docFile": "biz-line-strategy.md",
|
|
338
|
-
"requestSchema": {
|
|
339
|
-
"$ref": "#/components/schemas/BizLineStrategySaveReqVO"
|
|
340
|
-
}
|
|
341
|
-
},
|
|
342
|
-
{
|
|
343
|
-
"name": "sino-opti-hive-biz-line-strategy-update",
|
|
344
|
-
"displayName": "编辑策略",
|
|
345
|
-
"description": "⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁;overwrite=true 强制覆盖。",
|
|
346
|
-
"group": "业务线策略",
|
|
347
|
-
"method": "POST",
|
|
348
|
-
"path": "/sino-opti-hive/biz-line/strategy/update",
|
|
349
|
-
"timeout": 20000,
|
|
350
|
-
"tag": "业务线策略",
|
|
351
|
-
"domain": "biz-line",
|
|
352
|
-
"shortcut": "+strategy-update",
|
|
353
|
-
"risk": "write",
|
|
354
|
-
"summary": "编辑策略",
|
|
355
|
-
"docFile": "biz-line-strategy.md",
|
|
356
|
-
"requestSchema": {
|
|
357
|
-
"$ref": "#/components/schemas/BizLineStrategyUpdateReqVO"
|
|
358
|
-
}
|
|
359
|
-
},
|
|
360
|
-
{
|
|
361
|
-
"name": "sino-opti-hive-biz-line-strategy-del",
|
|
362
|
-
"displayName": "删除策略",
|
|
363
|
-
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否删除成功。",
|
|
1207
|
+
"name": "biz-line-strategy-del",
|
|
1208
|
+
"displayName": "删除投放策略",
|
|
1209
|
+
"description": "删除投放策略",
|
|
364
1210
|
"group": "业务线策略",
|
|
365
1211
|
"method": "POST",
|
|
366
1212
|
"path": "/sino-opti-hive/biz-line/strategy/del",
|
|
@@ -369,16 +1215,28 @@
|
|
|
369
1215
|
"domain": "biz-line",
|
|
370
1216
|
"shortcut": "+strategy-delete",
|
|
371
1217
|
"risk": "high-risk-write",
|
|
372
|
-
"summary": "
|
|
1218
|
+
"summary": "删除投放策略",
|
|
373
1219
|
"docFile": "biz-line-strategy.md",
|
|
374
1220
|
"requestSchema": {
|
|
375
|
-
"
|
|
1221
|
+
"type": "object",
|
|
1222
|
+
"properties": {
|
|
1223
|
+
"id": {
|
|
1224
|
+
"type": "integer",
|
|
1225
|
+
"format": "int64",
|
|
1226
|
+
"description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id,或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
|
|
1227
|
+
"title": "投放策略ID",
|
|
1228
|
+
"example": 1
|
|
1229
|
+
}
|
|
1230
|
+
},
|
|
1231
|
+
"required": [
|
|
1232
|
+
"id"
|
|
1233
|
+
]
|
|
376
1234
|
}
|
|
377
1235
|
},
|
|
378
1236
|
{
|
|
379
|
-
"name": "
|
|
1237
|
+
"name": "biz-line-open-channels",
|
|
380
1238
|
"displayName": "查询投放渠道列表",
|
|
381
|
-
"description": "
|
|
1239
|
+
"description": "查询投放渠道列表",
|
|
382
1240
|
"group": "业务线查询",
|
|
383
1241
|
"method": "GET",
|
|
384
1242
|
"path": "/sino-opti-hive/biz-line-open/channels",
|
|
@@ -391,9 +1249,9 @@
|
|
|
391
1249
|
"docFile": "biz-line-query.md"
|
|
392
1250
|
},
|
|
393
1251
|
{
|
|
394
|
-
"name": "
|
|
395
|
-
"displayName": "
|
|
396
|
-
"description": "
|
|
1252
|
+
"name": "biz-line-open-placement-categories",
|
|
1253
|
+
"displayName": "查询投放品类字典",
|
|
1254
|
+
"description": "查询投放品类字典,sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业,二级节点(children)= 投放品类,分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
|
|
397
1255
|
"group": "业务线查询",
|
|
398
1256
|
"method": "GET",
|
|
399
1257
|
"path": "/sino-opti-hive/biz-line-open/placement-categories",
|
|
@@ -402,13 +1260,13 @@
|
|
|
402
1260
|
"domain": "biz-line",
|
|
403
1261
|
"shortcut": "+categories",
|
|
404
1262
|
"risk": "read",
|
|
405
|
-
"summary": "
|
|
1263
|
+
"summary": "查询投放品类字典",
|
|
406
1264
|
"docFile": "biz-line-query.md"
|
|
407
1265
|
},
|
|
408
1266
|
{
|
|
409
|
-
"name": "
|
|
1267
|
+
"name": "sso-team-group-list",
|
|
410
1268
|
"displayName": "查询组别列表",
|
|
411
|
-
"description": "
|
|
1269
|
+
"description": "查询组别列表",
|
|
412
1270
|
"group": "业务线策略",
|
|
413
1271
|
"method": "GET",
|
|
414
1272
|
"path": "/sino-opti-hive/sso-team/group-list",
|
|
@@ -421,9 +1279,9 @@
|
|
|
421
1279
|
"docFile": "sso.md"
|
|
422
1280
|
},
|
|
423
1281
|
{
|
|
424
|
-
"name": "
|
|
425
|
-
"displayName": "
|
|
426
|
-
"description": "
|
|
1282
|
+
"name": "biz-line-project-list",
|
|
1283
|
+
"displayName": "查询业务线关联项目和广告账号",
|
|
1284
|
+
"description": "根据业务线 ID 查询业务线关联项目和广告账号\n",
|
|
427
1285
|
"group": "业务线策略",
|
|
428
1286
|
"method": "POST",
|
|
429
1287
|
"path": "/sino-opti-hive/biz-line/project-list",
|
|
@@ -432,16 +1290,28 @@
|
|
|
432
1290
|
"domain": "biz-line",
|
|
433
1291
|
"shortcut": "+project-list",
|
|
434
1292
|
"risk": "read",
|
|
435
|
-
"summary": "
|
|
1293
|
+
"summary": "查询业务线关联项目和广告账号",
|
|
436
1294
|
"docFile": "biz-line-strategy.md",
|
|
437
1295
|
"requestSchema": {
|
|
438
|
-
"
|
|
1296
|
+
"type": "object",
|
|
1297
|
+
"properties": {
|
|
1298
|
+
"bizLineId": {
|
|
1299
|
+
"type": "integer",
|
|
1300
|
+
"format": "int64",
|
|
1301
|
+
"description": "业务线 ID,必填",
|
|
1302
|
+
"title": "业务线ID",
|
|
1303
|
+
"example": 1251
|
|
1304
|
+
}
|
|
1305
|
+
},
|
|
1306
|
+
"required": [
|
|
1307
|
+
"bizLineId"
|
|
1308
|
+
]
|
|
439
1309
|
}
|
|
440
1310
|
},
|
|
441
1311
|
{
|
|
442
|
-
"name": "
|
|
443
|
-
"displayName": "
|
|
444
|
-
"description": "
|
|
1312
|
+
"name": "optimize-project-query-by-page",
|
|
1313
|
+
"displayName": "查询项目分页列表",
|
|
1314
|
+
"description": "查询项目分页列表",
|
|
445
1315
|
"group": "业务线策略",
|
|
446
1316
|
"method": "POST",
|
|
447
1317
|
"path": "/sino-opti-hive/optimize/project/queryByPage",
|
|
@@ -450,23 +1320,191 @@
|
|
|
450
1320
|
"domain": "biz-line",
|
|
451
1321
|
"shortcut": "+queryByPage",
|
|
452
1322
|
"risk": "read",
|
|
453
|
-
"summary": "
|
|
1323
|
+
"summary": "查询项目分页列表",
|
|
454
1324
|
"docFile": "biz-line-strategy.md",
|
|
455
1325
|
"requestSchema": {
|
|
456
|
-
"
|
|
1326
|
+
"type": "object",
|
|
1327
|
+
"properties": {
|
|
1328
|
+
"pageNum": {
|
|
1329
|
+
"type": "integer",
|
|
1330
|
+
"title": "页码",
|
|
1331
|
+
"description": "页码,从 1 开始",
|
|
1332
|
+
"format": "int32",
|
|
1333
|
+
"example": 1
|
|
1334
|
+
},
|
|
1335
|
+
"pageSize": {
|
|
1336
|
+
"type": "integer",
|
|
1337
|
+
"title": "每页条数",
|
|
1338
|
+
"description": "每页条数",
|
|
1339
|
+
"format": "int32",
|
|
1340
|
+
"example": 20
|
|
1341
|
+
},
|
|
1342
|
+
"sortType": {
|
|
1343
|
+
"type": "string",
|
|
1344
|
+
"title": "排序字段",
|
|
1345
|
+
"description": "lastWeekSpend=上周消耗;lastWeekSpendQoq=上周消耗环比;createTime=创建时间。不传默认 createTime",
|
|
1346
|
+
"enum": [
|
|
1347
|
+
"lastWeekSpend",
|
|
1348
|
+
"lastWeekSpendQoq",
|
|
1349
|
+
"createTime"
|
|
1350
|
+
],
|
|
1351
|
+
"example": "createTime"
|
|
1352
|
+
},
|
|
1353
|
+
"sortDirection": {
|
|
1354
|
+
"type": "string",
|
|
1355
|
+
"title": "排序方向",
|
|
1356
|
+
"description": "ASC 升序,DESC 降序;默认 DESC",
|
|
1357
|
+
"enum": [
|
|
1358
|
+
"ASC",
|
|
1359
|
+
"DESC"
|
|
1360
|
+
],
|
|
1361
|
+
"example": "DESC"
|
|
1362
|
+
},
|
|
1363
|
+
"corporationId": {
|
|
1364
|
+
"type": "integer",
|
|
1365
|
+
"title": "签约主体ID",
|
|
1366
|
+
"description": "签约主体 ID",
|
|
1367
|
+
"format": "int32"
|
|
1368
|
+
},
|
|
1369
|
+
"corporationIdList": {
|
|
1370
|
+
"type": "array",
|
|
1371
|
+
"title": "签约主体ID列表",
|
|
1372
|
+
"description": "签约主体 ID 多选",
|
|
1373
|
+
"items": {
|
|
1374
|
+
"type": "integer",
|
|
1375
|
+
"format": "int32"
|
|
1376
|
+
}
|
|
1377
|
+
},
|
|
1378
|
+
"projectId": {
|
|
1379
|
+
"type": "integer",
|
|
1380
|
+
"title": "项目ID",
|
|
1381
|
+
"description": "项目 ID,精确匹配",
|
|
1382
|
+
"format": "int64"
|
|
1383
|
+
},
|
|
1384
|
+
"projectIdList": {
|
|
1385
|
+
"type": "array",
|
|
1386
|
+
"title": "项目ID列表",
|
|
1387
|
+
"description": "项目 ID 多选。已知 ID 时直接传入;本接口出参 projectId 也可回填",
|
|
1388
|
+
"items": {
|
|
1389
|
+
"type": "integer",
|
|
1390
|
+
"format": "int64"
|
|
1391
|
+
}
|
|
1392
|
+
},
|
|
1393
|
+
"projectName": {
|
|
1394
|
+
"type": "string",
|
|
1395
|
+
"title": "项目名称",
|
|
1396
|
+
"description": "项目名称,模糊查询"
|
|
1397
|
+
},
|
|
1398
|
+
"projectKeyword": {
|
|
1399
|
+
"type": "string",
|
|
1400
|
+
"title": "项目ID或名称",
|
|
1401
|
+
"description": "项目 ID 精确,或项目名称分词模糊(空格分词,词之间 AND)"
|
|
1402
|
+
},
|
|
1403
|
+
"startDate": {
|
|
1404
|
+
"type": "string",
|
|
1405
|
+
"title": "项目周期起",
|
|
1406
|
+
"description": "项目周期开始日期 yyyy-MM-dd",
|
|
1407
|
+
"format": "date"
|
|
1408
|
+
},
|
|
1409
|
+
"endDate": {
|
|
1410
|
+
"type": "string",
|
|
1411
|
+
"title": "项目周期止",
|
|
1412
|
+
"description": "项目周期结束日期 yyyy-MM-dd",
|
|
1413
|
+
"format": "date"
|
|
1414
|
+
},
|
|
1415
|
+
"projectUserIdList": {
|
|
1416
|
+
"type": "array",
|
|
1417
|
+
"title": "项目成员ID",
|
|
1418
|
+
"description": "项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId,也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
|
|
1419
|
+
"items": {
|
|
1420
|
+
"type": "integer",
|
|
1421
|
+
"format": "int32"
|
|
1422
|
+
}
|
|
1423
|
+
},
|
|
1424
|
+
"ssoTeamCodeList": {
|
|
1425
|
+
"type": "array",
|
|
1426
|
+
"title": "组别code",
|
|
1427
|
+
"description": "组别 code 多选,按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
|
|
1428
|
+
"items": {
|
|
1429
|
+
"type": "string"
|
|
1430
|
+
}
|
|
1431
|
+
},
|
|
1432
|
+
"adAccountId": {
|
|
1433
|
+
"type": "string",
|
|
1434
|
+
"title": "广告账号",
|
|
1435
|
+
"description": "广告账号 ID 模糊查询,至少 2 个字符"
|
|
1436
|
+
},
|
|
1437
|
+
"demandOrderKeyword": {
|
|
1438
|
+
"type": "string",
|
|
1439
|
+
"title": "需求单编号或名称",
|
|
1440
|
+
"description": "需求单编号精确,或需求单名称分词模糊(空格分词)"
|
|
1441
|
+
},
|
|
1442
|
+
"signalLightList": {
|
|
1443
|
+
"type": "array",
|
|
1444
|
+
"title": "红绿灯",
|
|
1445
|
+
"description": "项目红绿灯多选,与出参 signalLight 同值(字符串,不是业务线策略 trafficLight 的整数枚举)",
|
|
1446
|
+
"items": {
|
|
1447
|
+
"type": "string"
|
|
1448
|
+
}
|
|
1449
|
+
},
|
|
1450
|
+
"projectStatusList": {
|
|
1451
|
+
"type": "array",
|
|
1452
|
+
"title": "项目状态",
|
|
1453
|
+
"description": "项目执行状态多选。本接口查的是项目(非需求):4=待分配,5=执行中,6=已暂停,7=已完成,8=终止。出参 projectStatusName 为对应中文名",
|
|
1454
|
+
"items": {
|
|
1455
|
+
"type": "integer",
|
|
1456
|
+
"format": "int32"
|
|
1457
|
+
}
|
|
1458
|
+
},
|
|
1459
|
+
"isLast7DSpend": {
|
|
1460
|
+
"type": "array",
|
|
1461
|
+
"title": "近7天是否有消耗",
|
|
1462
|
+
"description": "0=否,1=是。仅传一个值时生效;同时传 0 和 1 等于不筛",
|
|
1463
|
+
"items": {
|
|
1464
|
+
"type": "integer",
|
|
1465
|
+
"format": "int32"
|
|
1466
|
+
}
|
|
1467
|
+
},
|
|
1468
|
+
"uploadInfoTypeList": {
|
|
1469
|
+
"type": "array",
|
|
1470
|
+
"title": "已上传项目信息类型",
|
|
1471
|
+
"description": "0=无上传,1=仅上传brief,2=仅上传mediaPlan,3=上传brief和mediaPlan。多选",
|
|
1472
|
+
"items": {
|
|
1473
|
+
"type": "integer",
|
|
1474
|
+
"format": "int32"
|
|
1475
|
+
}
|
|
1476
|
+
},
|
|
1477
|
+
"serviceCodeList": {
|
|
1478
|
+
"type": "array",
|
|
1479
|
+
"title": "产品code",
|
|
1480
|
+
"description": "服务/产品 code 多选。不传时服务端默认 1、85(代投类项目)",
|
|
1481
|
+
"items": {
|
|
1482
|
+
"type": "string"
|
|
1483
|
+
}
|
|
1484
|
+
},
|
|
1485
|
+
"bizLineIdList": {
|
|
1486
|
+
"type": "array",
|
|
1487
|
+
"title": "业务线ID",
|
|
1488
|
+
"description": "按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 result.id",
|
|
1489
|
+
"items": {
|
|
1490
|
+
"type": "integer",
|
|
1491
|
+
"format": "int64"
|
|
1492
|
+
}
|
|
1493
|
+
}
|
|
1494
|
+
}
|
|
457
1495
|
}
|
|
458
1496
|
},
|
|
459
1497
|
{
|
|
460
|
-
"name": "
|
|
1498
|
+
"name": "icenter-strategy-dimension-facebook",
|
|
461
1499
|
"displayName": "Facebook广告策略维度数据",
|
|
462
|
-
"description": "查询 Facebook(Meta)渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「Facebook广告策略成效数据」接口。\n\n
|
|
1500
|
+
"description": "查询 Facebook(Meta)渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「Facebook广告策略成效数据」接口。\n\n【国家维度特别说明】\ncountry_code(国家)必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【入参填写规则】\n1. startDate / endDate:字符串,格式 yyyy-MM-dd,两者都必填。\n2. dimensionValues:过滤条件,结构是「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>)。每个 key 是字段 code,对应的 value 必须是数组,即使只筛一个值也要用数组包裹;同一个 key 内的多个值之间是「或」关系,命中任意一个即返回。本接口只有 account_id 这一个 key 生效,传入其他 key 不会报错,但也不会产生任何过滤效果。\n3. dimensions:分组维度数组,必填。传多个维度时按多个字段组合分组,效果等同 SQL 的 GROUP BY 多列,维度越多返回行数越多、粒度越细。\n4. 排序:单字段排序用 order(字段名)+ orderType(desc / asc);多字段排序用 orders,结构是「字段名 → 排序方向」的有序键值对,按书写顺序依次排序,例如 {\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。两者可同时使用,order 指定的字段会追加到 orders 之后。\n5. 分页:page 从 1 开始(默认 1),size 为每页条数(默认 10)。返回的 result.total 是总条数,据此判断是否还有下一页。\n\n【请求示例】\n{\n \"startDate\": \"2026-08-01\",\n \"endDate\": \"2026-08-31\",\n \"dimensionValues\": {\n \"account_id\": [\n \"act_1036928420879324\"\n ]\n },\n \"dimensions\": [\n \"calendar_date\",\n \"optimization_goal\"\n ],\n \"order\": \"calendar_date\",\n \"orderType\": \"desc\",\n \"page\": 1,\n \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
463
1501
|
"group": "业务线策略",
|
|
464
1502
|
"method": "POST",
|
|
465
1503
|
"path": "/sino-icenter/mcp/strategy/dimension/facebook/ad/list",
|
|
466
1504
|
"timeout": 20000,
|
|
467
1505
|
"tag": "业务线策略",
|
|
468
1506
|
"domain": "biz-line",
|
|
469
|
-
"shortcut": "+
|
|
1507
|
+
"shortcut": "+facebook-dimension",
|
|
470
1508
|
"risk": "read",
|
|
471
1509
|
"summary": "Facebook广告策略维度数据",
|
|
472
1510
|
"docFile": "biz-line-strategy.md",
|
|
@@ -475,27 +1513,31 @@
|
|
|
475
1513
|
"properties": {
|
|
476
1514
|
"startDate": {
|
|
477
1515
|
"type": "string",
|
|
478
|
-
"description": "
|
|
1516
|
+
"description": "统计开始日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-01\"。必填。",
|
|
1517
|
+
"title": "开始日期"
|
|
479
1518
|
},
|
|
480
1519
|
"endDate": {
|
|
481
1520
|
"type": "string",
|
|
482
|
-
"description": "
|
|
1521
|
+
"description": "统计结束日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-31\"。必填,需大于等于 startDate。",
|
|
1522
|
+
"title": "结束日期"
|
|
483
1523
|
},
|
|
484
1524
|
"dimensionValues": {
|
|
485
1525
|
"type": "object",
|
|
486
|
-
"description": "
|
|
1526
|
+
"description": "过滤条件。结构为「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>),value 必须是数组,即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效,传其他 key 不报错但无过滤效果。示例:{\"account_id\": [\"act_123\", \"act_456\"]}",
|
|
487
1527
|
"properties": {
|
|
488
1528
|
"account_id": {
|
|
489
1529
|
"type": "array",
|
|
490
1530
|
"items": {
|
|
491
1531
|
"type": "string"
|
|
492
1532
|
},
|
|
493
|
-
"description": "广告账户ID
|
|
1533
|
+
"description": "广告账户ID列表,字符串数组,必填且不能为空数组。取值形如 \"act_1036928420879324\"(带 act_ 前缀)。多个账户之间是「或」关系,返回这些账户的合并数据。",
|
|
1534
|
+
"title": "广告账户ID"
|
|
494
1535
|
}
|
|
495
1536
|
},
|
|
496
1537
|
"required": [
|
|
497
1538
|
"account_id"
|
|
498
|
-
]
|
|
1539
|
+
],
|
|
1540
|
+
"title": "过滤条件"
|
|
499
1541
|
},
|
|
500
1542
|
"dimensions": {
|
|
501
1543
|
"type": "array",
|
|
@@ -525,11 +1567,13 @@
|
|
|
525
1567
|
"country_code"
|
|
526
1568
|
]
|
|
527
1569
|
},
|
|
528
|
-
"description": "
|
|
1570
|
+
"description": "分组维度,字符串数组,必传且不能为空数组(传空数组返回结果为空)。传多个维度时按多字段组合分组,等同 SQL 的 GROUP BY 多列,维度越多粒度越细、返回行数越多。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、bid_amount(调整出价)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_flexible_interests(弹性兴趣词包)、targeting_exclusion_interests(排除兴趣词包)、targeting_age(年龄)、targeting_genders(性别)、country_code(国家,必须单独传,不能和其他维度同时传)",
|
|
1571
|
+
"title": "分组维度"
|
|
529
1572
|
},
|
|
530
1573
|
"order": {
|
|
531
1574
|
"type": "string",
|
|
532
|
-
"description": "
|
|
1575
|
+
"description": "单字段排序的字段名,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回。与 orders 可同时使用,order 指定的字段会追加到 orders 之后。",
|
|
1576
|
+
"title": "排序字段"
|
|
533
1577
|
},
|
|
534
1578
|
"orderType": {
|
|
535
1579
|
"type": "string",
|
|
@@ -537,15 +1581,24 @@
|
|
|
537
1581
|
"desc",
|
|
538
1582
|
"asc"
|
|
539
1583
|
],
|
|
540
|
-
"description": "
|
|
1584
|
+
"description": "排序方向,配合 order 使用。desc 降序,asc 升序,默认 asc。",
|
|
1585
|
+
"title": "排序方向"
|
|
1586
|
+
},
|
|
1587
|
+
"orders": {
|
|
1588
|
+
"type": "object",
|
|
1589
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
1590
|
+
"properties": {},
|
|
1591
|
+
"title": "多字段排序"
|
|
541
1592
|
},
|
|
542
1593
|
"page": {
|
|
543
1594
|
"type": "integer",
|
|
544
|
-
"description": "页码,从1开始,默认1"
|
|
1595
|
+
"description": "页码,从 1 开始,默认 1。",
|
|
1596
|
+
"title": "页码"
|
|
545
1597
|
},
|
|
546
1598
|
"size": {
|
|
547
1599
|
"type": "integer",
|
|
548
|
-
"description": "每页条数,默认10
|
|
1600
|
+
"description": "每页条数,默认 10,建议显式指定。返回的 result.total 为总条数,据此判断是否还有下一页。",
|
|
1601
|
+
"title": "每页条数"
|
|
549
1602
|
}
|
|
550
1603
|
},
|
|
551
1604
|
"required": [
|
|
@@ -557,7 +1610,7 @@
|
|
|
557
1610
|
}
|
|
558
1611
|
},
|
|
559
1612
|
{
|
|
560
|
-
"name": "
|
|
1613
|
+
"name": "icenter-strategy-dimension-google",
|
|
561
1614
|
"displayName": "Google广告策略维度数据",
|
|
562
1615
|
"description": "查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等),用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度,出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「Google广告策略成效数据」接口。\n\n国家维度特别说明:country_code 必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
563
1616
|
"group": "业务线策略",
|
|
@@ -566,7 +1619,7 @@
|
|
|
566
1619
|
"timeout": 20000,
|
|
567
1620
|
"tag": "业务线策略",
|
|
568
1621
|
"domain": "biz-line",
|
|
569
|
-
"shortcut": "+google-
|
|
1622
|
+
"shortcut": "+google-dimension",
|
|
570
1623
|
"risk": "read",
|
|
571
1624
|
"summary": "Google广告策略维度数据",
|
|
572
1625
|
"docFile": "biz-line-strategy.md",
|
|
@@ -575,11 +1628,13 @@
|
|
|
575
1628
|
"properties": {
|
|
576
1629
|
"startDate": {
|
|
577
1630
|
"type": "string",
|
|
578
|
-
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
1631
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01",
|
|
1632
|
+
"title": "开始日期"
|
|
579
1633
|
},
|
|
580
1634
|
"endDate": {
|
|
581
1635
|
"type": "string",
|
|
582
|
-
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31"
|
|
1636
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31",
|
|
1637
|
+
"title": "结束日期"
|
|
583
1638
|
},
|
|
584
1639
|
"dimensionValues": {
|
|
585
1640
|
"type": "object",
|
|
@@ -590,12 +1645,14 @@
|
|
|
590
1645
|
"items": {
|
|
591
1646
|
"type": "string"
|
|
592
1647
|
},
|
|
593
|
-
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
1648
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个",
|
|
1649
|
+
"title": "广告账户ID"
|
|
594
1650
|
}
|
|
595
1651
|
},
|
|
596
1652
|
"required": [
|
|
597
1653
|
"account_id"
|
|
598
|
-
]
|
|
1654
|
+
],
|
|
1655
|
+
"title": "过滤条件"
|
|
599
1656
|
},
|
|
600
1657
|
"dimensions": {
|
|
601
1658
|
"type": "array",
|
|
@@ -625,11 +1682,13 @@
|
|
|
625
1682
|
"country_code"
|
|
626
1683
|
]
|
|
627
1684
|
},
|
|
628
|
-
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)、country_code(国家,必须单独传,不能和其他维度同时传)"
|
|
1685
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)、country_code(国家,必须单独传,不能和其他维度同时传)",
|
|
1686
|
+
"title": "分组维度"
|
|
629
1687
|
},
|
|
630
1688
|
"order": {
|
|
631
1689
|
"type": "string",
|
|
632
|
-
"description": "排序字段,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
1690
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回",
|
|
1691
|
+
"title": "排序字段"
|
|
633
1692
|
},
|
|
634
1693
|
"orderType": {
|
|
635
1694
|
"type": "string",
|
|
@@ -637,15 +1696,24 @@
|
|
|
637
1696
|
"desc",
|
|
638
1697
|
"asc"
|
|
639
1698
|
],
|
|
640
|
-
"description": "排序方向,默认 asc"
|
|
1699
|
+
"description": "排序方向,默认 asc",
|
|
1700
|
+
"title": "排序方向"
|
|
1701
|
+
},
|
|
1702
|
+
"orders": {
|
|
1703
|
+
"type": "object",
|
|
1704
|
+
"title": "多字段排序",
|
|
1705
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
1706
|
+
"properties": {}
|
|
641
1707
|
},
|
|
642
1708
|
"page": {
|
|
643
1709
|
"type": "integer",
|
|
644
|
-
"description": "页码,从1开始,默认1"
|
|
1710
|
+
"description": "页码,从1开始,默认1",
|
|
1711
|
+
"title": "页码"
|
|
645
1712
|
},
|
|
646
1713
|
"size": {
|
|
647
1714
|
"type": "integer",
|
|
648
|
-
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
1715
|
+
"description": "每页条数,默认10,建议显式传且不超过1000",
|
|
1716
|
+
"title": "每页条数"
|
|
649
1717
|
}
|
|
650
1718
|
},
|
|
651
1719
|
"required": [
|
|
@@ -657,16 +1725,16 @@
|
|
|
657
1725
|
}
|
|
658
1726
|
},
|
|
659
1727
|
{
|
|
660
|
-
"name": "
|
|
1728
|
+
"name": "icenter-strategy-dimension-tiktok",
|
|
661
1729
|
"displayName": "TikTok广告策略维度数据",
|
|
662
|
-
"description": "查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「TikTok广告策略成效数据」接口。\n\n
|
|
1730
|
+
"description": "查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「TikTok广告策略成效数据」接口。\n\n【国家维度特别说明】\ncountry_code(国家)必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【入参填写规则】\n1. startDate / endDate:字符串,格式 yyyy-MM-dd,两者都必填。\n2. dimensionValues:过滤条件,结构是「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>)。每个 key 是字段 code,对应的 value 必须是数组,即使只筛一个值也要用数组包裹;同一个 key 内的多个值之间是「或」关系,命中任意一个即返回。本接口只有 account_id 这一个 key 生效,传入其他 key 不会报错,但也不会产生任何过滤效果。\n3. dimensions:分组维度数组,必填。传多个维度时按多个字段组合分组,效果等同 SQL 的 GROUP BY 多列,维度越多返回行数越多、粒度越细。\n4. 排序:单字段排序用 order(字段名)+ orderType(desc / asc);多字段排序用 orders,结构是「字段名 → 排序方向」的有序键值对,按书写顺序依次排序,例如 {\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。两者可同时使用,order 指定的字段会追加到 orders 之后。\n5. 分页:page 从 1 开始(默认 1),size 为每页条数(默认 10)。返回的 result.total 是总条数,据此判断是否还有下一页。\n\n【请求示例】\n{\n \"startDate\": \"2026-08-01\",\n \"endDate\": \"2026-08-31\",\n \"dimensionValues\": {\n \"account_id\": [\n \"<广告账户ID,格式同 account_id 维度返回值>\"\n ]\n },\n \"dimensions\": [\n \"calendar_date\",\n \"optimization_goal\"\n ],\n \"order\": \"calendar_date\",\n \"orderType\": \"desc\",\n \"page\": 1,\n \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
663
1731
|
"group": "业务线策略",
|
|
664
1732
|
"method": "POST",
|
|
665
1733
|
"path": "/sino-icenter/mcp/strategy/dimension/tiktok/ad/list",
|
|
666
1734
|
"timeout": 20000,
|
|
667
1735
|
"tag": "业务线策略",
|
|
668
1736
|
"domain": "biz-line",
|
|
669
|
-
"shortcut": "+tiktok-
|
|
1737
|
+
"shortcut": "+tiktok-dimension",
|
|
670
1738
|
"risk": "read",
|
|
671
1739
|
"summary": "TikTok广告策略维度数据",
|
|
672
1740
|
"docFile": "biz-line-strategy.md",
|
|
@@ -675,27 +1743,31 @@
|
|
|
675
1743
|
"properties": {
|
|
676
1744
|
"startDate": {
|
|
677
1745
|
"type": "string",
|
|
678
|
-
"description": "
|
|
1746
|
+
"description": "统计开始日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-01\"。必填。",
|
|
1747
|
+
"title": "开始日期"
|
|
679
1748
|
},
|
|
680
1749
|
"endDate": {
|
|
681
1750
|
"type": "string",
|
|
682
|
-
"description": "
|
|
1751
|
+
"description": "统计结束日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-31\"。必填,需大于等于 startDate。",
|
|
1752
|
+
"title": "结束日期"
|
|
683
1753
|
},
|
|
684
1754
|
"dimensionValues": {
|
|
685
1755
|
"type": "object",
|
|
686
|
-
"description": "
|
|
1756
|
+
"description": "过滤条件。结构为「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>),value 必须是数组,即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效,传其他 key 不报错但无过滤效果。示例:{\"account_id\": [\"act_123\", \"act_456\"]}",
|
|
687
1757
|
"properties": {
|
|
688
1758
|
"account_id": {
|
|
689
1759
|
"type": "array",
|
|
690
1760
|
"items": {
|
|
691
1761
|
"type": "string"
|
|
692
1762
|
},
|
|
693
|
-
"description": "广告账户ID
|
|
1763
|
+
"description": "广告账户ID列表,字符串数组,必填且不能为空数组。取值格式需与本接口 account_id 维度返回的值完全一致;若不确定,可先只传 account_id 维度查询一次,确认格式后再用作过滤条件。多个账户之间是「或」关系,返回这些账户的合并数据。",
|
|
1764
|
+
"title": "广告账户ID"
|
|
694
1765
|
}
|
|
695
1766
|
},
|
|
696
1767
|
"required": [
|
|
697
1768
|
"account_id"
|
|
698
|
-
]
|
|
1769
|
+
],
|
|
1770
|
+
"title": "过滤条件"
|
|
699
1771
|
},
|
|
700
1772
|
"dimensions": {
|
|
701
1773
|
"type": "array",
|
|
@@ -725,11 +1797,13 @@
|
|
|
725
1797
|
"country_code"
|
|
726
1798
|
]
|
|
727
1799
|
},
|
|
728
|
-
"description": "
|
|
1800
|
+
"description": "分组维度,字符串数组,必传且不能为空数组(传空数组返回结果为空)。传多个维度时按多字段组合分组,等同 SQL 的 GROUP BY 多列,维度越多粒度越细、返回行数越多。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、bid_amount(调整出价)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_age(年龄)、targeting_genders(性别)、conversion_bid(转化出价)、deep_cpabid(深度转化出价)、country_code(国家,必须单独传,不能和其他维度同时传)",
|
|
1801
|
+
"title": "分组维度"
|
|
729
1802
|
},
|
|
730
1803
|
"order": {
|
|
731
1804
|
"type": "string",
|
|
732
|
-
"description": "
|
|
1805
|
+
"description": "单字段排序的字段名,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回。与 orders 可同时使用,order 指定的字段会追加到 orders 之后。",
|
|
1806
|
+
"title": "排序字段"
|
|
733
1807
|
},
|
|
734
1808
|
"orderType": {
|
|
735
1809
|
"type": "string",
|
|
@@ -737,15 +1811,24 @@
|
|
|
737
1811
|
"desc",
|
|
738
1812
|
"asc"
|
|
739
1813
|
],
|
|
740
|
-
"description": "
|
|
1814
|
+
"description": "排序方向,配合 order 使用。desc 降序,asc 升序,默认 asc。",
|
|
1815
|
+
"title": "排序方向"
|
|
1816
|
+
},
|
|
1817
|
+
"orders": {
|
|
1818
|
+
"type": "object",
|
|
1819
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
1820
|
+
"properties": {},
|
|
1821
|
+
"title": "多字段排序"
|
|
741
1822
|
},
|
|
742
1823
|
"page": {
|
|
743
1824
|
"type": "integer",
|
|
744
|
-
"description": "页码,从1开始,默认1"
|
|
1825
|
+
"description": "页码,从 1 开始,默认 1。",
|
|
1826
|
+
"title": "页码"
|
|
745
1827
|
},
|
|
746
1828
|
"size": {
|
|
747
1829
|
"type": "integer",
|
|
748
|
-
"description": "每页条数,默认10
|
|
1830
|
+
"description": "每页条数,默认 10,建议显式指定。返回的 result.total 为总条数,据此判断是否还有下一页。",
|
|
1831
|
+
"title": "每页条数"
|
|
749
1832
|
}
|
|
750
1833
|
},
|
|
751
1834
|
"required": [
|
|
@@ -757,16 +1840,16 @@
|
|
|
757
1840
|
}
|
|
758
1841
|
},
|
|
759
1842
|
{
|
|
760
|
-
"name": "
|
|
1843
|
+
"name": "icenter-strategy-metrics-facebook",
|
|
761
1844
|
"displayName": "Facebook广告策略成效数据",
|
|
762
|
-
"description": "查询 Facebook(Meta
|
|
1845
|
+
"description": "查询 Facebook(Meta)渠道广告的策略维度加成效指标数据。在广告策略配置(广告目标、成效目标、创意类型、出价方式、受众定向等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。\n\n【入参填写规则】\n1. startDate / endDate:字符串,格式 yyyy-MM-dd,两者都必填。\n2. dimensionValues:过滤条件,结构是「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>)。每个 key 是字段 code,对应的 value 必须是数组,即使只筛一个值也要用数组包裹;同一个 key 内的多个值之间是「或」关系,命中任意一个即返回。本接口只有 account_id 这一个 key 生效,传入其他 key 不会报错,但也不会产生任何过滤效果。\n3. dimensions:分组维度数组,必填。传多个维度时按多个字段组合分组,效果等同 SQL 的 GROUP BY 多列,维度越多返回行数越多、粒度越细。\n4. indicators:成效指标数组,必填。指标会在 dimensions 指定的分组粒度上做求和聚合。\n5. 排序:单字段排序用 order(字段名)+ orderType(desc / asc);多字段排序用 orders,结构是「字段名 → 排序方向」的有序键值对,按书写顺序依次排序,例如 {\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。两者可同时使用,order 指定的字段会追加到 orders 之后。\n6. 分页:page 从 1 开始(默认 1),size 为每页条数(默认 10)。返回的 result.total 是总条数,据此判断是否还有下一页。\n\n【请求示例】\n{\n \"startDate\": \"2026-08-01\",\n \"endDate\": \"2026-08-31\",\n \"dimensionValues\": {\n \"account_id\": [\n \"act_1036928420879324\"\n ]\n },\n \"dimensions\": [\n \"calendar_date\",\n \"optimization_goal\"\n ],\n \"indicators\": [\n \"spend_usd\",\n \"impressions\",\n \"clicks\"\n ],\n \"order\": \"spend_usd\",\n \"orderType\": \"desc\",\n \"page\": 1,\n \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
763
1846
|
"group": "业务线策略",
|
|
764
1847
|
"method": "POST",
|
|
765
1848
|
"path": "/sino-icenter/mcp/strategy/metrics/facebook/ad/list",
|
|
766
1849
|
"timeout": 20000,
|
|
767
1850
|
"tag": "业务线策略",
|
|
768
1851
|
"domain": "biz-line",
|
|
769
|
-
"shortcut": "+facebook-
|
|
1852
|
+
"shortcut": "+facebook-metrics",
|
|
770
1853
|
"risk": "read",
|
|
771
1854
|
"summary": "Facebook广告策略成效数据",
|
|
772
1855
|
"docFile": "biz-line-strategy.md",
|
|
@@ -775,27 +1858,31 @@
|
|
|
775
1858
|
"properties": {
|
|
776
1859
|
"startDate": {
|
|
777
1860
|
"type": "string",
|
|
778
|
-
"description": "
|
|
1861
|
+
"description": "统计开始日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-01\"。必填。",
|
|
1862
|
+
"title": "开始日期"
|
|
779
1863
|
},
|
|
780
1864
|
"endDate": {
|
|
781
1865
|
"type": "string",
|
|
782
|
-
"description": "
|
|
1866
|
+
"description": "统计结束日期,字符串,格式 yyyy-MM-dd,例如 \"2026-08-31\"。必填,需大于等于 startDate。成效数据最多支持查询近21天,超出范围可能返回空数据。",
|
|
1867
|
+
"title": "结束日期"
|
|
783
1868
|
},
|
|
784
1869
|
"dimensionValues": {
|
|
785
1870
|
"type": "object",
|
|
786
|
-
"description": "
|
|
1871
|
+
"description": "过滤条件。结构为「字段名 → 取值数组」的键值对(Java 类型 Map<String, List<Object>>),value 必须是数组,即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效,传其他 key 不报错但无过滤效果。示例:{\"account_id\": [\"act_123\", \"act_456\"]}",
|
|
787
1872
|
"properties": {
|
|
788
1873
|
"account_id": {
|
|
789
1874
|
"type": "array",
|
|
790
1875
|
"items": {
|
|
791
1876
|
"type": "string"
|
|
792
1877
|
},
|
|
793
|
-
"description": "广告账户ID
|
|
1878
|
+
"description": "广告账户ID列表,字符串数组,必填且不能为空数组。取值形如 \"act_1036928420879324\"(带 act_ 前缀)。多个账户之间是「或」关系,返回这些账户的合并数据。",
|
|
1879
|
+
"title": "广告账户ID"
|
|
794
1880
|
}
|
|
795
1881
|
},
|
|
796
1882
|
"required": [
|
|
797
1883
|
"account_id"
|
|
798
|
-
]
|
|
1884
|
+
],
|
|
1885
|
+
"title": "过滤条件"
|
|
799
1886
|
},
|
|
800
1887
|
"dimensions": {
|
|
801
1888
|
"type": "array",
|
|
@@ -823,7 +1910,8 @@
|
|
|
823
1910
|
"targeting_genders"
|
|
824
1911
|
]
|
|
825
1912
|
},
|
|
826
|
-
"description": "
|
|
1913
|
+
"description": "分组维度,字符串数组,必传且不能为空数组(传空数组返回结果为空)。传多个维度时按多字段组合分组,等同 SQL 的 GROUP BY 多列,维度越多粒度越细、返回行数越多。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_flexible_interests(弹性兴趣词包)、targeting_exclusion_interests(排除兴趣词包)、targeting_age(年龄)、targeting_genders(性别)",
|
|
1914
|
+
"title": "分组维度"
|
|
827
1915
|
},
|
|
828
1916
|
"indicators": {
|
|
829
1917
|
"type": "array",
|
|
@@ -844,11 +1932,13 @@
|
|
|
844
1932
|
"engagement"
|
|
845
1933
|
]
|
|
846
1934
|
},
|
|
847
|
-
"description": "
|
|
1935
|
+
"description": "成效指标,字符串数组,必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)",
|
|
1936
|
+
"title": "成效指标"
|
|
848
1937
|
},
|
|
849
1938
|
"order": {
|
|
850
1939
|
"type": "string",
|
|
851
|
-
"description": "
|
|
1940
|
+
"description": "单字段排序的字段名,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回。与 orders 可同时使用,order 指定的字段会追加到 orders 之后。",
|
|
1941
|
+
"title": "排序字段"
|
|
852
1942
|
},
|
|
853
1943
|
"orderType": {
|
|
854
1944
|
"type": "string",
|
|
@@ -856,15 +1946,24 @@
|
|
|
856
1946
|
"desc",
|
|
857
1947
|
"asc"
|
|
858
1948
|
],
|
|
859
|
-
"description": "
|
|
1949
|
+
"description": "排序方向,配合 order 使用。desc 降序,asc 升序,默认 asc。",
|
|
1950
|
+
"title": "排序方向"
|
|
1951
|
+
},
|
|
1952
|
+
"orders": {
|
|
1953
|
+
"type": "object",
|
|
1954
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
1955
|
+
"properties": {},
|
|
1956
|
+
"title": "多字段排序"
|
|
860
1957
|
},
|
|
861
1958
|
"page": {
|
|
862
1959
|
"type": "integer",
|
|
863
|
-
"description": "页码,从1开始,默认1"
|
|
1960
|
+
"description": "页码,从 1 开始,默认 1。",
|
|
1961
|
+
"title": "页码"
|
|
864
1962
|
},
|
|
865
1963
|
"size": {
|
|
866
1964
|
"type": "integer",
|
|
867
|
-
"description": "每页条数,默认10
|
|
1965
|
+
"description": "每页条数,默认 10,建议显式指定。返回的 result.total 为总条数,据此判断是否还有下一页。",
|
|
1966
|
+
"title": "每页条数"
|
|
868
1967
|
}
|
|
869
1968
|
},
|
|
870
1969
|
"required": [
|
|
@@ -877,7 +1976,7 @@
|
|
|
877
1976
|
}
|
|
878
1977
|
},
|
|
879
1978
|
{
|
|
880
|
-
"name": "
|
|
1979
|
+
"name": "icenter-strategy-metrics-google",
|
|
881
1980
|
"displayName": "Google广告策略成效数据",
|
|
882
1981
|
"description": "查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置(成效目标、创意类型、出价方式、广告系列类型、关键字等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
883
1982
|
"group": "业务线策略",
|
|
@@ -886,7 +1985,7 @@
|
|
|
886
1985
|
"timeout": 20000,
|
|
887
1986
|
"tag": "业务线策略",
|
|
888
1987
|
"domain": "biz-line",
|
|
889
|
-
"shortcut": "+
|
|
1988
|
+
"shortcut": "+google-metrics",
|
|
890
1989
|
"risk": "read",
|
|
891
1990
|
"summary": "Google广告策略成效数据",
|
|
892
1991
|
"docFile": "biz-line-strategy.md",
|
|
@@ -895,11 +1994,13 @@
|
|
|
895
1994
|
"properties": {
|
|
896
1995
|
"startDate": {
|
|
897
1996
|
"type": "string",
|
|
898
|
-
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
1997
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01",
|
|
1998
|
+
"title": "开始日期"
|
|
899
1999
|
},
|
|
900
2000
|
"endDate": {
|
|
901
2001
|
"type": "string",
|
|
902
|
-
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天"
|
|
2002
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天",
|
|
2003
|
+
"title": "结束日期"
|
|
903
2004
|
},
|
|
904
2005
|
"dimensionValues": {
|
|
905
2006
|
"type": "object",
|
|
@@ -910,12 +2011,14 @@
|
|
|
910
2011
|
"items": {
|
|
911
2012
|
"type": "string"
|
|
912
2013
|
},
|
|
913
|
-
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
2014
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个",
|
|
2015
|
+
"title": "广告账户ID"
|
|
914
2016
|
}
|
|
915
2017
|
},
|
|
916
2018
|
"required": [
|
|
917
2019
|
"account_id"
|
|
918
|
-
]
|
|
2020
|
+
],
|
|
2021
|
+
"title": "过滤条件"
|
|
919
2022
|
},
|
|
920
2023
|
"dimensions": {
|
|
921
2024
|
"type": "array",
|
|
@@ -944,7 +2047,8 @@
|
|
|
944
2047
|
"keywords"
|
|
945
2048
|
]
|
|
946
2049
|
},
|
|
947
|
-
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)"
|
|
2050
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)",
|
|
2051
|
+
"title": "分组维度"
|
|
948
2052
|
},
|
|
949
2053
|
"indicators": {
|
|
950
2054
|
"type": "array",
|
|
@@ -965,11 +2069,13 @@
|
|
|
965
2069
|
"engagement"
|
|
966
2070
|
]
|
|
967
2071
|
},
|
|
968
|
-
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)"
|
|
2072
|
+
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)",
|
|
2073
|
+
"title": "成效指标"
|
|
969
2074
|
},
|
|
970
2075
|
"order": {
|
|
971
2076
|
"type": "string",
|
|
972
|
-
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
2077
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回",
|
|
2078
|
+
"title": "排序字段"
|
|
973
2079
|
},
|
|
974
2080
|
"orderType": {
|
|
975
2081
|
"type": "string",
|
|
@@ -977,15 +2083,24 @@
|
|
|
977
2083
|
"desc",
|
|
978
2084
|
"asc"
|
|
979
2085
|
],
|
|
980
|
-
"description": "排序方向,默认 asc"
|
|
2086
|
+
"description": "排序方向,默认 asc",
|
|
2087
|
+
"title": "排序方向"
|
|
2088
|
+
},
|
|
2089
|
+
"orders": {
|
|
2090
|
+
"type": "object",
|
|
2091
|
+
"title": "多字段排序",
|
|
2092
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
2093
|
+
"properties": {}
|
|
981
2094
|
},
|
|
982
2095
|
"page": {
|
|
983
2096
|
"type": "integer",
|
|
984
|
-
"description": "页码,从1开始,默认1"
|
|
2097
|
+
"description": "页码,从1开始,默认1",
|
|
2098
|
+
"title": "页码"
|
|
985
2099
|
},
|
|
986
2100
|
"size": {
|
|
987
2101
|
"type": "integer",
|
|
988
|
-
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
2102
|
+
"description": "每页条数,默认10,建议显式传且不超过1000",
|
|
2103
|
+
"title": "每页条数"
|
|
989
2104
|
}
|
|
990
2105
|
},
|
|
991
2106
|
"required": [
|
|
@@ -998,7 +2113,7 @@
|
|
|
998
2113
|
}
|
|
999
2114
|
},
|
|
1000
2115
|
{
|
|
1001
|
-
"name": "
|
|
2116
|
+
"name": "icenter-strategy-metrics-tiktok",
|
|
1002
2117
|
"displayName": "TikTok广告策略成效数据",
|
|
1003
2118
|
"description": "查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置(广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
1004
2119
|
"group": "业务线策略",
|
|
@@ -1007,7 +2122,7 @@
|
|
|
1007
2122
|
"timeout": 20000,
|
|
1008
2123
|
"tag": "业务线策略",
|
|
1009
2124
|
"domain": "biz-line",
|
|
1010
|
-
"shortcut": "+
|
|
2125
|
+
"shortcut": "+tiktok-metrics",
|
|
1011
2126
|
"risk": "read",
|
|
1012
2127
|
"summary": "TikTok广告策略成效数据",
|
|
1013
2128
|
"docFile": "biz-line-strategy.md",
|
|
@@ -1016,11 +2131,13 @@
|
|
|
1016
2131
|
"properties": {
|
|
1017
2132
|
"startDate": {
|
|
1018
2133
|
"type": "string",
|
|
1019
|
-
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
2134
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01",
|
|
2135
|
+
"title": "开始日期"
|
|
1020
2136
|
},
|
|
1021
2137
|
"endDate": {
|
|
1022
2138
|
"type": "string",
|
|
1023
|
-
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天"
|
|
2139
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天",
|
|
2140
|
+
"title": "结束日期"
|
|
1024
2141
|
},
|
|
1025
2142
|
"dimensionValues": {
|
|
1026
2143
|
"type": "object",
|
|
@@ -1031,12 +2148,14 @@
|
|
|
1031
2148
|
"items": {
|
|
1032
2149
|
"type": "string"
|
|
1033
2150
|
},
|
|
1034
|
-
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
2151
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个",
|
|
2152
|
+
"title": "广告账户ID"
|
|
1035
2153
|
}
|
|
1036
2154
|
},
|
|
1037
2155
|
"required": [
|
|
1038
2156
|
"account_id"
|
|
1039
|
-
]
|
|
2157
|
+
],
|
|
2158
|
+
"title": "过滤条件"
|
|
1040
2159
|
},
|
|
1041
2160
|
"dimensions": {
|
|
1042
2161
|
"type": "array",
|
|
@@ -1064,7 +2183,8 @@
|
|
|
1064
2183
|
"deep_cpabid"
|
|
1065
2184
|
]
|
|
1066
2185
|
},
|
|
1067
|
-
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、objective(广告目标)、targeting_interests(兴趣词包)、conversion_bid(转化出价)、deep_cpabid(深度转化出价)"
|
|
2186
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、objective(广告目标)、targeting_interests(兴趣词包)、conversion_bid(转化出价)、deep_cpabid(深度转化出价)",
|
|
2187
|
+
"title": "分组维度"
|
|
1068
2188
|
},
|
|
1069
2189
|
"indicators": {
|
|
1070
2190
|
"type": "array",
|
|
@@ -1085,11 +2205,13 @@
|
|
|
1085
2205
|
"engagement"
|
|
1086
2206
|
]
|
|
1087
2207
|
},
|
|
1088
|
-
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)"
|
|
2208
|
+
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)",
|
|
2209
|
+
"title": "成效指标"
|
|
1089
2210
|
},
|
|
1090
2211
|
"order": {
|
|
1091
2212
|
"type": "string",
|
|
1092
|
-
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
2213
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回",
|
|
2214
|
+
"title": "排序字段"
|
|
1093
2215
|
},
|
|
1094
2216
|
"orderType": {
|
|
1095
2217
|
"type": "string",
|
|
@@ -1097,15 +2219,24 @@
|
|
|
1097
2219
|
"desc",
|
|
1098
2220
|
"asc"
|
|
1099
2221
|
],
|
|
1100
|
-
"description": "排序方向,默认 asc"
|
|
2222
|
+
"description": "排序方向,默认 asc",
|
|
2223
|
+
"title": "排序方向"
|
|
2224
|
+
},
|
|
2225
|
+
"orders": {
|
|
2226
|
+
"type": "object",
|
|
2227
|
+
"title": "多字段排序",
|
|
2228
|
+
"description": "多字段排序,结构为「字段名 → 排序方向」的有序键值对(Java 类型 LinkedHashMap<String, String>),按 key 的书写顺序依次排序,方向取值 desc 或 asc。示例:{\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。只需单字段排序时用 order + orderType 即可,不必传本字段。",
|
|
2229
|
+
"properties": {}
|
|
1101
2230
|
},
|
|
1102
2231
|
"page": {
|
|
1103
2232
|
"type": "integer",
|
|
1104
|
-
"description": "页码,从1开始,默认1"
|
|
2233
|
+
"description": "页码,从1开始,默认1",
|
|
2234
|
+
"title": "页码"
|
|
1105
2235
|
},
|
|
1106
2236
|
"size": {
|
|
1107
2237
|
"type": "integer",
|
|
1108
|
-
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
2238
|
+
"description": "每页条数,默认10,建议显式传且不超过1000",
|
|
2239
|
+
"title": "每页条数"
|
|
1109
2240
|
}
|
|
1110
2241
|
},
|
|
1111
2242
|
"required": [
|