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 produtos 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 no 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, 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'
Clique em Executar para testar o exemplo na API Explorer. Depois de clicar em Executar, atualize o marcador para seu próprio ID do comerciante no URL da solicitação. É possível modificar a consulta. A consulta completa precisa permanecer em uma linha para trabalhar com o API 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 neste exemplo de 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 é 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 (
segments.category_l1
,segments.category_l2
etc.) - Categorias da taxonomia do produto do Google. Se nenhuma categoria tiver sido fornecida, o Google poderá atribuir automaticamente a categoria ao seu produto 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 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, 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 preço
O campo segments.currency_code
de um ReportRow
indica a moeda em
que as métricas de preço, como metrics.order_item_sales_micros
, são retornadas.
Como isso é importante para interpretar corretamente essas métricas, o
ReportRow
retornado incluirá automaticamente segments.currency_code
sempre que você selecionar uma das métricas de preço abaixo.
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 de pedidos no Comprar com o Google: no nível do item e 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 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 uma lista completa dos segmentos, consulte a documentação.