Merchant Reports API를 사용하여 실적 데이터를 확인하고, 특정 속성별로 제품을 필터링하고, 가격을 개선할 수 있습니다.
성능 측정
Merchant Reports API product_performance_view를 사용하여 계정의 실적 측정항목을 가져올 수 있습니다.
요구사항
이 보고서를 가져오려면 실적 및 통계 역할이 필요합니다.
계정에 실적 및 통계 역할을 부여하려면 계정의 User 리소스를 PERFORMANCE_REPORTING 액세스 권한으로 패치합니다.
accounts.v1beta.accounts.users.patch는 전체 User 리소스를 대체합니다. 정보를 잃지 않으려면 accounts.v1beta.accounts.users.get를 호출하여 전체 User 리소스를 가져온 다음 accounts.v1beta.accounts.users.patch 요청에 모든 필드를 제공합니다.
샘플 쿼리
다음 쿼리는 특정 30일 동안 계정의 모든 제품에 대한 impressions, clicks, click_through_rate를 검색합니다. 요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
실적 보고서에 관한 자세한 내용은 실적 보고서 가이드를 참고하세요.
제품 필터링
Merchant Reports API의 product_view를 사용하여 제품 상태를 비롯하여 제품 데이터의 필터링된 보기를 표시할 수 있습니다. 예를 들어 product_view를 쿼리하여 문제가 있는 제품을 나열하거나 새 제품 목록을 가져와 게재를 확인할 수 있습니다.
쿼리의 SELECT 절에 id 필드를 포함해야 합니다. id는 제품의 REST ID와 동일한 값입니다.
item_issues를 제외한 모든 사용 가능한 필드를 기준으로 필터링할 수 있습니다. 다음을 제외한 사용 가능한 모든 필드를 기준으로 응답을 정렬할 수 있습니다.
gtinitem_issues
다음은 NOT_ELIGIBLE_OR_DISAPPROVED 상태로 제품을 반환하는 예입니다. 요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status
item_issues
FROM ProductView
WHERE aggregated_reporting_context_status = '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"
}
]
}
}
]
}
특정 필드 및 동작에 관한 자세한 내용은 product_view 참조를 확인하세요.
가격 책정 개선
가격 정보 보기를 사용하여 제품의 추천 할인가와 제품 가격을 업데이트할 때 예상되는 실적 예측을 확인할 수 있습니다. 가격 정보 보고서를 사용하면 제품의 가격을 더욱 효과적으로 책정할 수 있습니다.
자세한 내용은 가격 정보 보고서로 제품 가격 책정 개선을 참고하세요.
price_insights_product_view를 쿼리하여 제품의 추천 할인가를 확인하세요.
다음은 제품의 추천 할인가를 확인하는 데 사용할 수 있는 샘플입니다. 요청하려면 다음 Merchant Center 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversion_change_fraction
FROM price_insights_product_view
다음은 위 쿼리의 샘플 응답입니다.
{
"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"
}
}
]
}