Lingxing
切换旧版

查询自动规则执行日志

POST/basicOpen/openapi/newad/autoRuleLogs

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/openapi/newad/autoRuleLogsHTTPSPOST1

请求参数

startDatestring必填
执行开始日期,格式 YYYY-MM-DD,按店铺时区从当天 00:00:00 起包含。
endDatestring必填
执行结束日期,格式 YYYY-MM-DD,包含店铺时区当天的全部时间。必须大于或等于 startDate;可与开始日期相同。
userIdstring
优化方案创建人的广告系统用户 ID,按执行日志记录的 userId 筛选,使用正整数字符串;省略或传 null 表示不按创建人筛选。
limitinteger
本批最多返回条数,范围1–100,默认50。
nextTokenstring
首次省略/null/空字符串;续取时原样传入上次返回的 next_token。与 PHP 加密游标不兼容,迁移后重新开始查询。筛选条件和租户必须与首次查询一致。最大4096字符。
profileIdstring
广告授权 ID,正整数字符串。仅支持 profileId。与 sid 至少提供一个,同时传入时优先使用 profileId。
sidinteger
ERP 店铺 ID,profileId 未提供时按当前租户查询广告授权。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/openapi/newad/autoRuleLogs?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "startDate": "2026-09-14",
  "endDate": "2026-10-13",
  "profileId": "2537307927915183",
  "limit": 50
}'

返回结果

JSON Object

