文档中心 > API类目 > 阿里妈妈-UniDesk

taobao.unidesk.rta.ad.adgroup.add (UD计划创建接口)

UD计划创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request_id String 可选 1 请求id,用于幂等唯一key,创建计划建议填写 本接口需向媒体侧提交任务耗时较长,因TOPAPI 5秒超时限制,可能会在任务执行中提示“超时”/“远程服务调用超时”/“重复请求”等报错,此时可以用相同的request_id进行幂等重试即可返回最新结果
adgroup_top_dto AdgroupTopDTO 必须 入参
  • └ smooth
  • Number
  • 可选
  • 1
  • 头条投放形式: 1 - 加速投放;2 - 平滑投放;3-优先低成本(投放时间范围只可为全天;预算不可为不限或空) 字节2.0不支持. 腾讯出价策略:1-稳定拿量 2-优先拿量 3-优先低成本
  • budget
  • BudgetTopDTO
  • 必须
  • 预算
  • └ budget_type
  • Number
  • 必须
  • 1
  • 预算类型 -1:不限、1:指定预算(每天预算相同),3:分日预算(每天预算不同),仅快手支持。头条2.0只支持指定预算
  • └ budget
  • Number
  • 可选
  • 1
  • 统一预算金额,单位:分
  • └ day_budgets
  • Number []
  • 可选
  • 50000
  • 分日预算,单位:分,周一到周日每天的数组,-1表示不限。仅快手支持
  • └ campaign_id
  • Number
  • 必须
  • 1
  • 计划组id
  • landing_page
  • LandingPageTopDTO
  • 必须
  • 落地页
  • └ landing_page
  • String
  • 必须
  • http://xx
  • 落地页url
  • └ dp_link_url
  • String
  • 可选
  • tbopen://m.taobao.com/tbopen
  • 自定义deeplink,需要UDBP开通白名单功能才能使用
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id
  • target
  • AdgroupTargetTopDTO
  • 可选
  • 定向,未特殊标明的不传字段的值表示不限
  • area
  • AreaDTO
  • 可选
  • 地域定向
  • city
  • CommonDTO []
  • 可选
  • list
  • 地域信息
  • └ name
  • String
  • 可选
  • 北京
  • 地域名称
  • └ value
  • String
  • 可选
  • 11
  • 地域值
  • └ city_target
  • Number
  • 可选
  • 1
  • 城市目标人群,1:正在该地区的用户,2:居住在该地区的用户,3:到该地区旅行的用户,4:该地区内的所有用户
  • └ type
  • Number
  • 可选
  • 1
  • 地域定向类型,-1:不限,1:指定地区
  • interest_action
  • InterestActionDTO
  • 可选
  • 行为兴趣
  • action_categorie
  • ActionCategorieDTO
  • 可选
  • 行为分类
  • action_categories
  • CommonDTO []
  • 可选
  • list
  • 行为类目
  • └ num
  • String
  • 可选
  • 11
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • └ action_scene
  • String []
  • 可选
  • 1
  • 行为场景,1:电商行为场景,2:咨询行为场景,3:app行为场景
  • └ action_days
  • Number
  • 可选
  • 1
  • 行为天数,1:7天,2:15天,3:30天,4:60天,5:90天,6:180天,7:365天
  • keywords
  • CommonDTO []
  • 可选
  • list
  • 关键词
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • └ action_strength
  • Number
  • 可选
  • 0
  • 行为强度,0:不限;1:高强度
  • interest_categorie
  • InterestCategorieDTO
  • 可选
  • 兴趣分类
  • keywords
  • CommonDTO []
  • 可选
  • list
  • 关键词
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • interest_categories
  • CommonDTO []
  • 可选
  • list
  • 行为类目
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • └ type
  • Number
  • 可选
  • 1
  • 1,系统推荐 2 自定义
  • └ hide_if_converted
  • Number
  • 可选
  • 1
  • 过滤已转化用户,0(默认):不限;1:广告组2:广告计划;3:本账户;
  • └ net_carrier
  • String []
  • 可选
  • 1
  • 网络运营商:不传值表示不限,1:移动,2:联通,3:电信
  • └ career
  • String []
  • 可选
  • 1
  • 职业,1:大学生,2:教师,3:IT,4:公务员,5:金融,6:医务人员
  • └ gender
  • Number
  • 可选
  • 1
  • 性别,不传值表示不限,1:女,2:男
  • device
  • DeviceDTO
  • 可选
  • 设备-品牌/价格
  • └ device_brands
  • String []
  • 可选
  • 1
  • 设备品牌,1:荣耀,2:苹果,3:华为,4:小米,5:三星,6:OPPO,7:VIVO,8:魅族,9:金立,10:酷派,11:联想,12:乐视,13:中兴,14:中国移动,15:HTC,16:小辣椒,17:努比亚,18:海信,19:奇酷,20:TCL,21:索尼,22:锤子手机,23:360手机,24:一加手机,25:LG,26:摩托罗拉,27:诺基亚,28:谷歌,100:其他
  • └ device_price_type
  • Number
  • 可选
  • 1
  • 设备价格类型方式:,0:手动定义
  • └ device_prices
  • String []
  • 可选
  • 0
  • 设备价格,最小价格-最大价格
  • └ auto_extend_targets
  • String []
  • 可选
  • 1
  • 智能放量,1:年龄,2:性别,3:地域,4:行为兴趣,5:学历
  • age
  • AgeDTO
  • 可选
  • 年龄
  • └ age_range
  • String []
  • 可选
  • 1
  • 快手使用,与custom_range不能同传 固定年龄段,【-1 : 表示不限】;【 18:表示 18-23 岁】;【24:表示 24-30 岁】;【31:表示 31-40 岁】;【41:表示 41-49 岁】;【50:表示 50-100 岁】
  • └ custom_age
  • String []
  • 可选
  • 18
  • 快手使用,与age_range不能同传 :自定义年龄段,数组size=2,第一位传最小值、第二位传最大值
  • └ type
  • Number
  • 可选
  • 2
  • 快手使用:类型,-1:不限,1:选择年龄段,2:自定义年龄段
  • platform
  • PlatformDTO []
  • 可选
  • list
  • 平台
  • └ type
  • Number
  • 可选
  • 1
  • 操作系统类型,-1:不限,1:安卓,3:iOS
  • └ android_version
  • Number
  • 可选
  • 4
  • 安卓版本,-1:不限,4:4.x+,5:5.x+,6:6.x+,7:7.x+,8:8.x+,9:9.x+,10:10.x+
  • └ ios_version
  • Number
  • 可选
  • 1
  • iOS版本,-1:不限,7:7.x+,8:8.x+,9:9.x+,10:10.x+,11:11.x+,12:12.x+,13:13.x+
  • toutiao
  • ToutiaoAdgroupTargetTopDTO
  • 可选
  • 头条特有定向
  • └ user_activate_type
  • String []
  • 可选
  • 1
  • 新用户,-1:不限,1:一个月内,2:一个月到三个月,3:三个月以上
  • └ superior_popularity_type
  • Number
  • 可选
  • 1
  • 流量精选包,-1:不限,2:游戏精选流量包
  • aweme_fan_behavior
  • AwemeFanBehaviorDTO
  • 可选
  • 抖音达人定向
  • keywords
  • CommonDTO []
  • 可选
  • list
  • 关键词
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • └ aweme_fan_days
  • Number
  • 可选
  • 1
  • 互动天数,1:15天,2:30天,3:60天
  • └ aweme_fan_scene
  • String []
  • 可选
  • 1
  • 行为场景,1:关注,2:评论,3:点赞,4:分享
  • aweme_fan_categories
  • CommonDTO []
  • 可选
  • list
  • 抖音达人账号类目
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ name
  • String
  • 可选
  • 名称
  • 名称
  • └ value
  • String
  • 可选
  • 1
  • └ network
  • String []
  • 可选
  • 1
  • 网络,不传值表示不限,0:Wi-Fi,1:移动网络,2:2G,3:3G,4:4G
  • kuaishou
  • KuaishouAdgroupTargetTopDTO
  • 可选
  • 快手特有定向
  • fans_star
  • CommonDTO []
  • 可选
  • 1
  • 网红粉丝
  • └ name
  • String
  • 可选
  • 风景-风景
  • 名称
  • └ value
  • String
  • 可选
  • 2
  • └ intelli_target_switch
  • Number
  • 可选
  • 0
  • 智能定向 0:关闭 1:开启 默认关闭
  • cast_time
  • CastTimeTopDTO
  • 可选
  • castTime
  • 投放周期
  • └ time_series
  • String
  • 可选
  • 111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111
  • 时段,24*7 位 0 或 1 组成的字符串,小时粒度; 从 周一 0 点开始到周日 24 点结束,0 不投放,1 投放; 禁止全部为 0,不传或者全部为 1,表示全时段投放
  • └ time_type
  • Number
  • 可选
  • 1
  • 投放周期类型,0:从今天起长期投放,1:设置开始和结束日期
  • └ start_time
  • Date
  • 可选
  • 2022-08-25 00:00:00
  • 投放周期,开始时间,time_type=1时必填
  • └ end_time
  • Date
  • 可选
  • 2022-08-25 00:00:00
  • 投放周期,结束时间,time_type=1时必填
  • └ cast_show_type
  • Number
  • 可选
  • 1
  • 投放形式,1:激励视频,2:原生,3:开机图,4:知+内容
  • └ name
  • String
  • 必须
  • 1
  • 计划名称
  • pricing
  • AdgroupPricingTopDTO
  • 必须
  • pricing
  • 付费出价,头条2.0仅需填写bid,头条2.0项目开启深度优化后需要填roi系数
  • └ cast_target
  • Number
  • 可选
  • 1
  • 投放目标,1:转化量,2:点击量,3:展示量
  • └ convert_target
  • Number
  • 可选
  • 1
  • 转化目标,1:到达,2:下单,5:表单提交
  • └ bid
  • Number
  • 可选
  • 1
  • 头条2.0和广点通使用 出价,单位:分
  • └ cpa_bid
  • Number
  • 可选
  • 1
  • 头条1.0和快手使用 转化目标出价,单位:分
  • └ pricing_type
  • Number
  • 可选
  • 1
  • 付费方式,2:CPM,3:CPC,5:OCPM 头条和快手只能用OCPM 广点通可三者都选
  • └ bid_type
  • Number
  • 可选
  • 1
  • 出价方式:1:自动,2:手动
  • └ adjust_cpa
  • Number
  • 可选
  • 1
  • 字段已下线,可忽略不传
  • └ roi_goal
  • String
  • 可选
  • 0.01
  • roi系数 头条2.0使用,项目开启深度优化后可填
  • tencent
  • TencentAdgroupTopDTO
  • 可选
  • 腾讯特有参数,仅自定义创意创建需要创建adgroup,程序化创意在创意的创建参数中填写
  • └ cast_scopes
  • String []
  • 可选
  • 1
  • 投放范围类型:1:优量汇,2:微信公众号与小程序,3:腾讯新闻,4:腾讯视频,5:腾讯看点,6:QQ、腾讯音乐及游戏,8:微信朋友圈
  • └ creative_group_display_type
  • Number
  • 可选
  • 1
  • 创意展现方式:1:优选模式,2轮播模式
  • └ derive_switch
  • Number
  • 可选
  • 1
  • 是否开启衍生创意功能:1:是,0:否
  • kuaishou
  • KuaishouAdgroupTopDTO
  • 可选
  • 快手特有参数
  • └ cast_scope
  • Number
  • 可选
  • 0
  • 投放范围,0:快手默认, 7:快手开屏, 1:快手联盟, 16:快手激励视频。快手默认、快手联盟、快手激励视频支持程序化创意,快手开屏支持自定义创意
  • toutiao_v2
  • ToutiaoAdgroupV2TopDTO
  • 可选
  • 头条2.0特有参数
  • media_creative_group
  • ToutiaoMediaCreativeGroupV2TopDTO
  • 可选
  • 创意素材
  • materials
  • MediaMaterialTopDTO []
  • 可选
  • 视频素材,图片和视频素材上限均为10个
  • └ format
  • Number
  • 可选
  • 1
  • 广告形式,1:竖版视频,2:横版视频,3:大图横图,5:小图,6:大图竖图,7:开屏图片。竖版视频:格式要求:mp4、mpeg、3gp、avi 视频格式,建议尺寸要求:宽高比9:16,分辨率≥ 720*1280,视频码率≥516kbps,时长≥4s; 竖版视频-视频封面:格式要求:jpg、jpeg、png 图片格式,尺寸要求:宽高比9:16,1440*2560 ≤ 尺寸≥ 720*1280; 横版视频:格式要求:mp4、mpeg、3gp、avi 视频格式,建议尺寸要求:宽高比16:9,分辨率≥ 1280*720,视频码率≥516kbps,时长≥4s,大小≤1000M; 横版视频-视频封面:格式要求:jpg、jpeg、png 图片格式,尺寸要求:宽高比16:9,2560*1440 ≤ 尺寸≥ 1280*720; 大图横图:格式要求:jpg、jpeg、png 图片格式,尺寸要求:宽高比16:9,2560*1440 ≤ 尺寸≥ 1280*720; 小图:格式要求:jpg、jpeg、png 图片格式,尺寸要求:宽高比1.52,1368*900 ≤ 尺寸≥ 456*300; 大图竖图:格式要求:jpg、jpeg、png 图片格式,尺寸要求:宽高比9:16,1440*2560 ≤ 尺寸≥ 720*1280;
  • └ cc_material_id
  • String
  • 可选
  • 1
  • 素材id
  • └ type
  • Number
  • 可选
  • 1
  • 素材类型,1:图片,2:视频
  • video_conver_material
  • VideoConverMaterialTopDTO
  • 可选
  • 视频封面,素材类型为视频时必填
  • └ cc_material_id
  • String
  • 可选
  • 1
  • 素材id
  • └ direct_material_id
  • Number
  • 可选
  • 1
  • 达人视频素材id 广告形式为抖音号视频的时候必传 从达人授权关系接口获取。video_info.material_id
  • └ talent_item_id
  • Number
  • 可选
  • 1
  • 达人视频原生id 广告形式为抖音号视频的时候必传 从达人授权关系接口获取。video_info.talent_item_id
  • └ native_video_url
  • String
  • 可选
  • https://www.douyin
  • 视频链接 广告形式为抖音号视频的时候必传 从达人授权关系接口获取。video_info.url
  • └ talent_video_cover_id
  • String
  • 可选
  • tos-cn-p-0015/oM
  • 达人视频封面id 广告形式为抖音号视频的时候必传 从达人授权关系接口获取。video_info.video_cover_id
  • └ talent_video_id
  • String
  • 可选
  • tos-cn-p-0015/oM
  • 达人视频id. 广告形式为抖音号视频的时候必传 从达人授权关系接口获取。video_info.video_id
  • └ native_video_format
  • Number
  • 可选
  • 1
  • 原生视频模版类型,只有原生广告授权类型为单视频且广告形式为抖音号视频(format=18)时必传,从达人授权关系接口获取。video_info.image_mode
  • title_materials
  • TextMaterialTopDTO []
  • 可选
  • 标题,最多添加10个标题,每个标题最多30个字
  • └ content
  • String
  • 可选
  • 文案内容
  • 文案内容
  • └ action_texts
  • String []
  • 可选
  • 行动号召
  • 行动号召,最多10个行动号召,单个号召2-6个字
  • └ creative_component_id
  • Number
  • 可选
  • 1
  • 创意组件ID
  • └ anchor_component_id
  • Number
  • 可选
  • 1
  • 锚点组件id
  • └ anchor_related_type
  • Number
  • 可选
  • 1
  • 锚点启用类型 1 不启用 2 手动选择 注:账户类型为深转,推广目的为电商店铺推广且为原生广告投放才可使用锚点
  • production
  • ToutiaoProductionV2DTO
  • 可选
  • 产品信息
  • └ name
  • String
  • 可选
  • 产品名称
  • 产品名称
  • └ material_ids
  • String []
  • 可选
  • 1
  • 产品主图,最多10个,产品主图尺寸大小只支持108*108
  • └ selling_points
  • String []
  • 可选
  • 产品卖点
  • 产品卖点,最多10条,单个卖点6-9个字符,中文算1字符,英文/数字算0.5字符
  • └ ad_source
  • String
  • 可选
  • 广告来源
  • 广告来源
  • └ comment_switch
  • Number
  • 可选
  • 1
  • 是否开启评论功能:1:开启,0:关闭
  • └ ad_download_switch
  • Number
  • 可选
  • 1
  • 是否开启客户端下载功能:1:开启,0:关闭 投放位置仅包含“穿山甲”时不支持选择【广告评论】和【客户端下载视频】. 推广类型为抖音号时开启不生效
  • promotion_identity
  • ToutiaoPromotionIdentityV2TopDTO
  • 可选
  • 广告推广类型
  • └ promotion_type
  • Number
  • 可选
  • 1
  • 推广类型:1:抖音号,2:账户信息. 默认为账户信息
  • └ talent_id
  • String
  • 可选
  • 1
  • 抖音达人ID。推广类型为抖音号时必填
  • └ auth_type
  • Number
  • 可选
  • 1
  • 授权类型 1 抖音号授权 2 单视频授权 推广类型为抖音号时必填
  • └ is_hide_video
  • Number
  • 可选
  • 1
  • 是否主页作品列表隐藏广告内容:1:隐藏,0:不隐藏 推广类型为抖音号时有效且必传
  • └ version
  • Number
  • 可选
  • 9999
  • 平台版本,9999:升级版API(仅巨量2.0API需传入)

