oCPC转化接口

更新时间：2020-08-27

接口描述

查询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
           }]
    }
}

查询商圈、区县

查询百青藤媒体信息

oCPC转化接口

产品与文档反馈

提交失败

温馨提示

提交成功

温馨提示