codeinteger必填
平台状态码,0 表示成功。
示例 0
messagestring必填
响应消息。
示例 success
error_detailsarray<any>必填
参数校验等错误详情。
request_idstring必填
请求链路标识。
response_timestring必填
响应时间。
dataarray<object>必填
本批执行日志。
隐藏子属性
executionResultstring必填
本次优化的执行结果,仅返回成功或失败。
可选值:
成功
失败
ruleGroupUuidstring必填
优化方案 ID,使用字符串返回。
ruleGroupNamestring必填
执行日志记录的优化方案名称,历史数据缺失时可为 null。
profileIdstring必填
店铺 ID,对应广告账户 profileId,使用字符串返回。
storeNamestring必填
当前店铺名称或别名。
objectobject必填
优化对象明细。按实际层级返回活动、广告组、广告、关键词或投放对象的 ID 及名称文本;直接子字段为 null 时省略,空字符串可保留。objectId、objectText 为通用标识及展示文本。
隐藏子属性
campaignIdstring必填
所属广告活动 ID。
campaignNamestring
广告活动名称,优先取当前名称,缺失时回退到日志名称;均缺失时省略。
sponsoredTypestring
广告产品类型:sp 商品推广、sb 品牌推广、sd 展示型推广。
可选值:
sp
sb
sd
campaignTypestring必填
日志记录的广告活动投放类型:auto 自动投放、manual 手动投放。
可选值:
auto
manual
adGroupIdstring
所属广告组 ID;日志未关联广告组时省略。
adGroupNamestring
广告组名称,优先取当前名称,缺失时回退到日志名称;均缺失时省略。
objectIdstring必填
当前优化对象的通用标识,具体含义由对象层级决定,可为活动、广告组、广告、关键词或投放对象标识等。
objectTextstring
优化对象的通用展示名称或文本,如关键词及匹配类型、商品投放表达式。文本缺失时省略。
adIdstring
广告 ID,优化对象为商品广告时返回。
adTextstring
商品广告的原始展示文本,如日志记录的商品标识;仅相关广告层级且存在文本时返回。
keywordIdstring
关键词 ID,优化对象为关键词时返回。
keywordstring
关键词原文,不附加匹配类型展示文本;优化对象为关键词且存在原文时返回。
targetIdstring
投放对象 ID,优化对象为商品投放、自动定位或受众等投放对象时返回。
targetTextstring
投放对象展示文本,如 ASIN、品牌、分类、受众名称或投放条件;相关投放层级且存在文本时返回。
searchTermstring
用户搜索词原文,优化对象为搜索词且存在原文时返回。
matchTypestring
匹配类型,保留日志原值及大小写,例如 PHRASE、BROAD、EXACT;未记录时省略。
targetObjectobject
新增关键词或商品投放操作所写入的目标活动和广告组。仅操作中记录了目标活动及广告组时返回,可能与来源活动、广告组不同。
隐藏子属性
campaignIdstring必填
新增对象的目标广告活动 ID。
adGroupIdstring必填
新增对象的目标广告组 ID。
campaignNamestring必填
目标广告活动当前名称,未查到时返回 null。
adGroupNamestring必填
目标广告组当前名称,未查到时返回 null。
sponsoredTypestring必填
目标广告产品类型:sp 商品推广、sb 品牌推广、sd 展示型推广。
可选值:
sp
sb
sd
actionAtstring必填
执行时间,按店铺时区返回,格式 YYYY-MM-DD HH:mm:ss,精确到秒。文本不含时区偏移。
示例 2026-10-13 23:31:13
sourceDescstring必填
优化对象类型的展示文本,如广告活动、广告组、关键词、商品投放、搜索词。
actionNamestring必填
优化操作名称,如暂停关键词、提高竞价等。
actionExtractstring必填
优化操作参数的展示说明,与 actionName 配合使用;没有额外说明时为空字符串。
actionBeforestring必填
优化前的展示值,如竞价、状态、策略或对象类型;可包含换行,原始日志未记录时可为 null。
actionAfterstring必填
日志记录的优化后展示值,如调整后的竞价、状态、策略或对象类型;可包含换行,原始日志未记录时可为 null。失败日志中的该值不代表变更已成功生效。
sourceDateFromstring必填
本次优化计算指标使用的取数开始日期,格式 YYYY-MM-DD;未记录时为 null。
sourceDateTostring必填
本次优化计算指标使用的取数结束日期,格式 YYYY-MM-DD;未记录时为 null。
dateCyclearray<any>必填
时间周期设置的展示文本数组,如 ["前30天", "前1天"]、当日或累计取数设置。
ruleConditionarray<any>必填
指标及条件设置的展示文本数组,可直接展示;无条件文本时返回空数组。
hitDataTextarray<any>必填
本次优化取数结果的展示文本数组;无可展示的指标结果时可返回 ["--"]。
ruleHzstring必填
优化频率的展示文本,如间隔0天、仅优化一次等。
userIdstring必填
执行日志记录的优化方案创建人 ID,使用广告系统用户 ID,返回字符串。
userNamestring必填
执行日志记录的优化方案创建人名称,历史数据缺失时可为 null。
campaignTagsarray<object>必填
来源广告活动当前关联的标签,无标签时返回空数组。
隐藏子属性
uuidstring必填
标签 ID。
tagNamestring必填
标签名称。
totalinteger必填
当前批返回数量,不是全部命中记录数;接口不执行 COUNT。
示例 1
next_tokenstring
下一批游标,无更多记录时省略。

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "example-request-id",
  "response_time": "2026-10-27 12:00:00",
  "data": [
    {
      "executionResult": "成功",
      "ruleGroupUuid": "rule-example",
      "ruleGroupName": "示例优化方案",
      "profileId": "2537307927915183",
      "storeName": "示例店铺",
      "object": {
        "campaignId": "123456789",
        "campaignName": "示例活动",
        "sponsoredType": "sp",
        "campaignType": "manual",
        "adGroupId": "987654321",
        "adGroupName": "示例广告组",
        "objectId": "123456",
        "objectText": "example keyword - PHRASE",
        "keywordId": "123456",
        "keyword": "example keyword",
        "matchType": "PHRASE"
      },
      "actionAt": "2026-10-13 12:00:00",
      "sourceDesc": "关键词",
      "actionName": "提高竞价",
      "actionExtract": "",
      "actionBefore": "0.50",
      "actionAfter": "0.60",
      "sourceDateFrom": "2026-09-14",
      "sourceDateTo": "2026-10-13",
      "dateCycle": [
        "前30天"
      ],
      "ruleCondition": [],
      "hitDataText": [
        "--"
      ],
      "ruleHz": "间隔0天",
      "userId": "123",
      "userName": "示例用户",
      "campaignTags": []
    }
  ],
  "total": 1
}