Avalie seus produtos

É possível usar essa API para acessar dados de performance, filtrar seus produtos por atributos específicos e melhorar os preços.

Medir o desempenho

Use a API Merchant Reports ProductPerformanceView para recuperar as métricas de performance da sua conta.

Requisitos

Você precisa ter o papel de desempenho e insights para recuperar esse relatório.

Para atribuir o papel de performance e insights a uma conta, use o método accounts.update da API Content for Shopping para definir o campo reportsManager como true.

accounts.update substitui todo o recurso Account. Use accounts.get para acessar o recurso Account completo e forneça todos os campos na solicitação accounts.update para não perder informações.

Exemplo de consulta

A consulta a seguir recupera o impressions, clicks e clickThroughRate de todos os produtos na sua conta durante um período específico de 30 dias. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta do Merchant Center para o método accounts.reports.search:

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Também é possível segmentar as métricas na consulta para receber relatórios de desempenho mais granulares.

Filtrar produtos

Use o ProductView da API Merchant Reports para mostrar uma visualização filtrada dos dados do produto, incluindo os status dos itens. Por exemplo, é possível consultar ProductView para listar os produtos com problemas ou para receber uma lista dos novos produtos e verificar a veiculação.

Inclua o campo id na cláusula SELECT da sua consulta. O id tem o mesmo valor que o ID REST do produto.

É possível filtrar com base em todos os campos disponíveis, exceto itemIssues. É possível classificar a resposta com base em todos os campos disponíveis, exceto o seguinte:

• gtin
• itemIssues

Confira um exemplo que retorna seus produtos com o status NOT_ELIGIBLE_OR_DISAPPROVED. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta do Merchant Center ao método accounts.reports.search:

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Este é um exemplo de resposta da 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"
          }
        ]
      }
    }
  ]
}

Consulte a referência ProductView para mais informações sobre campos e comportamentos específicos.

Melhorar os preços

Use a visualização de informações de preço para conferir sugestões de preços promocionais para seus produtos e as previsões de desempenho esperadas se você atualizar os preços. Ele ajuda você a definir os preços dos produtos com mais eficiência.

Consulte Melhorar o preço dos produtos com o relatório de informações de preço para mais informações.

Consulte PriceInsightsProductView para conferir os preços promocionais sugeridos para seus produtos.

Use este exemplo para conferir os preços promocionais sugeridos para seus produtos. Para fazer a solicitação, transmita a seguinte instrução de linguagem de consulta do Merchant Center para o método accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

Este é um exemplo de resposta da 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"
      }
    }
  ]
}