API de informes
La API de informes permite que un comercio interactúe con sus datos de rendimiento de forma programática a través del 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 que los comercios grandes importen datos de rendimiento de las fichas de productos a sus sistemas de informes internos o de terceros.
- Permite que los usuarios, los socios externos y los agregadores que administran cuentas de Merchant Center accedan a los informes.
Los usuarios de la API pueden especificar qué datos de rendimiento desean recuperar en la respuesta de la llamada de Búsqueda, como los siguientes:
- Métricas que se mostrarán (por ejemplo, clics o impresiones)
- Dimensiones en las que se segmentarán 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 consultar Content API for Shopping para obtener métricas de rendimiento (clics, impresiones), posiblemente segmentadas por varias dimensiones (atributos de eventos informados, como el programa y la fecha, y atributos de productos, como la marca, la categoría, etc.), con el método Search
en el servicio Reports
.
El resultado de una consulta al servicio Reports
es una lista de instancias de ReportRow
, cada una de las cuales representa los valores de las métricas solicitadas para los segmentos que especificaste en tu consulta.ReportRow
Si no se especifican segmentos, se muestra una sola fila con las métricas agregadas en todos los segmentos. De lo contrario, si se solicitan segmentos junto con las métricas, la respuesta muestra una fila para cada tupla de segmentos única. Es posible seleccionar varios segmentos y varias métricas en una sola consulta.
Cómo consultar métricas
Puedes consultar las métricas (clics, impresiones, CTR, etc.) que deseas que se muestren. Debes agregar un filtro al período para consultar el servicio de informes. La siguiente consulta de muestra muestra una sola fila: el importe agregado de clics dentro de 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
En la siguiente respuesta de código JSON de muestra, se muestra cómo este comercio tuvo 4,440 clics en todos sus productos en todos sus destinos entre el 1 y el 21 de diciembre de 2020.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Cómo consultar segmentos
Además de las métricas, también puedes consultar segmentos, que pueden ser un atributo de un producto (offer_id
, brand
, category
, etcétera) o un atributo de un evento informado (date
, program
). Un evento informado es una impresión o un clic para un producto.
Los segmentos actúan de manera similar a un GROUP BY
en SQL. Los segmentos dividen las métricas seleccionadas y las agrupan por cada segmento en la cláusula SELECT
. La siguiente consulta de muestra muestra los clics por día, ordenados por clics descendentes 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 sea distinta de cero.
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
En la siguiente respuesta de código JSON de ejemplo, se muestra cómo este comercio tuvo 1,546 clics en todos sus productos en todos sus destinos el 1 de diciembre de 2020 y 829 clics en todos sus productos en todos sus destinos el 2 de diciembre de 2020. No se mostrará ningún objeto para el 3 de diciembre de 2020, ya que el comercio no tuvo 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"
}
}
]}