Segmentação

Segmentação, disponível no Merchant Center Relatórios personalizados, podem ser implementados na API de relatórios adicionando o campo apropriado a uma consulta. Para exemplo, consultar por segments.program resulta em um relatório com uma linha para cada (anúncios do Shopping, listagens de produtos sem custo financeiro etc.) que inclua as métricas (impressões, cliques etc.) para esse programa, conforme especificado nos SELECT .

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

O exemplo de consulta a seguir recupera os cliques de todos os produtos na sua conta durante um período de 30 dias, segmentado 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 Executar, atualize o marcador de posição para o ID do comerciante na URL de solicitação. É possível modificar a consulta. A consulta completa deve permanecer em uma linha para trabalhar com o APIs Explorer.

O resultado do envio dessa consulta para reports.search é uma linha especificando a cliques para cada combinação de offer_id e program, como neste exemplo String JSON:

{
  "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 permite a 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 de Taxonomia do produto do Google. o Google poderá 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 produto que atribuídos 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 A especificação do produto separa os 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 no quais métricas de preço, como metrics.conversion_value_micros, são retornadas. Como isso é importante para interpretar corretamente essas métricas, o retornado de ReportRow 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 é compatível com duas categorias de métricas em "Comprar com" Pedidos do 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 aos as 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 combinar métricas no nível do item com qualquer segmento disponível. Entretanto, selecionar métricas no nível do pedido em combinação com qualquer um dos seguintes os segmentos de dimensão do produto vão 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, confira a documentação.

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