文档中心 > API类目 > 用户增长

taobao.usergrowth.ad.material.data.sync (素材投放效果数据回传)

创意维度广告效果数据回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_url String 必须 https://xx.aliyuncs.com/xx.jpg 素材url
stat_date Date 必须 2021-10-25 12:00:00 统计日期
cost Number 可选 1
  • 默认值:0
  • 消耗
    signature String 必须 3bbd19bf212841ffba7d92a10e33b05d 文件md5
    device_os Number 可选 1
  • 默认值:0
  • 操作系统
    material_code String 可选 d53c7c1af47b44388ef79672286c1234 素材编码
    other_media String 可选 其他媒体 其他媒体
    ad_placement String 可选 INVENTORY_FEED 资源位
    click Number 必须 1
  • 默认值:0
  • 点击
    exposure Number 必须 11
  • 默认值:0
  • 曝光
    media_code String 必须 TOUTIAO 媒体
    channel_id Number 必须 1231 渠道id
    task_id Number 必须 123 任务id

    响应参数

    名称 类型 示例值 描述
    response_code Number 15 错误码
    data Boolean true 数据处理成功
    message String 参数错误 错误描述
    successful Boolean true 请求是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    UsergrowthAdMaterialDataSyncRequest req = new UsergrowthAdMaterialDataSyncRequest();
    req.setMaterialUrl("https://xx.aliyuncs.com/xx.jpg");
    req.setStatDate(StringUtils.parseDateTime("2021-10-25 12:00:00"));
    req.setCost(1L);
    req.setSignature("3bbd19bf212841ffba7d92a10e33b05d");
    req.setDeviceOs(1L);
    req.setMaterialCode("d53c7c1af47b44388ef79672286c1234");
    req.setOtherMedia("其他媒体");
    req.setAdPlacement("INVENTORY_FEED");
    req.setClick(1L);
    req.setExposure(11L);
    req.setMediaCode("TOUTIAO");
    req.setChannelId(1231L);
    req.setTaskId(123L);
    UsergrowthAdMaterialDataSyncResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <usergrowth_ad_material_data_sync_response>
        <response_code>15</response_code>
        <data>true</data>
        <message>参数错误</message>
        <successful>true</successful>
    </usergrowth_ad_material_data_sync_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

    返回
    顶部