Vous pouvez utiliser l'API Merchant Reports pour afficher les données de performances, filtrer vos produits en fonction d'attributs spécifiques et améliorer vos prix.
Évaluer les performances
Vous pouvez utiliser l'API Merchant Reports product_performance_view pour récupérer les métriques sur les performances de votre compte.
Conditions requises
Vous devez disposer du rôle "Performances et insights" pour récupérer ce rapport.
Pour attribuer à un compte le rôle "Performances et insights", corrigez la ressource User du compte avec le droit d'accès PERFORMANCE_REPORTING.
accounts.v1beta.accounts.users.patch remplace l'intégralité de la ressource User. Pour éviter de perdre des informations, appelez accounts.v1beta.accounts.users.get pour obtenir la ressource User complète, puis fournissez tous les champs de votre requête accounts.v1beta.accounts.users.patch.
Exemple de requête
La requête suivante récupère les impressions, les clicks et le click_through_rate pour tous les produits de votre compte sur une période donnée de 30 jours. Pour envoyer la requête, transmettez cette instruction de langage de requête Merchant Center à la méthode accounts.reports.search:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Pour en savoir plus sur les rapports sur les performances, consultez le guide Rapports sur les performances.
Filtrer les produits
Vous pouvez utiliser product_view de l'API Merchant Reports pour afficher une vue filtrée de vos données produit, y compris les états des produits. Par exemple, vous pouvez interroger product_view pour obtenir la liste des produits présentant des problèmes, ou pour obtenir la liste de vos nouveaux produits et vérifier leur diffusion.
Vous devez inclure le champ id dans la clause SELECT de votre requête. id a la même valeur que l'identifiant REST du produit.
Vous pouvez filtrer tous les champs disponibles, à l'exception de item_issues. Vous pouvez trier la réponse en fonction de tous les champs disponibles, à l'exception des suivants:
gtinitem_issues
Voici un exemple qui renvoie vos produits avec l'état NOT_ELIGIBLE_OR_DISAPPROVED. Pour envoyer la requête, transmettez cette instruction de langage de requête Merchant Center à la méthode 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'
Voici un exemple de réponse à la requête précédente:
{
"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"
}
]
}
}
]
}
Pour en savoir plus sur les différents champs et comportements, consultez la documentation de référence sur product_view.
Améliorer la tarification
Vous pouvez utiliser la vue "Tendances des prix" afin d'afficher des suggestions de prix soldés pour vos produits ainsi qu'une estimation des performances que vous pouvez potentiellement atteindre en modifiant les prix de vos articles. Ce rapport peut vous aider à fixer le prix de vos produits plus efficacement.
Pour en savoir plus, consultez Améliorer la tarification de vos produits à l'aide du rapport "Tendances des prix".
Interrogez price_insights_product_view pour afficher des suggestions de prix soldés pour vos produits.
Voici un exemple permettant d'afficher des suggestions de prix soldés pour vos produits. Pour envoyer la requête, transmettez cette instruction de langage de requête Merchant Center à la méthode 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
Voici un exemple de réponse à la requête précédente:
{
"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"
}
}
]
}