Performance reports

La API de Merchant Center ofrece, por ejemplo, informes de rendimiento 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 deseado que se devuelve. Debes agregar un filtro en el período para consultar los informes para los datos de rendimiento.

A continuación, se incluye una consulta de ejemplo que muestra una sola fila, con la cantidad total de clics dentro del 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 ejemplo, se observa que el comercio tuvo un total de 4,440. en todos los productos y todos los métodos de marketing, entre el 1.° de diciembre de 2020 y el 21 de diciembre de 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segmentos

Puedes usar MCQL para consultar campos de segmentos. Los campos Segmentos pueden ser atributos de producto (por ejemplo, offerId, brand y category) o evento atributos (por ejemplo, date y marketingMethod).

Los campos de segmentos actúan de manera similar a GROUP BY en SQL. Los campos de segmentos dividen métricas seleccionadas, agrupando por cada segmento en la cláusula SELECT.

Esta es una consulta de ejemplo que muestra los clics por día, en orden descendente por clicks, dentro de la condición agregada de un período. Solo las filas donde al menos se devuelve una métrica solicitada que 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 ejemplo muestra que el comerciante recibió 1,546 clics en todos los productos, en todos los métodos de marketing, el 1 de diciembre de 2020 y 829 clics en todos los productos y en todos los métodos de marketing el 2 de diciembre de 2020. El comercio no recibió clics el 3 de diciembre de 2020, por lo que no se devuelve nada por en esa fecha.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}