Segmentación

La segmentación, disponible en los informes personalizados de Merchant Center, se puede implementar en la API de Informes agregando el campo adecuado a una consulta. Por ejemplo, si consultas segments.program, obtendrás un informe con una fila para cada programa (anuncios de Shopping, fichas de productos gratuitas, etcétera) que incluye las métricas (impresiones, clics, etcétera) de ese programa, tal como se especifica en la cláusula SELECT.

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

La siguiente consulta de ejemplo recupera los clics de todos los productos de tu cuenta durante un período de 30 días, segmentados por program y offer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Ejecutar

Haz clic en Ejecutar para probar la muestra en el Explorador de APIs. Después de hacer clic en Ejecutar, actualiza el marcador de posición del ID de comerciante con tu propio ID en la URL de la solicitud. Puedes modificar la búsqueda. La consulta completa debe permanecer en una sola línea para que funcione con el Explorador de APIs.

Los resultados de enviar esta consulta a reports.search son una fila que especifica los clics para cada combinación de offer_id y program, como en esta cadena JSON de ejemplo:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

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 (segments.category_l1, segments.category_l2, etcétera)

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 bien refinar aún más la categoría proporcionada.

Niveles de tipo de producto (segments.product_type_l1, segments.product_type_l2, etcétera)

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 de productos 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 mostrarán cada nivel en su propio campo, de la siguiente manera:

Métricas de precios y monedas

El campo segments.currency_code de un objeto ReportRow indica la moneda en la que se devuelven las métricas de precios, como metrics.conversion_value_micros. Dado que esto es importante para interpretar correctamente estas métricas, el objeto ReportRow devuelto incluirá automáticamente segments.currency_code cuando selecciones una de las métricas de precios que se indican a continuación.

• metrics.conversion_value_micros

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

Métricas de Comprar con Google

El lenguaje de consultas de Merchant Center admite dos categorías de métricas para los pedidos de Comprar con Google: métricas a nivel del artículo y métricas a nivel del pedido.

Métricas a nivel del artículo

Son métricas que se calculan en función de los artículos incluidos en los pedidos y que se asocian con las dimensiones del producto de los artículos en cada pedido.

• metrics.item_days_to_ship
• metrics.item_fill_rate
• metrics.ordered_items
• metrics.ordered_item_sales_micros
• metrics.rejected_items
• metrics.returned_items
• metrics.return_rate
• metrics.returns_micros
• metrics.shipped_items
• metrics.shipped_item_sales_micros
• metrics.unshipped_items

Métricas a nivel del pedido

Las métricas se calculan por pedido.

• metrics.aos
• metrics.aov_micros
• metrics.days_to_ship
• metrics.orders
• metrics.shipped_orders
• metrics.unshipped_orders

Las métricas a nivel del pedido no se asocian con las dimensiones del producto de los artículos en cada pedido.

Puedes seleccionar métricas a nivel del artículo en combinación con cualquier segmento disponible. Sin embargo, si seleccionas métricas a nivel del pedido en combinación con cualquiera de los siguientes segmentos de dimensiones del producto, se producirá un error:

• segments.brand
• segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4 y segments.category_l5
• segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4 y segments.custom_label5
• segments.offer_id
• segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4 y segments.product_type_l5
• segments.title

Más información

Para obtener una lista completa de los segmentos, consulta la documentación.