View a markdown version of this page

Données disponibles via l'API Amazon Selling Partner - AWS Conseils prescriptifs
API de rapportsAPI de kiosque de données

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Données disponibles via l'API Amazon Selling Partner

L'API Amazon Selling Partner (SP-API) est une API basée sur REST qui aide les vendeurs et les fournisseurs Amazon à accéder par programmation à leurs données sur les commandes, les expéditions, les paiements, etc. Les données de cette API peuvent augmenter l'efficacité des ventes, réduire les besoins en main-d'œuvre et améliorer le temps de réponse aux clients. Ce guide se concentre sur les données auxquelles vous pouvez accéder via l'API Selling Partner pour les rapports (API Reports) et l'API Selling Partner pour Data Kiosk (API Data Kiosk).

API de rapports

Les données de l'API Reports sont conçues pour vous aider à gérer votre activité sur Amazon Marketplace. Les rapports d'analyse fournissent des informations précieuses sur vos produits, vos clients et vos performances globales, telles que :

  • Performance des ventes — L'analyse des données de vente peut vous aider à identifier les tendances et les habitudes d'achat des clients. Vous pouvez utiliser ces informations pour optimiser votre stratégie de vente.

  • Performance du produit — L'analyse des données relatives aux produits peut vous aider à identifier les produits qui se vendent bien et ceux qui ne le sont pas. Vous pouvez utiliser ces informations pour optimiser vos offres de produits.

  • Comportement des clients — L'analyse des données clients peut vous aider à comprendre les préférences et les besoins de vos clients. Vous pouvez utiliser ces informations pour personnaliser vos stratégies de marketing et de vente.

Le tableau suivant décrit chaque rapport d'analyse de marque. Les rapports suivants sont disponibles pour les vendeurs et fournisseurs Amazon dotés du rôle d'API de partenaire de vente de Brand Analytics et enregistrés dans le registre des marques auprès d'Amazon.

Rapport Description Parameters
Rapport d'analyse du panier de marché Fournit des données sur les articles les plus couramment achetés en combinaison avec les articles du panier du client (panier) au moment du paiement Le rapport peut être demandé pour différentes périodes de référence (DAYWEEK,MONTH, ouQUARTER). Les données sont fournies au cours de ces périodes.
Rapport sur les termes de recherche Amazon Contient des données sur les numéros d'identification standard Amazon les plus fréquemment sélectionnés (ASINs), par mot clé de recherche et par département pour un site de vente Le rapport peut être demandé pour différentes périodes de référence (DAYWEEK,MONTH, ouQUARTER). Les demandes ne peuvent pas couvrir plusieurs périodes de rapport.
Rapport sur les achats répétés Contient des données sur le nombre d'achats répétés d'articles du partenaire commercial Le rapport peut être demandé pour différentes périodes de référence (WEEK,MONTH, ouQUARTER). Les données peuvent couvrir plusieurs périodes de référence.

Le tableau suivant décrit l'analyse de la vente au détail de chaque fournisseur et chaque rapport d'analyse de la vente au détail du vendeur.

