Merchant Center 查询语言 (MCQL) 是一种查询语言,类似于 SQL。您可以将 MCQL 与 Merchant Reports API 来检索效果数据,了解您的商品以及所参与竞争的市场。
语法
下面是 MCQL 语法参考(采用正则表达式表示法):
Query -> SelectClause FromClause? WhereClause? OrderByClause? LimitClause?
SelectClause -> SELECT FieldName (, FieldName)*
FromClause -> FROM TableName
WhereClause -> WHERE Condition (AND Condition)*
OrderByClause -> ORDER BY Ordering (, Ordering)*
LimitClause -> LIMIT PositiveInteger
Condition -> FieldName Operator Value | FieldName BETWEEN Value AND Value
Operator -> = | != | > | >= | < | <= | <> | IN | NOT IN |
CONTAINS ANY | CONTAINS ALL | CONTAINS NONE | DURING |
LIKE | NOT LIKE | REGEXP_MATCH | NOT REGEXP_MATCH
Value -> Number | NumberList | String | StringList | Function
Ordering -> FieldName (ASC | DESC)?
FieldName -> [a-z] ([a-zA-Z0-9._])*
TableName -> [A-Z] ([a-zA-Z_])*
StringList -> ( String (, String)* )
NumberList -> ( Number (, Number)* )
PositiveInteger -> [1-9] ([0-9])*
Number -> -? [0-9]+ (. [0-9] [0-9]*)?
String -> (' Char* ') | (" Char* ")
Function -> LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS |
LAST_BUSINESS_WEEK | LAST_MONTH | LAST_WEEK_MON_SUN |
LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY
您可以使用以下符号:
?
表示可选元素。*
表示零个或更多个;+
表示一个或多个。(xxxxxx)
表示分组。[a-z0-9]
表示字符范围。|
代表“或”。
大小写区分
大多数 MCQL 运算符都区分大小写:
运算符 | 区分大小写 |
---|---|
= 或 != | 区分大小写 |
(NOT) IN | 区分大小写 |
(NOT) 顶 | 区分大小写 |
包含 (...) | 区分大小写 |
REGEXP_MATCH | (可选)两者 |
条款
以下是您可以使用 MCQL 查询的子句:
SELECT
SELECT
子句接受以英文逗号分隔的字段列表来检索。
您可以从正在使用的视图中选择任何字段。以下是您可以选择的一些字段示例:
您可以在单个请求中查询多个字段类型。示例如下:
SELECT
date,
marketingMethod,
impressions,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
FROM
FROM
子句在请求中指定要从中提取数据的表。您只能在 FROM
子句中指定一个字段。所有查询都需要 FROM
子句。
WHERE
使用 WHERE
子句过滤请求的数据。性能查询需要使用 WHERE
子句。您可以按所有细分字段进行过滤,也可以在 SELECT
子句中指定其他metrics字段进行过滤。
以下示例使用 WHERE
仅返回指定时间段(8 月份)的展示次数:
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
您可以使用 AND
运算符在单个查询中按多个条件进行过滤。在不同条件之间使用 AND
,例如:WHERE marketingMethod !=
"ADS" AND marketingMethod != "ORGANIC"
。您不能在单个条件中的值之间使用 AND
,例如:WHERE marketingMethod != "ADS" AND "ORGANIC"
。
以下示例返回 8 月份 ADS
营销方法对应的每个优惠的点击次数(点击次数超过 100):
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE clicks > 100
AND marketingMethod = 'ADS'
AND date BETWEEN '2020-08-01' AND '2020-08-31'
WHERE
子句不支持 OR
。运算符区分大小写。如需查看运算符的完整列表,请参阅语法。
ORDER BY(可选)
ORDER BY
子句可让您按指定顺序检索结果。
按 fieldName
指定顺序,然后按 ASC
或 DESC
指定。您只能按查询的 SELECT
子句中指定的字段进行排序。如果您未指定,ORDER BY
默认为 ASC
。
以下查询会按点击次数从高到低对返回的行进行排序:
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY clicks DESC
您可以使用逗号分隔列表在 ORDER BY
子句中指定多个字段。
例如,以下查询的结果按 offerId
升序排序,再按展示次数降序排序,再按点击次数降序排序:
SELECT offerId, impressions, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
offerId,
impressions DESC,
clicks DESC
LIMIT
LIMIT
子句用于指定要返回的结果数量。
以下是一个仅返回 50 个结果的示例,即使有更多行可用。
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50
使用 pageSize
字段处理较长的结果列表。
日期范围
您可以利用 MCQL 指定自定义日期范围或相对日期范围。您必须使用 WHERE
子句为所有性能查询指定 date
范围。
自定义
您可按以下格式指定 ISO 8601(YYYY-MM-DD) 日期:
date BETWEEN '2021-01-01' AND '2021-01-31'
date >= '2021-01-01' AND date <= '2021-01-31'
您可以使用单引号 ('
) 或双引号 ("
) 定义日期字符串。
相关
您可以使用 DURING
而不是 BETWEEN
和 AND
来指定相对日期范围,例如 LAST_30_DAYS
或 THIS_MONTH
:
WHERE date DURING LAST_30_DAYS
如需查看可用相对日期范围的完整列表,请参阅语法。