L'API Merchant Reports vous permet d'afficher les données de performances, de filtrer vos produits selon des attributs spécifiques et d'améliorer vos prix.
Évaluer les performances
Vous pouvez utiliser l'API Merchant Reports ProductPerformanceView pour récupérer les métriques de performances de votre compte.
Conditions requises
Vous devez disposer du rôle Performances et insights pour récupérer ce rapport.
Pour attribuer le rôle Performances et insights à un compte, utilisez la méthode accounts.update de Content API for Shopping afin de définir le champ reportsManager sur true.
accounts.update remplace l'intégralité de la ressource Account. Utilisez accounts.get pour obtenir la ressource Account complète, puis fournissez tous les champs de votre requête accounts.update afin de ne pas perdre d'informations.
Exemple de requête
La requête suivante récupère les valeurs impressions, clicks et clickThroughRate pour tous les produits de votre compte sur une période spécifique 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, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Vous pouvez également segmenter les métriques dans la requête pour obtenir des rapports sur les performances plus précis.
Filtrer les produits
Vous pouvez utiliser la méthode ProductView 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 ProductView pour lister les 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 itemIssues. Vous pouvez trier la réponse en fonction de tous les champs disponibles, à l'exception des suivants:
gtinitemIssues
Voici un exemple de renvoi de 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,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = '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 ProductView.
Améliorer la tarification
La vue "Tendances des prix" vous permet d'afficher des suggestions de prix soldés pour vos produits et des prédictions sur les performances que vous pouvez potentiellement atteindre en modifiant les prix de vos produits. 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 PriceInsightsProductView afin d'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,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
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"
}
}
]
}