Le langage de requête Merchant Center (MCQL, Merchant Center Query Language) est un langage de requête semblable à SQL. Vous pouvez utiliser MCQL avec l'API Merchant Reports pour récupérer les données sur les performances de vos produits et du marché sur lequel ils sont en concurrence.
Grammaire
Voici la documentation de référence sur la grammaire MCQL (dans la notation d'expression régulière):
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
Vous pouvez utiliser les symboles suivants:
?
indique un élément facultatif.*
signifie zéro ou plusieurs.+
signifie un ou plusieurs.(xxxxxx)
indique un regroupement.[a-z0-9]
signifie des plages de caractères.|
signifie "ou".
Sensibilité à la casse
La plupart des opérateurs MCQL sont sensibles à la casse:
Opérateurs | Sensibilité à la casse |
---|---|
= ou != | Sensibilité à la casse |
(PAS) DANS | Sensibilité à la casse |
(NOT) LIKE | Sensibilité à la casse |
CONTAINS (...) | Sensibilité à la casse |
REGEXP_MATCH | Les deux (facultatif) |
Clauses
Voici les clauses que vous pouvez interroger avec le MCQL:
SELECT
La clause SELECT
utilise une liste de champs à récupérer, séparés par une virgule.
Vous pouvez sélectionner n'importe quel champ de la vue que vous utilisez. Voici quelques exemples de champs que vous pouvez sélectionner:
Vous pouvez interroger plusieurs types de champs dans une même requête. Exemple :
SELECT
date,
marketingMethod,
impressions,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
FROM
La clause FROM
spécifie la table à partir de laquelle extraire les données de la requête. Vous ne pouvez spécifier qu'un seul champ dans la clause FROM
. La clause FROM
est obligatoire pour toutes les requêtes.
WHERE
Utilisez la clause WHERE
pour filtrer les données de votre requête. La clause WHERE
est requise pour les requêtes de performances.
Vous pouvez filtrer tous les champs de segments et d'autres champs de metrics si vous les spécifiez dans la clause SELECT
.
Voici un exemple qui utilise WHERE
pour renvoyer les impressions d'une période spécifiée uniquement (le mois d'août):
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
Vous pouvez filtrer selon plusieurs conditions dans une même requête à l'aide de l'opérateur AND
.
Utilisez AND
entre des conditions complètes (par exemple, WHERE marketingMethod !=
"ADS" AND marketingMethod != "ORGANIC"
). Vous ne pouvez pas utiliser AND
entre les valeurs d'une même condition, par exemple: WHERE marketingMethod != "ADS" AND "ORGANIC"
.
Voici un exemple qui renvoie le nombre de clics par offre, pour lesquels il y a plus de 100 clics, pour la méthode marketing ADS
, au cours du mois d'août:
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE clicks > 100
AND marketingMethod = 'ADS'
AND date BETWEEN '2020-08-01' AND '2020-08-31'
La clause WHERE
n'est pas compatible avec OR
. Les opérateurs sont sensibles à la casse. Pour obtenir la liste complète des opérateurs, consultez la section Grammaire.
ORDER BY (facultatif)
La clause ORDER BY
vous permet de récupérer les résultats dans un ordre spécifié.
Spécifiez la commande avec fieldName
, puis ASC
ou DESC
. Vous ne pouvez trier que les champs spécifiés dans la clause SELECT
de votre requête. Si vous ne spécifiez pas cette valeur, ORDER BY
est défini par défaut sur ASC
.
La requête suivante trie les lignes renvoyées en fonction du nombre de clics, du plus élevé au moins élevé:
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY clicks DESC
Vous pouvez spécifier plusieurs champs dans la clause ORDER BY
à l'aide d'une liste d'éléments séparés par une virgule.
Par exemple, les résultats de la requête suivante sont triés dans l'ordre croissant par offerId
, puis par ordre décroissant du nombre d'impressions, puis par ordre décroissant du nombre de clics:
SELECT offerId, impressions, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
offerId,
impressions DESC,
clicks DESC
LIMIT
La clause LIMIT
vous permet de spécifier le nombre de résultats à renvoyer.
Voici un exemple qui ne renvoie que 50 résultats, même si davantage de lignes sont disponibles.
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50
Utilisez le champ pageSize
pour gérer de longues listes de résultats.
Plages de dates
Le MCQL vous permet de spécifier une plage de dates personnalisée ou relative. Vous devez utiliser la clause WHERE
afin de spécifier une plage date
pour toutes les requêtes de performances.
Personnalisés
Vous pouvez spécifier des dates au format ISO 8601(AAAA-MM-JJ) dans les formats suivants:
date BETWEEN '2021-01-01' AND '2021-01-31'
date >= '2021-01-01' AND date <= '2021-01-31'
Vous pouvez définir des chaînes de date avec des guillemets simples ('
) ou doubles ("
).
Relatif
Vous pouvez spécifier une plage de dates relative, telle que LAST_30_DAYS
ou THIS_MONTH
, en utilisant DURING
au lieu de BETWEEN
et AND
:
WHERE date DURING LAST_30_DAYS
Pour obtenir la liste complète des plages de dates relatives disponibles, consultez la section Grammaire.