Segmentação

A segmentação, disponível nos relatórios personalizados do Merchant Center, pode ser implementada na API Reporting adicionando o campo adequado a uma consulta. Por exemplo, uma consulta de segments.program resulta em um relatório com uma linha para cada programa (anúncios do Shopping, listagens sem custo financeiro de produtos 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 especificar vários segmentos na mesma consulta com a API Reporting.

A consulta de exemplo 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 a amostra no APIs Explorer. Depois de clicar em Executar, atualize o marcador de posição do ID do comerciante para seu próprio ID no URL da solicitação. Você pode modificar a consulta. A consulta completa precisa ficar em uma linha para funcionar com o API Explorer.

Os resultados do envio dessa consulta para reports.search são 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"
      }
    }
  ]
}

Atenção: o número de linhas pode aumentar exponencialmente para cada campo de segmento adicional incluído na consulta do relatório.

Categoria e tipo de produto

A linguagem de consulta do Merchant Center permite segmentar métricas por 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 pode atribuir automaticamente a categoria ao seu produto se nenhuma for fornecida ou refinar ainda mais a categoria informada.

Níveis de tipo de produto (segments.product_type_l1, segments.product_type_l2 etc.)

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 aceitos.

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 vão retornar cada nível em um campo próprio, da seguinte forma:

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 preço

O campo segments.currency_code de um ReportRow indica a moeda em que as 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

Descontinuado: os campos a seguir não são mais aceitos.

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

Observação: talvez seja interessante incluir explicitamente segments.currency_code na consulta para ter mais clareza e consistência entre a cláusula SELECT e cada ReportRow na resposta.

Métricas do Comprar com o Google

Descontinuado: as métricas do Comprar com o Google não são mais compatíveis, e a recuperação delas retorna 0 a partir de maio de 2024 (incluindo valores históricos de datas anteriores).

A linguagem de consulta do Merchant Center oferece suporte a duas categorias de métricas para pedidos do Comprar com o Google: métricas no nível do item e métricas 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 estão associadas às dimensões do produto dos itens em cada pedido.

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

• 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 conferir uma lista completa de segmentos, consulte a documentação.