La segmentación, disponible en los informes personalizados de Merchant Center, se puede implementar en la API de Reporting si agregas el campo apropiado a una consulta. Por ejemplo, la consulta de segments.program
genera un informe con una fila para cada programa (anuncios de Shopping, fichas de productos gratuitas, etc.) que incluye las métricas (impresiones, clics, etc.) de ese programa, como se especifica en la cláusula SELECT
.
Al igual que con los informes personalizados de Merchant Center, puedes especificar varios segmentos en la misma consulta con la API de Reporting.
La siguiente consulta de muestra 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'
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 a tu propio ID de comerciante en la URL de la solicitud. Puedes modificar la consulta. La consulta completa debe permanecer en una línea para funcionar con el Explorador de API.
El resultado de enviar esta consulta a reports.search
es una fila que especifica los clics para cada combinación de offer_id
y program
, como en esta string JSON de muestra:
{
"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 consulta de Merchant Center admite la segmentación de métricas en función de dos grupos de atributos que puedes definir para organizar tu inventario:
- Niveles de categoría (
segments.category_l1
,segments.category_l2
, etcétera) - Categorías de la taxonomía de productos de Google. Google puede asignar automáticamente la categoría a tu producto, si no se proporcionó ninguna, o definir mejor la categoría proporcionada.
- Niveles de tipo de producto (
segments.product_type_l1
,segments.product_type_l2
, etcétera) - 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 de tipo de producto se organizan en una jerarquía con varios niveles. En las especificaciones del producto, se separa cada nivel con el carácter >
, pero debes seleccionar cada nivel de 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:
Segmento | Valor |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
Métricas de moneda y precio
El campo segments.currency_code
de una ReportRow
indica la moneda en la que se muestran las métricas de precios, como metrics.conversion_value_micros
.
Dado que esto es importante para interpretar correctamente estas métricas, la ReportRow
que se muestra incluirá automáticamente segments.currency_code
cada vez que selecciones una de las siguientes métricas de precios.
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 consulta 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
Las métricas se calculan a partir de los artículos dentro de los pedidos y se asocian con las dimensiones del producto de los artículos de 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 de 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 de pedido no están asociadas con las dimensiones del producto de los artículos de cada pedido.
Puedes seleccionar métricas a nivel del artículo en combinación con cualquier segmento disponible. Sin embargo, la selección de métricas a nivel de pedido en combinación con cualquiera de los siguientes segmentos de dimensiones del producto fallará:
segments.brand
segments.category_l1
,segments.category_l2
,segments.category_l3
,segments.category_l4
ysegments.category_l5
segments.custom_label1
,segments.custom_label2
,segments.custom_label3
,segments.custom_label4
ysegments.custom_label5
segments.offer_id
segments.product_type_l1
,segments.product_type_l2
,segments.product_type_l3
,segments.product_type_l4
ysegments.product_type_l5
segments.title
Más información
Para obtener una lista completa de los segmentos, consulta la documentación.