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