Merchant Reports API を使用すると、パフォーマンス データの表示、特定の属性による商品のフィルタリング、価格の改善を行うことができます。
パフォーマンスの測定
Merchant Reports API ProductPerformanceView
を使用すると、アカウントのパフォーマンス指標を取得できます。
要件
このレポートを取得するには、パフォーマンスと分析情報のロールが必要です。
アカウントにパフォーマンスと分析情報のロールを付与するには、Content API for Shopping の accounts.update
メソッドを使用して reportsManager
フィールドを true
に設定します。
accounts.update
は、Account
リソース全体を置き換えます。accounts.get
を使用して Account
リソース全体を取得し、情報が失われないように accounts.update
リクエストにすべてのフィールドを指定します。
クエリの例
次のクエリは、特定の 30 日間のアカウント内のすべての商品の impressions
、clicks
、clickThroughRate
を取得します。リクエストを行うには、次の Merchant Center のクエリ言語ステートメントを accounts.reports.search
メソッドに渡します。
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
クエリの指標を分割して、より詳細なパフォーマンス レポートを作成することもできます。
プロダクトのフィルタ
Merchant Reports API の ProductView
を使用すると、商品のステータスなど、商品データをフィルタして表示できます。たとえば、ProductView
をクエリして、問題のある商品のリストを取得したり、新しい商品のリストを取得して配信を確認したりできます。
クエリの SELECT
句に id
フィールドを含める必要があります。id
の値は、商品の REST ID と同じです。
itemIssues
を除くすべての使用可能なフィールドに基づいてフィルタリングできます。以下を除くすべての使用可能なフィールドに基づいてレスポンスを並べ替えることができます。
gtin
itemIssues
ステータス NOT_ELIGIBLE_OR_DISAPPROVED
の商品を返す例を次に示します。リクエストを行うには、次の Merchant Center のクエリ言語ステートメントを 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
をクエリします。
商品の提案セール価格を表示するために使用できるサンプルを次に示します。リクエストを行うには、次の Merchant Center のクエリ言語ステートメントを 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"
}
}
]
}