Segmentation

É possível usar campos de segmentos para segmentação em relatórios de desempenho. Por exemplo, consultar marketingMethod retorna um relatório com uma linha para cada método de marketing e as metrics especificadas para esse método na cláusula SELECT.

Assim como nos relatórios personalizados no Merchant Center, é possível especificar vários segmentos na mesma consulta com a API Merchant Reports.

Veja um exemplo de consulta que retorna os cliques de todos os produtos na sua conta durante um período de 30 dias, segmentados por marketingMethod e offerId:

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

A resposta dessa consulta inclui uma linha para cada combinação de offerId e marketingMethod, com o número de cliques para essa combinação:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Atenção :como uma nova linha é retornada para cada combinação de campos de segmentos na cláusula SELECT, o número total de linhas na resposta aumenta exponencialmente com cada campo de segmentos adicionais.

Categoria e tipo de produto

A Linguagem de consulta do Merchant Center é compatível com a segmentação de métricas por dois grupos de atributos que você pode definir para organizar seu inventário:

Níveis de categoria

Categorias da taxonomia do produto do Google. O Google pode atribuir automaticamente a categoria ao seu produto se nenhuma for fornecida ou refinar ainda mais a categoria fornecida.

Níveis de tipo de produto

Tipos de produtos que você atribui com base na sua categorização. Ao contrário dos níveis de categoria, não há um conjunto predefinido de valores compatíveis.

Os atributos de categoria e de tipo de produto são organizados em uma hierarquia com vários níveis. A especificação do produto separa cada nível com o caractere >, mas você seleciona cada nível da hierarquia separadamente nos relatórios.

Por exemplo, considere um produto com os seguintes níveis de tipo de produto:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Os relatórios retornam cada nível no próprio campo:

Segmento	Valor
product_type_l1	Home & Garden
product_type_l2	Kitchen & Dining
product_type_l3	Kitchen Appliances
product_type_l4	Refrigerators

Métricas de moeda e de preço

As métricas de preço, como conversionValue, são representadas pelo tipo Price. Se a métrica estiver disponível em várias moedas, o valor de cada moeda será retornado em uma linha separada. Por exemplo, a consulta a seguir:

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

retorna os seguintes resultados:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Se você solicitar métricas de preço e não relacionadas a preços em uma consulta, essas métricas serão retornadas em linhas de resultados separadas das outras, uma linha de resultado por código de moeda. Por exemplo, a consulta a seguir:

SELECT conversions, conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

retorna a seguinte resposta:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Todos os campos selecionados são retornados na resposta, mesmo que o valor deles ainda seja o valor padrão ou zero.