Guide de cas d'utilisation du jeu de données Vendor Analytics

Ce guide décrit les spécificités du Ensemble de données Vendor Analytics. Pour des informations générales sur l'utilisation de Data Kiosk, consultez le Guide de cas d'utilisation de l'API Data Kiosk.

Le jeu de données d'analyse des fournisseurs dans Data Kiosk présente les avantages suivants :

• Analyses interdomaines : Structurez des requêtes personnalisées pour accéder à des mesures dans plusieurs domaines tels que les ventes, le trafic et les stocks. Vous pouvez le faire en une seule requête pour explorer les cas d'utilisation des partenaires commerciaux et répondre aux priorités commerciales. En outre, cet ensemble de données vous permet d'agréger des données par date, ASIN, marque, fabrication et autres granularités dans une même requête. Par exemple, vous pouvez consulter les statistiques des ventes par jour, par semaine ou par mois selon la granularité de l'ASIN.
• Indicateurs complets : Plus de 100 indicateurs dans les domaines des ventes, du trafic, des stocks et des prévisions.
• Appels d'API efficaces : Récupérez uniquement les données dont vous avez besoin avec un minimum d'appels d'API. En outre, vous pouvez récupérer des données provenant de plusieurs sites de vente sur lesquels vous opérez en un seul appel d'API.
• Rapport JSONL : tous les rapports sont au format évolutif JSONL.
• Accès sécurisé aux données : la visibilité des demandes est limitée aux demandes soumises par une application donnée, afin de garantir la sécurité des données des partenaires de vente.

Accédez au schéma

Pour accéder au schéma d'analyse des fournisseurs, téléchargez-le : analytics_vendorAnalytics_2024_09_30.graphql. Vous pouvez utiliser n'importe quel outil GraphQL pour explorer le schéma et créer des requêtes. Vous ne pouvez pas envoyer de requêtes à partir de ces outils.

Pour soumettre les requêtes et récupérer votre rapport personnalisé, suivez les étapes décrites dans Guide de cas d'utilisation du Data Kiosk

Droits d'accès métriques

Le analytics_vendorAnalytics_2024_09_30 l'ensemble de données possède un sourcingView et manufacturingView. Vous accédez à la vue pertinente et à ses métriques associées en fonction du rôle attribué au fournisseur (SOURCING ou MANUFACTURING).

Fabrication fait référence à tous les ASIN fabriqués par le fournisseur, tandis que Sources fait référence uniquement aux ASIN fournis directement par le fournisseur à Amazon (ce qui signifie que le fournisseur est un distributeur).

• sourcingView: affiche uniquement les données relatives aux ASIN provenant directement du fournisseur. Les statistiques disponibles dans la vue de l'approvisionnement sont répertoriées dans Indicateurs dans la vue de l'approvisionnement. Certaines mesures, telles que Glance Views, ne sont pas disponibles dans sourcingView, et ça sourcingView est identique à la vue du distributeur.
• manufacturingView: affiche les données de tous les ASIN fabriqués par le fournisseur (indépendamment de l'origine des produits auprès d'Amazon). Si un fournisseur (groupe de fournisseurs) ne fabrique aucun ASIN, la requête d'accès à la vue de fabrication pour le fournisseur est renvoyée Error: VendorGroup does not have relevant rights to perform this operation.

L'ensemble de données du fournisseur permet une flexibilité et des jointures entre domaines.

Indicateurs dans la vue de l'approvisionnement

L'ensemble de mesures suivant est disponible dans la vue Sourcing et varie en fonction de la catégorie et du domaine. Reportez-vous à la schéma pour la définition de chaque métrique.

• ProductAvailability
  • sellableOnHandInventory
  • unsellableOnHandInventory
  • aged90DaysSellableInventory
  • unhealthyInventory
  • sellThroughRate
  • ultraFastTrack
  • sourceableROOS
  • sellableInTransitInventory
  • unsellableInTransitInventory
• ShippedOrders
  • shippedUnitsWithRevenue
  • averageSellingPrice
