百度信息流推广API

    oCPC转化接口

    接口描述

    查询oCPC转化。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getOcpcTransFeed

    请求参数说明

    字段名称 类型 描述
    transFrom number 转化来源:取值见oCPC设置对象的transFrom字段

    响应参数说明

    字段名称 类型 描述
    appTransId number 转化ID
    transFrom number 转化来源
    transName string 转化名称
    transTypes array(number) 转化类型
    monitorUrl string 点击监测url
    appType number 应用类型,只有transFrom=1时有效,取值范围:1-iOS,2-Android
    downloadUrl string 下载url,只有transFrom=1和4时有效
    exposureUrl string 曝光监测url
    mode number 监测方式,取值范围:0-点击+曝光,1-点击
    transStatus number 激活状态,只有transFrom=1和7时有效,取值范围:0-无效默认值,1-已激活,2-未激活
    deepTransTypes array(number) 深度转化类型
    docid number docid,只有transFrom=1,应用类型为安卓且在新建时填写过docid或者channleId时有效
    appName string 应用名称,只有transFrom=1和13时有效
    apkName string 应用包名,transFrom=1,只有应用类型为安卓时有效 ;transFrom=13时有效
    appid number APP Store ID,transFrom=13,应用类型为IOS时有效
    sdkAppId number SDK应用ID, transFrom=13时有效
    sdkSecretKey string SDK应用密钥,transFrom=13时有效
    channelId number channelId,只有transFrom=1时有效,应用类型为安卓,且在新建时填写过有效

    请求示例

    POST /v1/feed/cloud/SearchFeedService/getOcpcTransFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
    		"transFrom": 1
    	}
    }

    响应示例

    {
      "header": {
        "desc": "success",
        "failures": [],
        "oprs": 3,
        "succ": 3,
        "status": 0,
        "oprtime": 0
      },
      "body": {
        "data": [
          {
            "monitorUrl": "http://xxxx",
            "appTransId": 3008020,
            "transFrom": 1,
            "transTypes": [
              4
            ],
            "downloadUrl": "https://xxxx",
            "exposureUrl": "http://xxxx",
            "appType": 1,
            "transStatus": 0,
            "transName": "xxxx",
            "deepTransTypes": [
              25,
              26
            ],
            "docid": 21852669,
            "appName": "xxxx",
            "apkName": "com.baidu.xxx"
          },
          {
            "monitorUrl": "http://xxxx",
            "appTransId": 3008020,
            "transFrom": 1,
            "transTypes": [
              4
            ],
            "downloadUrl": "https://xxxx",
            "exposureUrl": "http://xxxx",
            "appType": 2,
            "transStatus": 0,
            "transName": "yyyy",
            "deepTransTypes": [
              25,
              26
            ],
            "docid": 21852669,
            "appName": "yyyy",
            "apkName": "com.baidu.yyy",
            "channelId":1001
          },
          {
            "transFrom":13,
            "transName":"sdk_app",
            "transTypes":[4],
            "deepTransTypes":[28],
            "mode":1,
            "monitorUrl":"http://www.baidu.com",
            "appType":2,
             "sdkAppId":23456,
             "sdkSecretKey":"abcdddd",
             "appType":1,
             "appName":"墨迹天气",
             "apkName":"com.baidu.test.hello",
             "appid":5678
         }
        ]
      }
    }

    接口描述

    新增oCPC转化。

    创建应用API/SDK转化追踪,请注意API/SDK创建转化追踪是无法进行联调的。如果创建后状态为未激活状态,您需要前往投放平台进行联调激活。同一主体下对应包名(Android)或者APPID(IOS)已完成过一次激活联调,那么相同包名或者APPID新建的转化追踪将不需要再联调,会直接进入已激活状态,注意docid和channelId最多只能选择一个上传,您可以通过查询oCPC转化接口来查询转化状态和转化ID等。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/OcpcTransFeedService/addOcpcTransFeed

    请求参数说明

    字段名称 类型 描述
    transFrom number 转化来源,必填,取值1-应用下载-API激活,13-应用SDK(小流量),取值见oCPC设置对象的transFrom字段
    transName string 转化名称,必填,不能重复
    downloadUrl string 下载url,iOS APP必填,Android APP选填,不填docid则必填
    transTypes array(number) 转化类型,必填,取值范围:4-激活
    deepTransTypes array(number) 深度转化类型,选填,取值范围:25-注册,26-付费,27-客户自定义(小流量),28-次日留存(小流量),29-商品下单成功(小流量)
    mode number 监测方式,必填,取值范围:0-点击+曝光,1-点击
    monitorUrl string 点击监测url,必填
    exposureUrl string 曝光监测url,选填,如果监测方式为点击+曝光,则必填
    appType number 应用类型,必填,取值范围:1-iOS,2-Android
    docid number docid,transForm=1时有效,iOS APP不填,Android APP选填,填写无需填写downloadUrl、appName和apkName,与channelId 同时只能传递一个
    appName string 应用名称,iOS APP必填,Android APP选填,不填docid和channelId则必填
    apkName string 应用包名,transFrom=1时,iOS APP不填,Android APP选填,不填docid和channelId则必填,transFrom=13时必填,值为IOS APP的的APP Sign, Android APP的包名
    appid number APP Store ID,transFrom=13时,appType=1必填,appType=2不填
    sdkAppId number SDK应用ID,tansFrom=13时必填
    sdkSecretKey string SDK应用密钥,tansFrom=13时必填
    channelId number channelId,transForm=1时有效,ios APP不填,Android APP选填,填写无需填写docid,downloadUrl、appName和apkName ,与docid同时只能传一个

    响应参数说明

    字段名称 类型 描述
    appTransId number 转化ID
    transFrom number 转化来源
    transName string 转化名称
    transTypes array(number) 转化类型
    monitorUrl string 点击监测url
    appType number 应用类型,取值范围:1-iOS,2-Android
    downloadUrl string 下载url,只有transFrom=1和4时有效
    exposureUrl string 曝光监测url
    mode number 监测方式,取值范围:0-点击+曝光,1-点击
    transStatus number 激活状态,只有transFrom=1和7时有效,取值范围:0-无效默认值,1-已激活,2-未激活
    deepTransTypes array(number) 深度转化类型
    docid number docid,只有transFrom=1,应用类型为安卓且在新建时填写过时有效
    appName string 应用名称,transFrom=1和13时有效
    apkName string 应用包名,transFrom=1和13时有效
    appid number APP Store ID,transForm=13时且appType=1时有效
    sdkAppId number SDK应用ID,transForm=13时有效
    sdkSecretKey string SDK应用密钥,transFrom=13时有效
    channelId number channelId,只有transFrom=1时有效,应用类型为安卓,且在新建时填写过有效

    请求示例

    POST /v1/feed/cloud/OcpcTransFeedService/addOcpcTransFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
            "ocpcTransFeedTypes": [{
                "transFrom": 1,
                "transTypes": [4],
                "monitorUrl": "http://www.baidu.com?c={{CALLBACK_URL}}",
                "transName": "apptrans1",
                "appType": 2,
                "downloadUrl": "http://cover.baidu.com/cover/deeplink_android?downloadUrl=22705583",
                "exposureUrl": "http://www.baidu.com?c={{CALLBACK_URL}}",
                "mode": 0,
                "deepTransTypes": [],
                "appName": "龙皇传说",
                "apkName": "com.cs.h5game.lhcsx5",
                "channelId":1001
            },
            {
                "transFrom": 1,
                "transTypes": [4],
                "monitorUrl": "http://www.baidu.com?c={{CALLBACK_URL}}",
                "transName": "apptrans2",
                "appType": 2,
                "downloadUrl": "http://cover.baidu.com/cover/deeplink_android?downloadUrl=15069034",
                "exposureUrl": "http://www.baidu.com?c={{CALLBACK_URL}}",
                "mode": 0,
                "deepTransTypes": [],
                "docid": "",
                "appName": "墨迹天气",
                "apkName": "com.baidu.test.hello.myapplication"
            },
            {
            "transFrom":13,
            "transName":"sdk_app",
            "transTypes":[4],
            "deepTransTypes":[28],
            "mode":1,
            "monitorUrl":"http://www.baidu.com",
            "appType":2,
             "sdkAppId":23456,
             "sdkSecretKey":"abcdddd",
             "appType":1,
             "appName":"墨迹天气",
             "apkName":"com.baidu.test.hello",
             "appid":5678,
           }
          ]
        }
    }

    响应示例

    {
        "header": {
            "oprs": 2,
            "failures": [],
            "succ": 2,
            "oprtime": 1,
            "desc": "success",
            "status": 0
        },
        "body": {
            "data": [{
                    "appName": "墨迹天气",
                    "apkName": "com.baidu.test.hello.myapplication",
                    "monitorUrl": "http://www.baidu.com?c={{CALLBACK_URL}}&akey=MTM4MTUxMw==",
                    "appTransId": 3297632,
                    "transFrom": 1,
                    "transTypes": [
                        4
                    ],
                    "downloadUrl": "http://cover.baidu.com/cover/deeplink_android?downloadUrl=15069034",
                    "exposureUrl": "http://www.baidu.com?c={{CALLBACK_URL}}&akey=MTM4MTUxMw==",
                    "appType": 2,
                    "transStatus": 2,
                    "transName": "apptrans2",
                    "mode": 0
                },{
                    "appName": "龙皇传说",
                    "apkName": "com.cs.h5game.lhcsx5",
                    "monitorUrl": "http://www.baidu.com?c={{CALLBACK_URL}}&akey=MTM4MTUxMw==",
                    "appTransId": 3297631,
                    "transFrom": 1,
                    "transTypes": [
                        4
                    ],
                    "downloadUrl": "http://cover.baidu.com/cover/deeplink_android?downloadUrl=22705583",
                    "exposureUrl": "http://www.baidu.com?c={{CALLBACK_URL}}&akey=MTM4MTUxMw==",
                    "appType": 2,
                    "transStatus": 1,
                    "transName": "apptrans1",
                    "mode": 0
                },{
                "transFrom":13,
                "transName":"sdk_app",
                "transTypes":[4],
                "deepTransTypes":[28],
                "mode":1,
                "monitorUrl":"http://www.baidu.com",
                "appType":2,
                "sdkAppId":23456,
                "sdkSecretKey":"abcdddd",
                "appType":1,
                "appName":"墨迹天气",
                "apkName":"com.baidu.test.hello",
                "appid":5678
               }]
        }
    }
    上一篇
    查询商圈、区县
    下一篇
    查询百青藤媒体信息