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 Reports sobre los datos de rendimiento.

Esta es 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": "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 campos de segmentos para la segmentación en los informes de rendimiento. Por ejemplo, si consultas marketing_method, se devolverá 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 del producto (por ejemplo, offer_id, brand y category) o atributos del evento (por ejemplo, date y marketing_method).

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

Esta es 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 devolvió 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 devolverá un error.

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 un ejemplo de una consulta 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 búsqueda 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"
      }
    }
  ]
}

Precaución: Dado que se devuelve 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 de forma exponencial con cada campo de segmentos adicional.

Categoría y tipo de producto

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

Niveles de categorías

Son las categorías de la taxonomía de productos de Google. Google podría asignar automáticamente la categoría a tu producto si no se proporcionó ninguna o refinar aún más la categoría proporcionada.

Niveles de tipo de producto

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.

Tanto los atributos de categoría como los de 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 tú 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 devuelven 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 precios y monedas

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

devuelve 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 devolverá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.