• CustomerSatisfaction
  • customerReturns
• Traffic
  • glanceViews
• Sourcing
  • vendorConfirmationRate
  • overallVendorLeadTime
  • netReceived
  • receivedFillRate
  • procurableProductOOS
  • openPurchaseOrderQuantity
  • confirmedUnits
  • mostRecentSubmitted
• Forecasting
  • mean
  • p70
  • p80
  • p90
• Costs
  • netPPM
  • salesDiscount
  • shippedCogs
  • contraCogs
  • contraCogsPerUnit
  • averageSalesDiscount

Comportement spécifique aux domaines métriques

Certains domaines de mesures ne s'additionnent pas au fil des périodes (par exemple, les mesures d'inventaire pour une semaine ne peuvent pas être ajoutées pour chaque jour). Cette section décrit les comportements de ces groupes de mesures.

Prévision du comportement du domaine

Le domaine de prévisions contient les prévisions réalisées par Amazon entre la semaine zéro et la semaine 47. La semaine zéro est relative à la date à laquelle les prévisions ont été générées par Amazon.

Il s'agit d'un domaine qui ne s'additionne pas au fil des périodes, ce qui signifie que :

• Les plages de dates fournies dans la requête ne sont pas applicables à ces mesures.
• Les prévisions sont actualisées chaque semaine avec de nouvelles valeurs actualisées pour la semaine zéro à la semaine 47 par rapport à la date de création des prévisions.

Comportement du domaine d'inventaire

Les mesures d'inventaire sont un aperçu du nombre d'unités disponibles à la vente à la fin d'une période donnée. Ces mesures ne sont pas additives et ne sont disponibles que pour des périodes prédéfinies pertinentes pour les décisions commerciales.

Les périodes actuellement prises en charge sont les suivantes :

• Quotidien : Pris en charge uniquement pour la date commune actuelle. Si vous indiquez une date non valide, le message d'erreur contient la date correcte à utiliser.
• Hebdomadaire : Huit semaines. Cette période comprend la semaine en cours et les sept semaines précédentes.
• Mensuel : 24 mois. Cette période comprend le mois en cours et les 23 mois précédents.

Comportement des attributs du catalogue

Les attributs du catalogue (par exemple, les ASIN et les titres de produits) sont toujours à jour et à jour. Il n'existe aucune vue historique des données du catalogue. Les informations relatives à un ASIN sont toujours basées sur la définition la plus récente et il n'existe aucune notion de « date limite » pour les rapports de catalogue.

Les dates de début et de fin fournies dans la requête ne sont pas applicables aux attributs du catalogue. Lorsqu'une requête contient uniquement des attributs de catalogue et aucune métrique, les valeurs des données de début et de fin fournies sont sans importance et la dernière valeur de l'attribut de catalogue est renvoyée.

Comportement des métriques Geo Sales

Statistiques des ventes géographiques (shipToCountryCode, shipToCity, shipToStateOrProvince, et shipToZipCode) fournissent des données géographiques pour une expédition. Bien que ceux-ci soient considérés groupBy métriques, elles ne sont pas disponibles dans le rapport du catalogue. Chaque demande contenant ces métriques Geo Sales doit également contenir au moins une métrique non compatiblegroupBy métrique.

Les statistiques Geo Sales ne peuvent être demandées qu'avec les mesures suivantes et chaque demande Geo Sales doit contenir au moins l'une de ces mesures :

• netPPM
• salesDiscount
• shippedCogs
• contraCogs
• contraCogsPerUnit
• averageSalesDiscount
• shippedUnitsWithRevenue
• averageSellingPrice

Comportement des dates

Les sorties de requête sont actuellement configurées pour ajuster automatiquement startDate et endDate en fonction de la vue demandée et de la granularité de date pertinente sélectionnée. Certaines vérifications sont effectuées sur chaque demande afin de s'assurer que la date demandée est valide. Par exemple, startDate doit être dans le futur et endDate doit être avant startDate.

Ajustements :

