oCPC转化接口
更新时间:2020-10-30
接口描述
查询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) | 转化类型,必填,取值见oCPC设置对象的transType字段 |
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
}]
}
}