回传线索状态

开发环境

POST

/v1.3/lead_clues/update

使用说明

回传标记线索管理平台（http://leads.qq.com）线索的转化状态，可登录线索管理平台，进入线索转发设置，查看回传详情。被标记为有效状态（潜在客户、高意向客户、已成单）的线索，可用于 OCPX 优化说明：为保证接口使用的安全性避免操作他人的线索信息，该接口只可用于操作自己广告主下的线索信息。

服务的沙箱环境正在建设中，近期即将上线。

接口暂时不支持 BM 角色调用。

POST 请求，Content-Type: application/json。

leads_convert_type 必须是字段定义的字符串。

leads_ineffect_reason 如果传值，必须是字段定义的字符串。

线索回传，仅更新账户 id 和线索 id 匹配的数据。

如果参数传递的线索没有更新或者更新失败，msg 会包含线索 id。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1.3/lead_clues/update' \
--header 'access_token: <ACCESS_TOKEN>' \
--header 'timestamp: <TIMESTAMP>' \
--header 'nonce: <NONCE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_id": 123456,
    "leads": [
        {
            "leads_id": 123,
            "leads_convert_type": "LEADS_CONVERT_STATUS_POTENTIAL_CUSTOMER",
            "leads_ineffect_reason": "",
            "leads_intention_score": "LEADS_INTENTION_SCORE_LEVEL_5"
        }
    ]
}'

响应示例

{
    "code": 0,
    "message": "",
    "message_cn": ""
}

修改于 2023-11-07 09:12:33

获取线索列表

获取中间号