Evalúa tus productos

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"
      }
    }
  ]
}