Puedes usar esta API para ver los datos de rendimiento, filtrar tus productos por atributos específicos y mejorar los precios.
Cómo medir el rendimiento
Puedes usar la API de informes de Merchant ProductPerformanceView
para recuperar métricas de rendimiento de tu cuenta.
Requisitos
Para recuperar este informe, necesitas la función Rendimiento y estadísticas.
Para asignar el rol Rendimiento y estadísticas a una cuenta, usa el método accounts.update
de Content API for Shopping para establecer el campo reportsManager
en true
.
accounts.update
reemplaza todo el recurso Account
. Usa accounts.get
para obtener el recurso Account
completo y, luego, proporciona todos los campos de la solicitud accounts.update
para no perder información.
Consulta de muestra
La siguiente consulta recupera el valor de impressions
, clicks
y clickThroughRate
de todos los productos de tu cuenta durante un período específico de 30 días. Para realizar la solicitud, pasa la siguiente declaración del lenguaje de consulta de Merchant Center al método accounts.reports.search
:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
También puedes segmentar las métricas en la consulta para obtener informes de rendimiento más detallados.
Filtrar productos
Puedes usar ProductView
de la API de informes del comercio para mostrar una vista filtrada de tus datos de productos, incluidos los estados de los productos. Por ejemplo, puedes consultar ProductView
para enumerar los productos que tienen problemas o para obtener una lista de tus productos nuevos y verificar la entrega.
Debes incluir el campo id
en la cláusula SELECT
de tu consulta. El id
tiene el mismo valor que el ID de REST del producto.
Puedes filtrar según todos los campos disponibles, excepto itemIssues
. Puedes ordenar la respuesta según todos los campos disponibles, excepto los siguientes:
gtin
itemIssues
El siguiente es un ejemplo en el que se muestran tus productos con el estado NOT_ELIGIBLE_OR_DISAPPROVED
. Para realizar la solicitud, pasa la siguiente declaración del lenguaje de consulta de Merchant Center al método accounts.reports.search
:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
A continuación, se muestra una respuesta de muestra de la consulta anterior:
{
"results": [
{
"productView": {
"id": "online~en~US~id0"
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
"itemIssues": [
{
"type": {
"code": "invalid_string_value",
"canonicalAttribute": "n:product_code"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DISAPPROVED"
},
"resolution": "MERCHANT_ACTION"
},
{
"type": {
"code": "apparel_missing_brand",
"canonicalAttribute": "n:brand"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DEMOTED"
},
"resolution": "MERCHANT_ACTION"
}
]
}
}
]
}
Consulta la referencia de ProductView
para obtener más información sobre campos y comportamientos específicos.
Mejorar los precios
Puedes usar la vista de información sobre precios para ver los precios de oferta sugeridos para tus productos y predicciones del rendimiento que puedes esperar si actualizas los precios de tus productos. Puedes usar este informe para definir los precios de tus productos de manera más eficaz.
Consulta Cómo mejorar los precios de los productos con el informe de estadísticas de precios para obtener más información.
Consulta PriceInsightsProductView
a fin de ver los precios de oferta sugeridos para tus productos.
A continuación, se incluye un ejemplo que puedes usar para ver los precios de oferta sugeridos para tus productos. Para realizar la solicitud, pasa la siguiente declaración del lenguaje de consulta de Merchant Center al método accounts.reports.search
:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
A continuación, se muestra una respuesta de muestra de la consulta anterior:
{
"results": [
{
"priceInsightsProductView": {
"id": "online~en~US~12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"price" {
"amountMicros": "124990000",
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "135680000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"price" {
"amountMicros": "119990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "125440000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"price" {
"amountMicros": "84990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "82000000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}