Données disponibles via le partenaire de vente Amazon API

L'Amazon Selling Partner API (SP-API) est une REST base API qui aide les vendeurs et fournisseurs Amazon à accéder de manière programmatique à leurs données sur les commandes, les expéditions, les paiements, etc. Les données ainsi obtenues 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 le partenaire de vente API pour les rapports (rapportsAPI) et le partenaire de vente API pour le kiosque de données (kiosque de données). API

Rapports API

Les données des rapports API 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 qui ont le API rôle de partenaire de vente de Brand Analytics et qui sont enregistrés dans le registre des marques auprès d'Amazon.

Rapport	Description	Paramètres
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é	Paramètres
Rapport d'inventaire de Rapid Retail Analytics	Contient des données d'inventaire à un ASIN niveau, agrégées selon une granularité horaire	Fournisseurs de	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	Fournisseurs de	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 à un ASIN niveau, agrégées selon une granularité horaire	Fournisseurs de	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 les recettes et les unités commandées et expédiées), présentés au niveau du catalogue et au ASIN niveau	Fournisseurs de	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 nettes pures sur les produits d'Amazon pour la vente des articles d'un fournisseur, déclarées au niveau du catalogue et au ASIN niveau	Fournisseurs de	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, présentés au niveau du catalogue et au ASIN niveau	Fournisseurs de	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 prospectives de la demande hebdomadaire moyenne, antérieures à 70, 80 et 90 précédentes, déclarées au ASIN niveau de la date de génération des prévisions hebdomadaires les plus récentes	Fournisseurs de	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), présentés au niveau du catalogue et au niveau ASIN	Fournisseurs de	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'ASINagrégation (PARENTCHILD, ouSKU).

Kiosque de données API

Le Data Kiosk API 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 l'utiliser API pour accéder à un large éventail de données, notamment :

• Données sur les ventes et le trafic des vendeurs

• Données d'analytique sur les fournisseurs

• Données économiques sur les vendeurs

Les principales fonctionnalités du kiosque API de données sont les suivantes :

• Rapports dynamiques basés sur GraphQL : prend en charge les opérations de requête API GraphQL, vous aidant à 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 leAPI, 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 : 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 du Data Kiosk API fournissent un moyen structuré d'accéder à vos données via un GraphQLAPI, avec la possibilité d'agréger et de filtrer les données en fonction de vos besoins spécifiques. En utilisant le Data KioskAPI, 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 le kiosque de donnéesAPI, 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 de vente et de trafic agrégées par ASIN (PARENTCHILD, 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'analytique sur les fournisseurs

Dans le kiosque de donnéesAPI, 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 par différents attributs (tels que ASIN ou marque) à l'aide des SourcingViewMetricsGroupedBy types ManufacturingViewMetricsGroupedBy 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 le Data KioskAPI, 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.