É possível usar campos
de segmentos para
segmentação em relatórios de
desempenho.
Por exemplo, consultar marketingMethod
retorna um relatório com uma linha para cada método de marketing e as metrics especificadas para esse método 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 Merchant Reports.
Veja um exemplo de consulta que retorna os cliques de todos os produtos na sua conta durante um período de 30 dias, segmentados por marketingMethod
e offerId
:
SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'
A resposta dessa consulta inclui uma linha para cada combinação de offerId
e marketingMethod
, com o número de cliques para essa combinação:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"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
- Categorias da taxonomia do produto 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
- 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 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:
Segmento | Valor |
---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Métricas de moeda e de preço
As métricas de preço, como conversionValue
, são representadas pelo
tipo
Price
. Se a métrica estiver disponível em várias moedas, o valor de cada moeda será retornado em uma linha separada. Por exemplo, a consulta a seguir:
SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'
retorna os seguintes resultados:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Se você solicitar métricas de preço e não relacionadas a preços em uma consulta, essas métricas serão retornadas em linhas de resultados separadas das outras, uma linha de resultado por código de moeda. Por exemplo, a consulta a seguir:
SELECT conversions, conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'
retorna a seguinte resposta:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Todos os campos selecionados são retornados na resposta, mesmo que o valor deles ainda seja o valor padrão ou zero.