Il linguaggio di query di Merchant Center (MCQL) è un linguaggio di query simile a SQL. Puoi utilizzare la MCQL con l'API Merchant Reports per recuperare i dati sul rendimento dei tuoi prodotti e del mercato in cui concorrono.
Grammatica
Ecco il riferimento alla grammatica MCQL (in notazione di espressione regolare):
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
Puoi utilizzare i seguenti simboli:
?indica un elemento facoltativo.*significa zero o più;+significa uno o più.(xxxxxx)indica un raggruppamento.[a-z0-9]indica intervalli di caratteri.|significa "o".
Sensibilità alle maiuscole
La maggior parte degli operatori MCQL è sensibile alle maiuscole:
| Operatori | Distinzione tra maiuscole e minuscole |
|---|---|
| = o != | Maiuscole/minuscole |
| (NON) TRA | Maiuscole/minuscole |
| (NON) MI PIACE | Maiuscole/minuscole |
| CONTIENE (...) | Maiuscole/minuscole |
| REGEXP_MATCH | Facoltativamente entrambi |
Clausole
Ecco le clausole su cui puoi eseguire una query con la MCQL:
SELECT
La clausola SELECT richiede un elenco di campi separati da virgole da recuperare.
Puoi selezionare qualsiasi campo dalla visualizzazione in uso. Ecco alcuni esempi di campi che puoi selezionare:
Puoi eseguire query su più tipi di campi in una singola richiesta. Esempio:
SELECT
date,
marketingMethod,
impressions,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
FROM
La clausola FROM specifica la tabella da cui recuperare i dati nella richiesta. Puoi specificare un solo campo nella clausola FROM. La clausola FROM è obbligatoria per
tutte le query.
WHERE
Utilizza la clausola WHERE per filtrare i dati relativi alla richiesta. La clausola WHERE è obbligatoria per le query sul rendimento.
Puoi filtrare in base a tutti i campi dei segmenti e in base a campi metrics aggiuntivi, se li specifichi nella clausola SELECT.
Di seguito è riportato un esempio in cui viene utilizzato WHERE per restituire le impressioni solo per un periodo di tempo specificato (il mese di agosto):
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
Puoi filtrare in base a più condizioni in una singola query con l'operatore AND.
Utilizza AND tra le condizioni complete, ad esempio: WHERE marketingMethod !=
"ADS" AND marketingMethod != "ORGANIC". Non puoi utilizzare AND tra valori in una
singola condizione, ad esempio: WHERE marketingMethod != "ADS" AND "ORGANIC".
Ecco un esempio che restituisce il numero di clic per offerta, con più di 100 clic, per il metodo di marketing ADS, durante il mese di agosto:
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE clicks > 100
AND marketingMethod = 'ADS'
AND date BETWEEN '2020-08-01' AND '2020-08-31'
La clausola WHERE non supporta OR. Gli operatori sono sensibili alle maiuscole. Per un elenco completo degli operatori, vedi grammar.
ORDER BY (Facoltativo)
La clausola ORDER BY consente di recuperare i risultati in un ordine specificato.
Specifica l'ordine specificando fieldName, quindi ASC o DESC. Puoi ordinare solo in base ai campi specificati nella clausola SELECT della query. Se non specifichi un valore, ORDER BY è impostato in modo predefinito su ASC.
La seguente query ordina le righe restituite in base al numero di clic, dal più alto al più basso:
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY clicks DESC
Puoi specificare più campi nella clausola ORDER BY utilizzando un elenco separato da virgole.
Ad esempio, i risultati della seguente query vengono ordinati in ordine crescente per offerId, poi in ordine decrescente per numero di impressioni e in ordine decrescente per numero di clic:
SELECT offerId, impressions, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
offerId,
impressions DESC,
clicks DESC
LIMITE
La clausola LIMIT ti consente di specificare il numero di risultati da restituire.
Ecco un esempio che restituisce solo 50 risultati, anche se sono disponibili più righe.
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50
Utilizza il campo pageSize per gestire lunghi elenchi di risultati.
Intervalli di date
L'MCQL consente di specificare un intervallo di date personalizzato o relativo. Devi utilizzare la clausola WHERE per specificare un intervallo date per tutte le query sulle prestazioni.
Personalizzato
Puoi specificare date ISO 8601(AAAA-MM-GG) nei seguenti formati:
date BETWEEN '2021-01-01' AND '2021-01-31'date >= '2021-01-01' AND date <= '2021-01-31'
Puoi definire le stringhe della data utilizzando virgolette singole (') o doppie (").
Parente
Puoi specificare un intervallo di date relativo, come LAST_30_DAYS o THIS_MONTH,
utilizzando DURING anziché BETWEEN e AND:
WHERE date DURING LAST_30_DAYS
Consulta la grammatica per l'elenco completo degli intervalli di date relativi disponibili.