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 al período para consultar el servicio de informes en busca de datos de rendimiento.

A continuación, se muestra una consulta de ejemplo que muestra 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.

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

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

Punto clave: Si no seleccionas ningún campo de segmentos en tu consulta, solo recibirás una fila de métricas.

Segmentos

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

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

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

Este es un ejemplo de consulta 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 es distinta de cero.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

En la siguiente respuesta de ejemplo, se muestra que el comercio tuvo 1,546 clics en todos los productos y en todos los métodos de marketing el 1 de diciembre de 2023 y 829 clics en todos los productos y en todos los 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"
      }
    }
  ]
}

Punto clave: Solo puedes seleccionar campos de segmentos específicos si también seleccionas métricas. Si no seleccionas ninguna métrica en tu consulta, la API de Merchant Reports muestra un error.

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

A continuación, se muestra una consulta de muestra que muestra 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 de 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"
      }
    }
  ]
}

Precaución: Dado que se muestra una fila nueva para cada combinación de campos de segmentos en tu cláusula SELECT, la cantidad total de filas en tu respuesta aumenta exponencialmente con cada campo de segmentos adicional.

Categoría y tipo de producto

El Lenguaje de consulta 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ías

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 bien que defina mejor la categoría proporcionada.

Niveles de tipo de producto

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

Los atributos de categoría y tipo de producto se organizan en una jerarquía con varios niveles. La especificación del producto separa cada nivel con el carácter >, pero debes seleccionar 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:

Segmentar	Valor
product_type_l1	Home & Garden
product_type_l2	Kitchen & Dining
product_type_l3	Kitchen Appliances
product_type_l4	Refrigerators

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 independiente. Por ejemplo, la siguiente consulta:

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

muestra los siguientes resultados:

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

Si solicitas métricas de precios y no de precios en una consulta, las métricas de precios se muestran en filas de resultados separadas de las métricas que no son 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'

muestra 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.