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 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 da 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 na URL da solicitação. Você pode modificar a consulta. A consulta completa precisa permanecer em uma linha para funcionar com o APIs 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"
      }
    }
  ]
}

Categoria e tipo de produto

A linguagem de consulta do Merchant Center oferece suporte à segmentação de métricas por dois grupos de atributos que podem ser definidos 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 fornecida.

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 no próprio campo, da seguinte maneira:

Métricas de moeda e preço

O campo segments.currency_code de uma 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, a ReportRow retornada 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 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 do 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, a seleção de métricas no nível do pedido em combinação com qualquer um dos segmentos de dimensão do produto a seguir 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 uma lista completa de segmentos, consulte a documentação.