판매자 보고서 API를 사용하여 성능 데이터를 확인하고, 특정 속성별로 제품을 필터링하고, 가격을 개선할 수 있습니다.
성능 측정
판매자 보고서 API ProductPerformanceView
를 사용하여 계정의 실적 측정항목을 검색할 수 있습니다.
요구사항
이 보고서를 검색하려면 성능 및 통계 역할이 필요합니다.
계정에 실적 및 통계 역할을 부여하려면 Content API for Shopping의 accounts.update
메서드를 사용하여 reportsManager
필드를 true
로 설정합니다.
accounts.update
는 전체 Account
리소스를 대체합니다. accounts.get
를 사용하여 전체 Account
리소스를 가져온 다음 정보가 손실되지 않도록 accounts.update
요청에 모든 필드를 제공합니다.
샘플 쿼리
다음 쿼리는 특정 30일 동안 계정의 모든 제품에 대한 impressions
, clicks
, clickThroughRate
를 검색합니다. 요청을 수행하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search
메서드에 전달합니다.
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
쿼리의 측정항목을 분류하여 보다 상세한 실적 보고서를 만들 수도 있습니다.
제품 필터링
판매자 보고서 API의 ProductView
를 사용하여 제품 상태를 포함하여 제품 데이터의 필터링된 뷰를 표시할 수 있습니다. 예를 들어 ProductView
를 쿼리하여 문제가 있는 제품을 나열하거나 새 제품 목록을 가져와 게재를 확인할 수 있습니다.
쿼리의 SELECT
절에 id
필드를 포함해야 합니다. id
는 제품의 REST ID와 값이 동일합니다.
itemIssues
를 제외하고 사용 가능한 모든 필드를 기준으로 필터링할 수 있습니다. 다음을 제외하고 사용 가능한 모든 필드를 기준으로 응답을 정렬할 수 있습니다.
gtin
itemIssues
다음은 NOT_ELIGIBLE_OR_DISAPPROVED
상태의 제품을 반환하는 예입니다. 요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search
메서드에 전달합니다.
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
다음은 이전 쿼리의 샘플 응답입니다.
{
"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"
}
]
}
}
]
}
특정 필드 및 동작에 대한 자세한 내용은 ProductView
참조를 확인하세요.
가격 책정 개선
가격 통계 뷰를 사용하여 제품의 추천 할인가와 제품 가격을 업데이트할 경우 예상되는 성능 예측을 확인할 수 있습니다. 가격 정보 보고서를 사용하면 제품의 가격을 더욱 효과적으로 책정할 수 있습니다.
자세한 내용은 가격 정보 보고서로 제품 가격 책정 개선을 참고하세요.
PriceInsightsProductView
에 쿼리하여 제품의 추천 할인가를 확인합니다.
다음은 제품의 추천 할인가를 확인하는 데 사용할 수 있는 샘플입니다. 요청을 수행하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search
메서드에 전달합니다.
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
다음은 이전 쿼리의 샘플 응답입니다.
{
"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"
}
}
]
}