Performance reports

La API de Merchant ofrece informes de rendimiento, por ejemplo product_performance_view. 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 sobre los datos de rendimiento.

A continuación, se muestra una consulta de ejemplo que devuelve una sola fila con la cantidad total de clics dentro del período especificado:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Debes especificar los datos que deseas que se muestren. Los comodines (por ejemplo, SELECT *) muestran un error.

La siguiente respuesta de ejemplo muestra que el comercio tuvo 4,440 clics totales en todos los productos y métodos de marketing entre el 1 y el 21 de diciembre de 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

Segmentos

Puedes usar campos de segmentos para la segmentación en los informes de rendimiento. Por ejemplo, si consultas marketing_method, se mostrará un informe con una fila para cada método de marketing y las métricas que especifiques para ese método de marketing en la cláusula SELECT.

Los campos de segmentos pueden ser atributos de productos (por ejemplo, offer_id, brand y category) o atributos de eventos (por ejemplo, date y marketing_method).

Los campos de segmentos funcionan de manera similar a GROUP BY en SQL. Los campos de segmentos dividen las métricas seleccionadas y las agrupan por cada segmento en la cláusula SELECT.

A continuación, se muestra una consulta de ejemplo que devuelve 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 product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

La siguiente respuesta de ejemplo muestra que el comercio tuvo 1,546 clics en todos los productos y métodos de marketing el 1 de diciembre de 2023, y 829 clics en todos los productos y métodos de marketing el 2 de diciembre de 2023. El comercio no tuvo clics el 3 de diciembre de 2023, por lo que no se muestra nada para esa fecha.

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

Al igual que con los informes personalizados en Merchant Center, puedes especificar varios segmentos en la misma consulta con la API de Merchant Reports.

A continuación, se muestra una consulta de ejemplo que devuelve los clics de todos los productos de tu cuenta durante un período de 30 días, segmentados por marketing_method y offer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

La respuesta de esta consulta incluye una fila para cada combinación de offer_id y marketing_method, con la cantidad de clics para esa combinación:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Categoría y tipo de producto

El lenguaje de consultas de Merchant Center admite la segmentación de métricas por dos grupos de atributos que puedes definir para organizar tu inventario:

Niveles de categoría

Categorías de la taxonomía de productos de Google. Es posible que Google asigne automáticamente la categoría a tu producto si no se proporcionó ninguna o que refine aún más la categoría proporcionada.

Niveles de tipo de producto

Tipos de productos que asignas según tu clasificación. A diferencia de los niveles de categoría, no hay un conjunto predefinido de valores admitidos.

Tanto los atributos de categoría como de tipo de producto se organizan en una jerarquía con varios niveles. La especificación de producto separa cada nivel con el carácter >, pero seleccionas cada nivel de la jerarquía por separado en los informes.

Por ejemplo, considera un producto con los siguientes niveles de tipo de producto:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Los informes muestran cada nivel en su propio campo:

Métricas de moneda y precio

Las métricas de precios, como conversion_value, se representan con el tipo Price. Si la métrica está disponible en varias monedas, el valor de cada moneda se muestra en una fila separada. Por ejemplo, la siguiente consulta:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

devuelve los siguientes resultados:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Si solicitas métricas de precios y que no sean de precios en una consulta, las métricas de precios se muestran en filas de resultados separadas de las métricas que no sean de precios, una fila de resultados por código de moneda. Por ejemplo, la siguiente consulta:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

genera la siguiente respuesta:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Todos los campos que selecciones se mostrarán en la respuesta, incluso si su valor sigue siendo el valor predeterminado o cero.

Para obtener más información sobre los campos disponibles para la consulta, consulta Campos en la tabla productPerformanceView.