• Le startDate pour tous les rapports, les données hebdomadaires ou mensuelles sont ajustées au début d'une période donnée. Cela signifie que les périodes hebdomadaires commencent toujours le dimanche et les périodes mensuelles commencent toujours le premier jour du mois.
• Le endDate pour tous les rapports sont ajustés à la fin d'une période complète et valide. Cela signifie que endData ne peut pas se produire dans le futur.
• Disponibilité partielle des données : Dans certaines situations, les données sont disponibles pour certaines parties d'une période, mais ne sont pas disponibles pour toute la période. Ce scénario se produit lorsque les données sont demandées dans un délai d'un à deux jours ouvrables. Dans ce cas, la réponse pour les jours non disponibles contient une valeur nulle.

Règles pour la construction des requêtes

• Toutes les requêtes doivent comporter au moins un champ groupé par.
• Lorsque les données demandées dépassent 1,5 Go, la réponse est tronquée et des lignes ou des informations peuvent être manquantes.

Exemples de requêtes

Rapport sur les ventes des fournisseurs

Royaume-Uni SourcingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    sourcingView(
      startDate: "2023-12-01"
      endDate: "2024-02-28"
      aggregateBy: WEEK
      currencyCode: "USD"
    ) {
      startDate
      endDate
      marketplaceId
      totals {
        shippedOrders {
          shippedUnitsWithRevenue {
            units
            value {
              amount
              currencyCode
            }
          }
          averageSellingPrice {
            amount
            currencyCode
          }
        }
      }
      metrics {
        groupByKey {
          asin
          brandCode
        }
        metrics {
          shippedOrders {
            shippedUnitsWithRevenue {
              units
              value {
                amount
                currencyCode
              }
            }
            averageSellingPrice {
              amount
              currencyCode
            }
          }
        }
      }
    }
  }
}

Royaume-Uni ManufacturingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    manufacturingView(
      startDate: "2023-12-01"
      endDate: "2024-02-28"
      aggregateBy: WEEK
      currencyCode: "USD"
    ) {
      startDate
      endDate
      marketplaceId
      totals {
        shippedOrders {
          shippedUnitsWithRevenue {
            units
            value {
              amount
              currencyCode
            }
          }
          averageSellingPrice {
              amount
              currencyCode
          }
        }
        orders {
          unfilledOrderedUnits
          orderedUnitsWithRevenue {
            units
            value {
              amount
              currencyCode
            }
          }
        }
        costs {
          netPPM
        }
      }
      metrics {
        groupByKey {
          asin
          brandCode
        }
        metrics {
          shippedOrders {
            shippedUnitsWithRevenue {
              units
              value {
                amount
                currencyCode
              }
            }
            averageSellingPrice {
              amount
              currencyCode
            }
          }
          orders {
            unfilledOrderedUnits
            orderedUnitsWithRevenue {
              units
              value {
                amount
                currencyCode
              }
            }
          }
          costs {
            netPPM
            salesDiscount {
              amount
              currencyCode
            }
            shippedCogs {
              amount
              currencyCode
            }
            contraCogs {
              amount
              currencyCode
            }
            contraCogsPerUnit {
              amount
              currencyCode
            }
            averageSalesDiscount {
              amount
              currencyCode
            }
          }
        }
      }
    }
  }
}

Rapport sur le trafic des fournisseurs

Le rapport de trafic n'est disponible que pour manufacturingView.

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    manufacturingView(
      startDate: "2023-12-01"
      endDate: "2024-02-28"
      aggregateBy: WEEK
    ) {
      startDate
      endDate
      marketplaceId
      totals {
        traffic {
          glanceViews
        }
      }
      metrics {
        groupByKey {
          asin
          brandCode
        }
        metrics {
          traffic {
            glanceViews
          }
        }
      }
    }
  }
}

Rapport de prévision des fournisseurs