Rapport Description Disponibilité Parameters
Rapport d'inventaire de Rapid Retail Analytics Contient des données d'inventaire au niveau de l'ASIN, agrégées selon une granularité horaire Vendors Le rapport peut uniquement être demandé. Les données peuvent couvrir plusieurs plages de dates, y compris le jour en cours.
Rapport de trafic de Rapid Retail Analytics Contient des données sur le trafic des clients vers les pages détaillées des articles du fournisseur, avec une granularité horaire Vendors Le rapport peut uniquement être demandé. Les données peuvent couvrir plusieurs plages de dates.
Rapport des ventes de Rapid Retail Analytics Contient des données de vente au niveau de l'ASIN, agrégées selon une granularité horaire Vendors Le rapport peut uniquement être demandé. Les données peuvent couvrir plusieurs plages de dates.
Rapport sur les ventes des fournisseurs Contient les indicateurs clés des ventes au détail (tels que le chiffre d'affaires et les unités commandées et expédiées), présentés au niveau du catalogue et au niveau de l'ASIN Vendors

Le rapport peut être demandé pour différents :

  • Périodes de référence (DAYWEEK,MONTH,QUARTER, ouYEAR)

  • Vues des distributeurs (MANUFACTURINGouSOURCING)

  • Programmes de vente (RETAILBUSINESS, ouFRESH)
Rapport sur la marge nette du produit pur Contient des données sur les marges pures nettes d'Amazon sur les produits vendus par un fournisseur, indiquées au niveau du catalogue et au niveau de l'ASIN Vendors Le rapport peut être demandé pour différentes périodes de référence (DAYWEEK,MONTH,QUARTER, ouYEAR).
Rapport sur le trafic des fournisseurs Contient des indicateurs clés du trafic de détail, tels que les vues en un coup d'œil, indiqués au niveau du catalogue et au niveau de l'ASIN Vendors Le rapport peut être demandé pour différentes périodes de référence (DAYWEEK,MONTH,QUARTER, ouYEAR).
Rapport de prévision des fournisseurs Contient les prévisions de la demande hebdomadaire moyenne, antérieures à 70, 80 et 90 années précédentes, rapportées au niveau de l'ASIN pour la date de génération des prévisions hebdomadaires les plus récentes Vendors Le rapport peut être demandé pour différents programmes de vente (RETAILouFRESH).
Rapport d'inventaire des fournisseurs Contient des indicateurs d'inventaire et de santé opérationnelle (tels que les unités en stock vendables et le taux de confirmation des fournisseurs), indiqués au niveau du catalogue et au niveau de l'ASIN Vendors

Le rapport peut être demandé pour différents :

  • Périodes de référence (DAYWEEK,MONTH,QUARTER, ouYEAR)

  • Vues des distributeurs (MANUFACTURINGouSOURCING)

  • Programmes de vente (RETAILouFRESH)
Rapport commercial sur les ventes et le trafic Contient des indicateurs clés de performance des ventes (tels que les ventes de produits commandés, le chiffre d'affaires, les unités commandées et le montant des réclamations) et des indicateurs de trafic de pages (tels que les pages vues et le pourcentage de boîtes d'achat) pour l'ensemble du catalogue du vendeur, agrégés par date et ASIN Vendeurs Le rapport peut être demandé ou planifié. Les données peuvent être fournies pour différents niveaux d'agrégation de plages de dates (DAYWEEK, ouMONTH) et niveaux d'agrégation d'ASIN (PARENTCHILD, ouSKU).

API de kiosque de données

L'API Data Kiosk fournit une suite de rapports dynamiques basée sur GraphQL. Il vous permet de générer des requêtes GraphQL personnalisées et d'accéder à des données en masse à partir des ensembles de données d'Amazon. Vous pouvez utiliser cette API pour accéder à un large éventail de données, notamment :

Les principales fonctionnalités de l'API Data Kiosk sont les suivantes :

  • Rapports dynamiques basés sur GraphQL — L'API prend en charge les opérations de requête GraphQL, vous aidant ainsi à créer des requêtes personnalisées pour récupérer les données spécifiques dont vous avez besoin.

  • Accès aux données en masse : vous pouvez accéder à de grands ensembles de données via l'API, ce qui facilite une analyse et des rapports complets.

  • Exploration flexible des données — L'approche basée sur GraphQL permet une exploration dynamique et ad hoc des données. Cette flexibilité vous permet d'itérer les requêtes et d'en extraire des informations.

  • Couverture complète des données — L'API donne accès à un large éventail de données sur les vendeurs et les fournisseurs, permettant une analyse globale des performances et des informations commerciales.

Les schémas et directives de l'API Data Kiosk fournissent un moyen structuré d'accéder à vos données via une API GraphQL, avec la possibilité d'agréger et de filtrer les données en fonction de vos besoins spécifiques. En utilisant l'API Data Kiosk, vous pouvez obtenir des informations plus approfondies et plus exploitables sur les ventes, le trafic et les données analytiques. Cela vous permet de prendre des décisions éclairées et basées sur des données afin d'optimiser vos stratégies commerciales.

Note

La durée de conservation d'une requête varie en fonction des champs demandés. Chaque champ d'un schéma est annoté avec une @resultRetention directive qui définit la durée de conservation d'une requête contenant ce champ. Lorsqu'une requête contient plusieurs champs avec des rétentions différentes, la rétention la plus courte (minimale) est appliquée. La conservation des documents résultant d'une requête correspond toujours à la rétention de la requête.

Données sur les ventes et le trafic des vendeurs

Dans l'API Data Kiosk, Analytics_SalesAndTraffic_2024_04_24 il s'agit du type racine pour les requêtes relatives aux ventes et au trafic. Deux requêtes sont disponibles pour ce type de racine :

  • salesAndTrafficByAsinrécupère les données relatives aux ventes et au trafic agrégées par ASIN (PARENT,CHILD, ouSKU).

  • salesAndTrafficByDaterécupère les données de vente et de trafic agrégées par date (DAYWEEK, ouMONTH).

Notez ce qui suit à propos de ces requêtes :

  • Les types énumérés (enums), tels que AsinGranularity etDateGranularity, spécifient le niveau d'agrégation.

  • Les types scalaires, tels que Date, sont utilisés pour représenter les données.

Données d'analyse des fournisseurs

Dans l'API Data Kiosk, Analytics_vendorAnalytics_2024_09_30 il s'agit du type racine pour les requêtes d'analyse des fournisseurs. Deux vues sont disponibles pour ce type de racine :

  • manufacturingViewrécupère les statistiques relatives aux produits que vous fabriquez, agrégées à la date spécifiée.

  • sourcingViewrécupère les statistiques relatives aux produits que vous achetez directement auprès d'Amazon, agrégées à la date spécifiée.

Vous accédez à la vue pertinente et à ses indicateurs associés en fonction du rôle qui vous est attribué en tant que fournisseur (SOURCINGouMANUFACTURING). Ces requêtes incluent les dates de début et de fin, l'identifiant du marché, les métriques agrégées et les métriques totales. Notez ce qui suit à propos de ces requêtes :

  • Les statistiques sont regroupées selon différents attributs (tels que l'ASIN ou la marque) à l'aide ManufacturingViewMetricsGroupedBy des SourcingViewMetricsGroupedBy types et.

  • Les types de métriques, tels que costscustomerSatisfaction,orders, etproductAvailability, représentent les différents groupes de métriques.

  • L'DateGranularityénumération indique le niveau d'agrégation des dates.

Données économiques sur les vendeurs

Le rapport sur l'économie des vendeurs fournit une vue complète de vos performances et de vos finances sur Amazon Marketplace. Il couvre les données de vente, les dépenses publicitaires, les frais, les coûts et le produit net. Vous pouvez agréger les données par date et par identifiant de produit.

Dans l'API Data Kiosk, Analytics_Economics_2024_03_15 il s'agit du type racine pour les requêtes économiques des vendeurs. Les données économiques du vendeur pour un produit donné sont représentées par le Economics type. Ce type inclut les principaux aspects suivants :

  • ads— Les données relatives aux dépenses publicitaires du produit dans la plage de dates spécifiée.

  • cost— Le coût hors Amazon indiqué par le vendeur pour ce produit (par unité).

  • fees— Les frais appliqués au produit dans la plage de dates spécifiée.

  • fnsku— L'unité de gestion des stocks du réseau de distribution (FNSKU) du produit.

  • msku— L'unité de gestion des stocks du vendeur (MSKU) du produit.

  • netProceeds— Le produit net pour ce produit dans la plage de dates spécifiée.

  • sales— Les données de vente du produit dans la plage de dates spécifiée.