API de informes
La API de Reporting permite que un comercio interactúe con sus datos de rendimiento de forma programática con el lenguaje de consulta de Merchant Center. Esto es similar a la capacidad de crear informes personalizados directamente en Merchant Center. La API de Reporting tiene los siguientes beneficios:
- Permite a los grandes comerciantes importar datos de rendimiento de las fichas de producto a sus sistemas de informes internos o de terceros.
- Permite a los usuarios, socios externos y agregadores que administran Merchant Center a los informes de acceso a las cuentas de Google Center.
Los usuarios de la API pueden especificar qué datos de rendimiento desean recuperar en la Respuesta de llamada de búsqueda, por ejemplo:
- Métricas que se mostrarán (por ejemplo: clics, impresiones)
- Dimensiones en las que se deben segmentar los datos (por ejemplo: OfferId, Date)
- Condiciones que se deben cumplir (por ejemplo: Clics > 100)
El lenguaje de consulta de la API de Reporting puede realizar consultas en la Content API for Shopping
métricas de rendimiento (clics, impresiones), posiblemente segmentadas por varias
dimensiones (atributos del evento informados, como programa y fecha, y
atributos, como marca, categoría, etc.), con el método Search en la
Servicio de Reports.
El resultado de una consulta al servicio Reports es una lista de ReportRow
instancias, en las que cada ReportRow representa los valores de las métricas solicitadas
para los segmentos que especificó en su consulta. Si no se especifica ningún segmento, se puede
se muestra con las métricas agregadas en todos los segmentos. De lo contrario, si
segmentos se solicitan junto con las métricas y, luego, la respuesta muestra una fila para
cada tupla de segmento único. Es posible seleccionar varios segmentos y
varias métricas en una sola consulta.
Consulta métricas
Puede consultar las métricas (clics, impresiones, CTR, etc.) que desee que se devuelven. Debes agregar un filtro en el período para consultar los informes servicio. La consulta de muestra a continuación muestra una sola fila: la cantidad total de los clics en la condición agregada de un período.
SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';
Respuesta de muestra
La respuesta de código JSON de muestra que aparece a continuación muestra cómo este comercio recibió 4,440 clics en todos sus productos en todos sus destinos entre 1 y 21 de diciembre de 2020.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Consulta de segmentos
Además de las métricas, también puede consultar los segmentos, que pueden ser un atributo de
un producto (offer_id, brand, category, etc.) o un atributo de un elemento informado
evento (date, program). Un evento informado es una impresión o un clic de un
producto.
Los segmentos actúan de manera similar a GROUP BY en SQL. Los segmentos dividen el contenido seleccionado
las métricas agrupadas por segmento en la cláusula SELECT. La siguiente consulta de muestra
Muestra los clics por día, ordenados por clics de forma descendente dentro de la condición agregada.
de un período. Solo se mostrarán las filas en las que al menos una métrica solicitada no sea cero
se devuelvan.
SELECT
segments.date,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;
Respuesta de muestra
La respuesta de código JSON de ejemplo que aparece a continuación muestra cómo este comercio recibió 1,546 clics. en todos sus productos y destinos a partir del 1 de diciembre de 2020 y 829 clics en todos los productos en todos sus destinos en 2 de diciembre de 2020. No se devolverá ningún objeto hasta el 3 de diciembre de 2020 desde el comerciante no recibió clics ese día.
{
"results": [
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 1
}
},
"metrics": {
"clicks": "1546"
}
},
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 2
}
},
"metrics": {
"clicks": "829"
}
}
]}