La API de Merchant ofrece informes de rendimiento, por ejemplo, ProductPerformanceView.
En esta página, se explica la estructura de los informes de rendimiento.
Métricas
Puedes consultar las métricas (por ejemplo, clicks y impressions) que deseas que se muestren. Debes agregar un filtro en el período para consultar el servicio de informes y obtener los datos de rendimiento.
A continuación, se incluye una consulta de muestra que muestra una sola fila con la cantidad total de clics en el período especificado:
SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'
Debes especificar los datos que quieres que se muestren. Los comodines (por ejemplo, SELECT
*) muestran un error.
En la siguiente respuesta de muestra, se muestra que el comercio recibió un total de 4,440 clics en todos los productos y en todos los métodos de marketing entre el 1 y el 21 de diciembre de 2020.
{
"results": [
{
"productPerformanceView": {
"clicks": "4,440"
}
}
]
}
Segmentos
Puedes usar MCQL para realizar consultas sobre los campos de segmentos. Los campos de segmentos pueden ser atributos de productos (por ejemplo, offerId, brand y category) o atributos de eventos (por ejemplo, date y marketingMethod).
Los campos de segmentos actúan de manera similar a un GROUP BY en SQL. Los campos de segmentos dividen las métricas seleccionadas y agrupan por cada segmento en la cláusula SELECT.
A continuación, se incluye una consulta de muestra que muestra los clics por día, en orden descendente por clicks, dentro de la condición agregada de un período. Solo se muestran las filas en las que al menos una métrica solicitada no es cero.
SELECT
date,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC
La siguiente respuesta de muestra muestra que el comercio recibió 1,546 clics en todos los productos y en todos los métodos de marketing el 1 de diciembre de 2020, y que el 2 de diciembre de 2020 recibió 829 clics en todos los productos y en todos los métodos de marketing. El comercio no tuvo clics el 3 de diciembre de 2020, por lo que no se muestra nada para esa fecha.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}