响应参数

名称 类型 示例值 描述
result AdgroupTopDTO 返回结果
  • └ id
  • Number
  • 1
  • 计划id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAdAdgroupAddRequest req = new UnideskRtaAdAdgroupAddRequest();
req.setRequestId("1");
UnideskRtaAdAdgroupAddRequest.AdgroupTopDTO obj1 = new UnideskRtaAdAdgroupAddRequest.AdgroupTopDTO();
obj1.setSmooth(1L);
UnideskRtaAdAdgroupAddRequest.BudgetTopDTO obj2 = new UnideskRtaAdAdgroupAddRequest.BudgetTopDTO();
obj2.setBudgetType(1L);
obj2.setBudget(1L);
obj2.setDayBudgets(new Long[] { 50000 };
);
obj1.setBudget(obj2);
obj1.setCampaignId(1L);
UnideskRtaAdAdgroupAddRequest.LandingPageTopDTO obj3 = new UnideskRtaAdAdgroupAddRequest.LandingPageTopDTO();
obj3.setLandingPage("http://xx");
obj3.setDpLinkUrl("tbopen://m.taobao.com/tbopen");
obj1.setLandingPage(obj3);
obj1.setAdvertiserId(1L);
UnideskRtaAdAdgroupAddRequest.AdgroupTargetTopDTO obj4 = new UnideskRtaAdAdgroupAddRequest.AdgroupTargetTopDTO();
UnideskRtaAdAdgroupAddRequest.AreaDTO obj5 = new UnideskRtaAdAdgroupAddRequest.AreaDTO();
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list7 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj8 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list7.add(obj8);
obj8.setName("北京");
obj8.setValue("11");
obj5.setCity(list7);
obj5.setCityTarget(1L);
obj5.setType(1L);
obj4.setArea(obj5);
UnideskRtaAdAdgroupAddRequest.InterestActionDTO obj9 = new UnideskRtaAdAdgroupAddRequest.InterestActionDTO();
UnideskRtaAdAdgroupAddRequest.ActionCategorieDTO obj10 = new UnideskRtaAdAdgroupAddRequest.ActionCategorieDTO();
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list12 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj13 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list12.add(obj13);
obj13.setNum("11");
obj13.setName("名称");
obj13.setValue("1");
obj10.setActionCategories(list12);
obj10.setActionScene("1");
obj10.setActionDays(1L);
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list15 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj16 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list15.add(obj16);
obj16.setNum("1");
obj16.setName("名称");
obj16.setValue("1");
obj10.setKeywords(list15);
obj10.setActionStrength(0L);
obj9.setActionCategorie(obj10);
UnideskRtaAdAdgroupAddRequest.InterestCategorieDTO obj17 = new UnideskRtaAdAdgroupAddRequest.InterestCategorieDTO();
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list19 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj20 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list19.add(obj20);
obj20.setNum("1");
obj20.setName("名称");
obj20.setValue("1");
obj17.setKeywords(list19);
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list22 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj23 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list22.add(obj23);
obj23.setNum("1");
obj23.setName("名称");
obj23.setValue("1");
obj17.setInterestCategories(list22);
obj9.setInterestCategorie(obj17);
obj9.setType(1L);
obj4.setInterestAction(obj9);
obj4.setHideIfConverted(1L);
obj4.setNetCarrier("1");
obj4.setCareer("1");
obj4.setGender(1L);
UnideskRtaAdAdgroupAddRequest.DeviceDTO obj24 = new UnideskRtaAdAdgroupAddRequest.DeviceDTO();
obj24.setDeviceBrands("1");
obj24.setDevicePriceType(1L);
obj24.setDevicePrices("0");
obj4.setDevice(obj24);
obj4.setAutoExtendTargets("1");
UnideskRtaAdAdgroupAddRequest.AgeDTO obj25 = new UnideskRtaAdAdgroupAddRequest.AgeDTO();
obj25.setAgeRange("1");
obj25.setCustomAge("18");
obj25.setType(2L);
obj4.setAge(obj25);
List<UnideskRtaAdAdgroupAddRequest.PlatformDTO> list27 = new ArrayList<UnideskRtaAdAdgroupAddRequest.PlatformDTO>();
UnideskRtaAdAdgroupAddRequest.PlatformDTO obj28 = new UnideskRtaAdAdgroupAddRequest.PlatformDTO();
list27.add(obj28);
obj28.setType(1L);
obj28.setAndroidVersion(4L);
obj28.setIosVersion(1L);
obj4.setPlatform(list27);
UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupTargetTopDTO obj29 = new UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupTargetTopDTO();
obj29.setUserActivateType("1");
obj29.setSuperiorPopularityType(1L);
UnideskRtaAdAdgroupAddRequest.AwemeFanBehaviorDTO obj30 = new UnideskRtaAdAdgroupAddRequest.AwemeFanBehaviorDTO();
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list32 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj33 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list32.add(obj33);
obj33.setNum("1");
obj33.setName("名称");
obj33.setValue("1");
obj30.setKeywords(list32);
obj30.setAwemeFanDays(1L);
obj30.setAwemeFanScene("1");
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list35 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj36 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list35.add(obj36);
obj36.setNum("1");
obj36.setName("名称");
obj36.setValue("1");
obj30.setAwemeFanCategories(list35);
obj29.setAwemeFanBehavior(obj30);
obj4.setToutiao(obj29);
obj4.setNetwork("1");
UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTargetTopDTO obj37 = new UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTargetTopDTO();
List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list39 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>();
UnideskRtaAdAdgroupAddRequest.CommonDTO obj40 = new UnideskRtaAdAdgroupAddRequest.CommonDTO();
list39.add(obj40);
obj40.setName("风景-风景");
obj40.setValue("2");
obj37.setFansStar(list39);
obj37.setIntelliTargetSwitch(0L);
obj4.setKuaishou(obj37);
obj1.setTarget(obj4);
UnideskRtaAdAdgroupAddRequest.CastTimeTopDTO obj41 = new UnideskRtaAdAdgroupAddRequest.CastTimeTopDTO();
obj41.setTimeSeries("111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111");
obj41.setTimeType(1L);
obj41.setStartTime(StringUtils.parseDateTime("2022-08-25 00:00:00"));
obj41.setEndTime(StringUtils.parseDateTime("2022-08-25 00:00:00"));
obj1.setCastTime(obj41);
obj1.setCastShowType(1L);
obj1.setName("1");
UnideskRtaAdAdgroupAddRequest.AdgroupPricingTopDTO obj42 = new UnideskRtaAdAdgroupAddRequest.AdgroupPricingTopDTO();
obj42.setCastTarget(1L);
obj42.setConvertTarget(1L);
obj42.setBid(1L);
obj42.setCpaBid(1L);
obj42.setPricingType(1L);
obj42.setBidType(1L);
obj42.setAdjustCpa(1L);
obj42.setRoiGoal("0.01");
obj1.setPricing(obj42);
UnideskRtaAdAdgroupAddRequest.TencentAdgroupTopDTO obj43 = new UnideskRtaAdAdgroupAddRequest.TencentAdgroupTopDTO();
obj43.setCastScopes("1");
obj43.setCreativeGroupDisplayType(1L);
obj43.setDeriveSwitch(1L);
obj1.setTencent(obj43);
UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTopDTO obj44 = new UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTopDTO();
obj44.setCastScope(0L);
obj1.setKuaishou(obj44);
UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupV2TopDTO obj45 = new UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupV2TopDTO();
UnideskRtaAdAdgroupAddRequest.ToutiaoMediaCreativeGroupV2TopDTO obj46 = new UnideskRtaAdAdgroupAddRequest.ToutiaoMediaCreativeGroupV2TopDTO();
List<UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO> list48 = new ArrayList<UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO>();
UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO obj49 = new UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO();
list48.add(obj49);
obj49.setFormat(1L);
obj49.setCcMaterialId("1");
obj49.setType(1L);
UnideskRtaAdAdgroupAddRequest.VideoConverMaterialTopDTO obj51 = new UnideskRtaAdAdgroupAddRequest.VideoConverMaterialTopDTO();
obj51.setCcMaterialId("1");
list50.setVideoConverMaterial(obj51);
obj49.setDirectMaterialId(1L);
obj49.setTalentItemId(1L);
obj49.setNativeVideoUrl("https://www.douyin");
obj49.setTalentVideoCoverId("tos-cn-p-0015/oM");
obj49.setTalentVideoId("tos-cn-p-0015/oM");
obj49.setNativeVideoFormat(1L);
obj46.setMaterials(list48);
List<UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO> list53 = new ArrayList<UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO>();
UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO obj54 = new UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO();
list53.add(obj54);
obj54.setContent("文案内容");
obj46.setTitleMaterials(list53);
obj46.setActionTexts("行动号召");
obj46.setCreativeComponentId(1L);
obj46.setAnchorComponentId(1L);
obj46.setAnchorRelatedType(1L);
obj45.setMediaCreativeGroup(obj46);
UnideskRtaAdAdgroupAddRequest.ToutiaoProductionV2DTO obj55 = new UnideskRtaAdAdgroupAddRequest.ToutiaoProductionV2DTO();
obj55.setName("产品名称");
obj55.setMaterialIds("1");
obj55.setSellingPoints("产品卖点");
obj45.setProduction(obj55);
obj45.setAdSource("广告来源");
obj45.setCommentSwitch(1L);
obj45.setAdDownloadSwitch(1L);
UnideskRtaAdAdgroupAddRequest.ToutiaoPromotionIdentityV2TopDTO obj56 = new UnideskRtaAdAdgroupAddRequest.ToutiaoPromotionIdentityV2TopDTO();
obj56.setPromotionType(1L);
obj56.setTalentId("1");
obj56.setAuthType(1L);
obj56.setIsHideVideo(1L);
obj45.setPromotionIdentity(obj56);
obj1.setToutiaoV2(obj45);
obj1.setVersion(9999L);
req.setAdgroupTopDto(obj1);
UnideskRtaAdAdgroupAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
<unidesk_rta_ad_adgroup_add_response>
    <result>
        <id>1</id>
    </result>
</unidesk_rta_ad_adgroup_add_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部