文档中心 > API类目 > 飞猪商业化API

alitrip.bp.ad.campaign.create (飞猪商业化BP计划创建接口)

飞猪商业化BP计划创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
f_ad_camp_create_request FAdCampCreateRequest 必须 计划创建参数
  • └ budget_type
  • String
  • 必须
  • 1
  • 预算分配模式(1:日预算控制,2:总预算控制,3:月度预算控制)
  • └ pacing_type
  • Number
  • 必须
  • 1
  • 投放速度模式(1:均匀消耗,2:快速消耗)
  • └ total_budget
  • Number
  • 可选
  • 2000
  • 总预算(单位:分)
  • └ biz_code
  • String
  • 必须
  • xx
  • 产品线,开发单独提供
  • └ business_id
  • String
  • 必须
  • xx
  • 业务调用方,开发单独提供
  • └ month_budget
  • String
  • 可选
  • 202508:500000,202509:600000
  • 月度预算,总月数不能超过1年
  • └ begin_time
  • String
  • 必须
  • 20251101
  • 开始时间(yyyyMMdd)
  • └ end_time
  • String
  • 必须
  • 20251102
  • 结束时间(yyyyMMdd)
  • ad_group_list
  • FAdGroupCreateRequest []
  • 必须
  • [{}]
  • 物料单元信息
  • └ time_premium_max_rate
  • Number
  • 可选
  • 30
  • 时段溢价配置
  • └ material_type
  • String
  • 必须
  • 1
  • 物料类型(1:酒店,2:商品)
  • └ cia_rate
  • Number
  • 可选
  • 30
  • 普通溢价配置
  • └ user_time_premium
  • String
  • 可选
  • 18:00-23:59
  • 用户配置溢价时段
  • └ ext_material_id
  • String
  • 必须
  • Ax7BH
  • 外部物料标识
  • └ bid_price
  • Number
  • 必须
  • 150
  • 单元出价(单位:分)
  • └ day_budget
  • Number
  • 可选
  • 10000
  • 日预算(单位:分)
  • └ campaign_name
  • String
  • 可选
  • 门店推广_xx
  • 计划名称,不填则系统自动生成

响应参数

名称 类型 示例值 描述
result AdResult 返回结果
  • └ msg
  • String
  • 参数错误
  • 错误信息
  • └ trace_id
  • String
  • 2782377AJ8BVGTJ
  • 追溯trace
  • └ rt
  • Number
  • 10
  • rt情况
  • └ code
  • String
  • 0
  • 成功标识code
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ model
  • Number
  • 37472092
  • 返回创建成功的计划id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBpAdCampaignCreateRequest req = new AlitripBpAdCampaignCreateRequest();
AlitripBpAdCampaignCreateRequest.FAdCampCreateRequest obj1 = new AlitripBpAdCampaignCreateRequest.FAdCampCreateRequest();
obj1.setBudgetType("1");
obj1.setPacingType(1L);
obj1.setTotalBudget(2000L);
obj1.setBizCode("xx");
obj1.setBusinessId("xx");
obj1.setMonthBudget("202508:500000,202509:600000");
obj1.setBeginTime("20251101");
obj1.setEndTime("20251102");
List<AlitripBpAdCampaignCreateRequest.FAdGroupCreateRequest> list3 = new ArrayList<AlitripBpAdCampaignCreateRequest.FAdGroupCreateRequest>();
AlitripBpAdCampaignCreateRequest.FAdGroupCreateRequest obj4 = new AlitripBpAdCampaignCreateRequest.FAdGroupCreateRequest();
list3.add(obj4);
obj4.setTimePremiumMaxRate(30L);
obj4.setMaterialType("1");
obj4.setCiaRate(30L);
obj4.setUserTimePremium("18:00-23:59");
obj4.setExtMaterialId("Ax7BH");
obj4.setBidPrice(150L);
obj1.setAdGroupList(list3);
obj1.setDayBudget(10000L);
obj1.setCampaignName("门店推广_xx");
req.setFAdCampCreateRequest(obj1);
AlitripBpAdCampaignCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bp_ad_campaign_create_response>
    <result>
        <msg>参数错误</msg>
        <trace_id>2782377AJ8BVGTJ</trace_id>
        <rt>10</rt>
        <code>0</code>
        <success>true</success>
        <model>37472092</model>
    </result>
</alitrip_bp_ad_campaign_create_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

FAQ

返回
顶部