판매자 보고서 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를 제외하고 사용 가능한 모든 필드를 기준으로 필터링할 수 있습니다. 다음을 제외하고 사용 가능한 모든 필드를 기준으로 응답을 정렬할 수 있습니다.
gtinitemIssues
다음은 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"
}
}
]
}