É possível usar essa API para acessar dados de performance, filtrar seus produtos por atributos específicos e melhorar os preços.
Medir o desempenho
Use a API Merchant Reports
ProductPerformanceView
para recuperar as métricas de
performance da sua conta.
Requisitos
Você precisa ter o papel de desempenho e insights para recuperar esse relatório.
Para atribuir o papel de performance e insights a uma conta, use o método accounts.update
da API Content for
Shopping para definir o campo reportsManager
como true
.
accounts.update
substitui todo o recurso Account
. Use
accounts.get
para acessar o
recurso Account
completo e forneça todos os campos na solicitação accounts.update
para não perder informações.
Exemplo de consulta
A consulta a seguir recupera o impressions
, clicks
e clickThroughRate
de todos os produtos na sua conta durante um período específico de 30 dias. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta
do Merchant Center para o
método
accounts.reports.search
:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Também é possível segmentar as métricas na consulta para receber relatórios de desempenho mais granulares.
Filtrar produtos
Use o ProductView
da API Merchant Reports para mostrar uma visualização filtrada dos dados do produto, incluindo os status dos itens. Por
exemplo, é possível consultar ProductView
para listar os produtos com problemas ou para
receber uma lista dos novos produtos e verificar a veiculação.
Inclua o campo id
na cláusula SELECT
da sua consulta. O id
tem o mesmo valor que o ID REST do produto.
É possível filtrar com base em todos os campos
disponíveis,
exceto itemIssues
. É possível classificar a resposta com base em todos os campos disponíveis, exceto o seguinte:
gtin
itemIssues
Confira um exemplo que retorna seus produtos com o status
NOT_ELIGIBLE_OR_DISAPPROVED
. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta
do Merchant Center ao
método
accounts.reports.search
:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Este é um exemplo de resposta da consulta anterior:
{
"results": [
{
"productView": {
"id": "online~en~US~id0"
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
"itemIssues": [
{
"type": {
"code": "invalid_string_value",
"canonicalAttribute": "n:product_code"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DISAPPROVED"
},
"resolution": "MERCHANT_ACTION"
},
{
"type": {
"code": "apparel_missing_brand",
"canonicalAttribute": "n:brand"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DEMOTED"
},
"resolution": "MERCHANT_ACTION"
}
]
}
}
]
}
Consulte a referência ProductView
para mais informações sobre campos e comportamentos específicos.
Melhorar os preços
Use a visualização de informações de preço para conferir sugestões de preços promocionais para seus produtos e as previsões de desempenho esperadas se você atualizar os preços. Ele ajuda você a definir os preços dos produtos com mais eficiência.
Consulte Melhorar o preço dos produtos com o relatório de informações de preço para mais informações.
Consulte
PriceInsightsProductView
para conferir os preços promocionais sugeridos para seus produtos.
Use este exemplo para conferir os preços promocionais sugeridos para seus produtos. Para fazer a solicitação, transmita a seguinte instrução de linguagem de consulta do Merchant Center para o método accounts.reports.search
:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
Este é um exemplo de resposta da consulta anterior:
{
"results": [
{
"priceInsightsProductView": {
"id": "online~en~US~12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"price" {
"amountMicros": "124990000",
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "135680000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"price" {
"amountMicros": "119990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "125440000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"price" {
"amountMicros": "84990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "82000000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}