淘宝开放平台

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

阿里妈妈-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
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示例
<unidesk_rta_ad_adgroup_add_response>
    <result>
        <id>1</id>
    </result>
</unidesk_rta_ad_adgroup_add_response>

异常示例

  • XML示例
  • JSON示例
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部