Le rapport de prévision n'est disponible que pour manufacturingView.

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    manufacturingView(
      startDate: "2023-12-01"
      endDate: "2024-02-28"
      aggregateBy: WEEK
    ) {
      startDate
      endDate
      marketplaceId
      metrics {
        groupByKey {
          asin
          brandCode
        }
        metrics {
          forecasting {
            startDate
            endDate
            weekNumber
            demand {
              mean
              p70
              p80
              p90
            }
          }
        }
      }
    }
  }
}

Rapport de stock des fournisseurs

Le rapport d'inventaire est disponible pour les deux sourcingView et manufacturingView. Les rapports d'inventaire ne sont pas additifs.

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    sourcingView(
      startDate: "2023-12-01"
      endDate: "2024-02-28"
      aggregateBy: WEEK
      currencyCode: "USD"
    ) {
      startDate
      endDate
      marketplaceId
      metrics {
        groupByKey {
          asin
          brandCode
        }
        metrics {
          productAvailability {
            sellableOnHandInventory {
              units
              value {
                amount
                currencyCode
              }
            }
            unsellableOnHandInventory {
              units
              value {
                amount
                currencyCode
              }
            }
            aged90DaysSellableInventory {
              units
              value {
                amount
                currencyCode
              }
            }
            unhealthyInventory {
              units
              value {
                amount
                currencyCode
              }
            }
            sellThroughRate
            ultraFastTrack
            sourceableROOS
          }
        }
      }
    }
  }
}

Rapport sur le catalogue

Royaume-Uni sourcingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    sourcingView(
      startDate: "2024-05-25"
      endDate: "2024-05-25"
      aggregateBy: DAY
      currencyCode: "USD"
    ) {
      startDate
      endDate
      metrics {
        groupByKey {
          asin
          productGroup
          productTitle
        }
      }
    }
  }
}

Royaume-Uni manufacturingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    manufacturingView(
      startDate: "2024-05-01"
      endDate: "2024-05-29"
      aggregateBy: DAY
      currencyCode: "USD"
    ) {
      startDate
      endDate
      metrics {
        groupByKey {
          asin
          brandCode
          brand
          parentAsin
        }
      }
    }
  }
}

Rapport Geo Sales

Royaume-Uni sourcingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    sourcingView(
      aggregateBy: WEEK
      endDate: "2024-05-31"
      startDate: "2024-05-01"
    ) {
      startDate
      endDate
      metrics {
        groupByKey {
          asin
          shipToCountryCode
          shipToCity
          shipToStateOrProvince
          shipToZipCode
        }
        metrics {
          shippedOrders {
            shippedUnitsWithRevenue {
              value {
                amount
                currencyCode
              }
              units
            }
          }
        }
      }
    }
  }
}

Royaume-Uni manufacturingView

query MyQuery {
  analytics_vendorAnalytics_2024_09_30 {
    manufacturingView(
      aggregateBy: WEEK
      endDate: "2024-05-31"
      startDate: "2024-05-01"
    ) {
      startDate
      endDate
      metrics {
        groupByKey {
          asin
          shipToCountryCode
          shipToCity
          shipToStateOrProvince
          shipToZipCode
        }
        metrics {
          shippedOrders {
            shippedUnitsWithRevenue {
              value {
                amount
                currencyCode
              }
              units
            }
          }
        }
      }
      totals {
        shippedOrders {
          shippedUnitsWithRevenue {
            units
            value {
              amount
              currencyCode
            }
          }
        }
      }
    }
  }
}

Messages d'erreur

FAQ

Quand les données sont-elles prêtes ?

Toutes les mesures de l'ensemble de données d'analyse des fournisseurs sont prêtes au bout de 34 heures. Les données pour un jour donné sont disponibles à 10 h, heure locale, deux jours plus tard. Par exemple, les données du 1er janvier sont disponibles à 10 h, heure locale, le 3 janvier. Si les données sont retardées et indisponibles, la réponse est null pour la ou les dates spécifiques pour lesquelles les données ne sont pas disponibles.

Pourquoi existe-t-il un 0 pour certaines dates ?

Lorsqu'il n'y a pas de vente un jour donné, la réponse pour ce jour contient 0 ou des données d'espace réservé similaires.