Segmentação

A segmentação, disponível nos relatórios personalizados do Merchant Center, pode ser implementada na API Reporting adicionando o campo apropriado a uma consulta. Por exemplo, a consulta de segments.program resulta em um relatório com uma linha para cada programa (anúncios do Shopping, listagens de produto sem custo financeiro etc.) que inclui as métricas (impressões, cliques etc.) desse programa, conforme especificado na cláusula SELECT.

Assim como nos relatórios personalizados do Merchant Center, é possível usar a API Reporting para especificar vários segmentos na mesma consulta.

O exemplo de consulta a seguir recupera os cliques de todos os produtos na sua conta durante um período de 30 dias, segmentados por program e offer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Executar

Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar em Executar, atualize o marcador do ID do comerciante para seu próprio ID no URL da solicitação. É possível modificar a consulta. A consulta completa precisa permanecer em uma linha para funcionar com o APIs Explorer.

O resultado do envio dessa consulta para reports.search é uma linha que especifica os cliques para cada combinação de offer_id e program, como nesta string JSON de exemplo:

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

Categoria e tipo de produto

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

Níveis de categoria (segments.category_l1, segments.category_l2 etc.)
Categorias da taxonomia de produtos do Google. O Google poderá atribuir automaticamente a categoria ao seu produto se nenhuma for informada, ou refinar ainda mais a categoria fornecida.
Níveis de tipo de produto (segments.product_type_l1, segments.product_type_l2 etc.)
Tipos de produto 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 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 retornarão cada nível em seu próprio campo, da seguinte maneira:

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 moeda e de preço

O campo segments.currency_code de um ReportRow indica a moeda em que métricas de preço, como metrics.conversion_value_micros, são retornadas. Como isso é importante para interpretar corretamente essas métricas, o ReportRow retornado vai incluir automaticamente segments.currency_code sempre que você selecionar uma das métricas de preço abaixo.

  • metrics.conversion_value_micros
  • metrics.aov_micros
  • metrics.ordered_item_sales_micros
  • metrics.returns_micros
  • metrics.shipped_item_sales_micros

Métricas do Comprar com o Google

A linguagem de consulta do Merchant Center aceita duas categorias de métricas para pedidos do Comprar com o Google: métricas no nível do item e no nível do pedido.

métricas no nível do item

Métricas calculadas com base nos itens dos pedidos e associadas às dimensões de produto dos itens em 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 no nível do pedido

Métricas calculadas por pedido.

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

As métricas no nível do pedido não são associadas às dimensões do produto dos itens em cada pedido.

É possível combinar métricas no nível do item com qualquer segmento disponível. No entanto, ocorrerá uma falha ao selecionar métricas no nível do pedido em combinação com qualquer um dos seguintes segmentos de dimensão do produto:

  • segments.brand
  • segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4, segments.category_l5
  • segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4, segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4, segments.product_type_l5
  • segments.title

Saiba mais

Para uma lista completa de segmentos, confira a documentação.

Anterior
Consultar as tendências de compras
Próxima
Paging