Update Data Kiosk schemas

This commit is contained in:
Jack Evoniuk 2024-04-24 10:21:40 -07:00
parent 5f6ac80cfd
commit b89433685e
2 changed files with 1118 additions and 0 deletions

View File

@ -0,0 +1,493 @@
"""
A Scalar for the primitive long type.
"""
scalar Long
"""
An RFC-3339 compliant Full Date Scalar. Example: "2024-03-15"
"""
scalar Date
extend type Query
@domainResolver(
sdpInstanceType: "amzn1.sdp.1.type.1.DataKiosk.Domain.Analytics_Economics_2024_03_15"
) {
"""
Seller economics queries version 2024_03_15.
"""
analytics_economics_2024_03_15: Analytics_Economics_2024_03_15
}
"""
A root type for seller economics queries version 2024_03_15.
"""
type Analytics_Economics_2024_03_15 {
"""
A query to retrieve seller economics data for the seller's account aggregated by date and product identifier. The seller economics data consists of aggregated sales, fees, and cost for selected period.
"""
economics(
"""
The start date of the seller economics data to retrieve. The start date must be no more than two years ago. If the provided start date occurs mid-week or mid-month in UTC+0 timezone, the following Sunday for WEEK date granularity or the first day of the next month for MONTH date granularity will be used instead.
"""
startDate: Date!
"""
The end date of the seller economics data to retrieve. If the provided end date occurs mid-week or mid-month in UTC+0 timezone, the preceding Saturday for WEEK date granularity or the last day of the previous month for MONTH date granularity will be used instead.
"""
endDate: Date!
"""
The marketplace identifiers to retrieve seller economics data for.
"""
marketplaceIds: [String]!
"""
Specifies which fee types to breakdown into individual components.
"""
includeComponentsForFeeTypes: [FeeType]
"""
Determines how the seller economics data should be aggregated. By default it's aggregated by MSKU and DAY.
"""
aggregateBy: EconomicsAggregation
): [Economics] @supportedAccountTypes(types: [MERCHANT])
}
"""
The seller economics data for a given product in the seller's account.
"""
type Economics {
"""
The marketplace identifier of the seller economics data.
"""
marketplaceId: String!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The start date of the seller economics data, please note this date may be adjusted to the start of DateGranularity.
"""
startDate: Date!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The end date of the seller economics data, please note this date may be adjusted to the end of DateGranularity.
"""
endDate: Date!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The Amazon Standard Identification Number of the parent product. A parent product appears in our catalog as a non-buyable, generic identifier for a product that has buyable variations (child products).
"""
parentAsin: String!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The Amazon Standard Identification Number of the child product. Child products are unique, sellable products that are related in our catalog to a single, non-sellable parent product. Note: This field is only present when product aggregation is CHILD_ASIN, FNSKU or MSKU.
"""
childAsin: String
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The Fulfillment Network Stock Keeping Unit (FNSKU) of the product. Note: This field is only present when product aggregation is FNSKU or MSKU. This field may be null when product aggregation is MSKU and the row is associated with more than one FNSKU.
"""
fnsku: String
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The Merchant Stock Keeping Unit (MSKU) of the product. Note: This field is only present when product aggregation is FNSKU or MSKU. This field may be null when product aggregation is FNSKU and the row is associated with more than one MSKU.
"""
msku: String
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The sales data for the product within the specified date range.
"""
sales: Sales!
"""
The fees applied to the product within the specified date range. Supported fee types can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5.)
"""
fees: [FeeSummary]!
"""
The advertising spend data for the product within the specified date range. Supported advertisement charge types can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
"""
ads: [AdSummary]
"""
The off Amazon cost provided by the seller for this product (per unit). The off Amazon cost can be provided on [SKU Central](https://sellercentral.amazon.com/skucentral?mSku=xxx) and [Revenue Calculator](https://sellercentral.amazon.com/revcal).
"""
cost: PerUnitCost
"""
The net proceeds for this product within the specified date range. The value remains unchanged regardless of whether sales, fees, ads, or cost are selected in the query.
"""
netProceeds: NetProceeds!
}
"""
The sales data for a given product in the seller's account within a given date range.
"""
type Sales {
"""
The amount of ordered product sales, calculated by multiplying the price of products and the number of units sold for the selected time period.
"""
orderedProductSales: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The number of units ordered for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
"""
unitsOrdered: Long!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The average price of the units sold in the selected time period, calculated by dividing the orderedProductSales by unitsOrdered for the selected time period. This field will be null when unitsOrdered is 0.
"""
averageSellingPrice: Amount
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The amount of refunded product sales for the selected time period, it's counted by refund request time.
"""
refundedProductSales: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The number of units refunded in the selected time period.
"""
unitsRefunded: Long!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The amount of net product sales, calculated by orderedProductSales - refundedProductSales.
"""
netProductSales: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The number of net units sold for the selected time period, calculated by unitsOrdered - unitsRefunded.
"""
netUnitsSold: Long!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
}
"""
The fees data summary for the seller's account aggregated by transaction event type: charge.
"""
type FeeSummary {
"""
Fee type name, for example: "FBA fulfillment fees"
"""
feeTypeName: String!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Charge summary for a fee type.
"""
charge: Fee
}
"""
A fee applied to a given product in the seller's account within a given date range. Fee information can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
"""
type Fee {
"""
Fee aggregated transaction detail.
"""
aggregatedDetail: AggregatedDetail!
"""
A breakdown of the fee into individual components. This field will be null for fee types that cannot be divided into individual components.
"""
components: [FeeComponent]
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
}
"""
The fee component data applied to a given product in the seller's account within a given date range. It's breakdown of parent fee.
"""
type FeeComponent {
"""
Fee component name, for example: "Base fulfillment fee".
"""
name: String!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Fee component aggregated detail.
"""
aggregatedDetail: AggregatedDetail!
}
"""
The advertisements spend data summary for the seller's account aggregated by transaction event type: charge.
"""
type AdSummary {
"""
Advertisement type name, for example: "Sponsored Products charge".
"""
adTypeName: String!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Charge aggregated detail for an advertisement type.
"""
charge: AggregatedDetail
}
"""
The aggregated transaction detail for the seller's account aggregated by transaction event type and transaction type, for example: charge and "fbaFulfillmentFee".
"""
type AggregatedDetail {
"""
Charged quantity for a given product in the seller's account. When the fee is not charged on a per unit basis, this value may be null or may not be an integer.
"""
quantity: Float
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Final charge amount after promotion and tax are considered. This value is calculated as amount - promotionAmount + taxAmount.
"""
totalAmount: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Final charge amount per unit after promotion and tax are considered. This value is calculated by dividing totalAmount by quantity. This value will be null when quantity is null.
"""
amountPerUnit: Amount
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
Amount calculated by rate card.
"""
amount: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The promotion amount associated with this transaction type. This value is deducted from amount when computing totalAmount.
"""
promotionAmount: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
"""
The tax amount associated with this transaction type. This value is added to amount when computing totalAmount.
"""
taxAmount: Amount!
@paamRights(
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
)
@resultRetention(duration: "P30D")
}
"""
The item level per unit cost provided by seller. Fields in this type will be null if not provided by the seller.
"""
type PerUnitCost {
"""
Cost to manufacture or acquire the product. This value is provided by the seller and is applicable to both Fulfillment by Amazon (FBA) and Merchant Fulfilled Network (MFN) products.
"""
costOfGoodsSold: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
"""
Miscellaneous costs not related to this specific product, ex: overhead, etc. This value is provided by the seller and applicable to both Fulfillment by Amazon (FBA) and Merchant Fulfilled Network (MFN) products.
"""
miscellaneousCost: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
"""
The item level per unit cost provided by the seller and applicable to Fulfillment by Amazon (FBA) products.
"""
fbaCost: FbaPerUnitCost
"""
The item level per unit cost provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
"""
mfnCost: MfnPerUnitCost
}
"""
The item level per unit cost provided by the seller and applicable to Fulfillment by Amazon (FBA) products. Fields in this type will be null if not provided by the seller.
"""
type FbaPerUnitCost {
"""
Cost of shipping the Fulfillment by Amazon (FBA) item to an Amazon fulfillment center. This value is provided by the seller and applicable to Fulfillment by Amazon (FBA) products.
"""
shippingToAmazonCost: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
}
"""
The item level per unit cost provided by the seller and applicable to Merchant Fulfilled Network (MFN) products. Fields in this type will be null if not provided by the seller.
"""
type MfnPerUnitCost {
"""
Cost of fulfilling an order containing the product, including labor, packing material, shipping to customer, customer service etc. This value is provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
"""
fulfillmentCost: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
"""
Cost to store a single unit of the product per month. This value is provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
"""
storageCost: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
}
"""
The net proceeds for a given product in the seller's account for a given time range. These fields are calculated as sales.netProductSales - sum of fees.charge.totalAmount - sum of ads.charge.totalAmount - (cost of Merchant Fulfilled Network (MFN) products or cost of Fulfillment by Amazon (FBA) products) * sales.netUnitsSold.
"""
type NetProceeds {
"""
"Total net proceeds for a given product in the seller's account for a given time range.
"""
total: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
"""
Net proceeds per unit for a given product in the seller's account for a given time range. This value is calculated by dividing total by sales.netUnitsSold.
"""
perUnit: Amount
@paamRights(
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
)
@resultRetention(duration: "P30D")
}
"""
Monetary amount with the corresponding currency code.
"""
type Amount {
"""
The amount.
"""
amount: Float!
"""
Currency code of the amount in ISO 4217 format.
"""
currencyCode: String!
}
"""
Defines how the seller economics data will be aggregated.
"""
input EconomicsAggregation {
"""
The product identifier granularity used in aggregation. By default the results will be aggregated by MSKU.
"""
productId: ProductIdentifierGranularity
"""
The date granularity used in aggregation. By default the results will be aggregated by DAY.
"""
date: DateGranularity
}
"""
The date granularity used in aggregation.
"""
enum DateGranularity {
"""
Seller economics data is aggregated by day against marketplace local time.
"""
DAY
"""
Seller economics data is aggregated by week against marketplace local time, Sunday is the first day of the week.
"""
WEEK
"""
Seller economics data is aggregated by month against marketplace local time.
"""
MONTH
"""
Seller economics data is aggregated by the entire date range specified by startDate and endDate.
"""
RANGE
}
"""
The product identifier granularity used in aggregation.
"""
enum ProductIdentifierGranularity {
"""
Seller Economics data is aggregated by parent ASIN.
"""
PARENT_ASIN
"""
Seller Economics data is aggregated by child ASIN.
"""
CHILD_ASIN
"""
Seller Economics data is aggregated by fulfillment network sku.
"""
FNSKU
"""
Seller Economics data is aggregated by merchant sku.
"""
MSKU
}
"""
The fee type used in filter fee components generation.
"""
enum FeeType {
"""
Fulfillment by Amazon (FBA) Fulfillment Fees, including base rate and surcharges.
"""
FBA_FULFILLMENT_FEE
"""
Fulfillment by Amazon (FBA) Monthly Inventory Storage Fee, including base rate and surcharges.
"""
FBA_STORAGE_FEE
}

View File

@ -0,0 +1,625 @@
"""
A Scalar for the primitive long type.
"""
scalar Long
"""
An RFC-3339 compliant Full Date Scalar. Example: "2023-11-15"
"""
scalar Date
extend type Query
@domainResolver(
sdpInstanceType: "amzn1.sdp.1.type.1.DataKiosk.Domain.Analytics_SalesAndTraffic_2024_04_24"
) {
"""
Analytics Sales and Traffic queries version 2024_04_24.
"""
analytics_salesAndTraffic_2024_04_24: Analytics_SalesAndTraffic_2024_04_24
}
"""
A root type for Analytics Sales and Traffic queries version 2024_04_24.
"""
type Analytics_SalesAndTraffic_2024_04_24 {
"""
A query to retrieve sales and traffic data for the seller's account aggregated by date.
"""
salesAndTrafficByDate(
"""
The start date of the sales and traffic data to retrieve. The start date must be no more than two years ago. If the provided start date occurs mid-week or mid-month, the following Sunday for WEEK date granularity or the first day of the next month for MONTH date granularity will be used instead.
"""
startDate: Date!
"""
The end date of the sales and traffic data to retrieve. If the provided end date occurs mid-week or mid-month, the preceding Saturday for WEEK date granularity or the last day of the previous month for MONTH date granularity will be used instead.
"""
endDate: Date!
"""
The marketplace identifiers to retrieve sales and traffic data for.
"""
marketplaceIds: [String!]!
"""
Determines how the sales and traffic data should be aggregated.
"""
aggregateBy: DateGranularity!
): [SalesAndTrafficByDate] @supportedAccountTypes(types: [MERCHANT])
"""
A query to retrieve sales and traffic data for the seller's account aggregated by ASIN.
"""
salesAndTrafficByAsin(
"""
The start date of the sales and traffic data to retrieve. The start date must be no more than two years ago. If a date granularity is specified and the provided start date occurs mid-week or mid-month, the following Sunday for WEEK date granularity or the first day of the next month for MONTH date granularity will be used instead.
"""
startDate: Date!
"""
The end date of the sales and traffic data to retrieve. If a date granularity is specified and the provided end date occurs mid-week or mid-month, the preceding Saturday for WEEK date granularity or the last day of the previous month for MONTH date granularity will be used instead.
"""
endDate: Date!
"""
The marketplace identifiers to retrieve sales and traffic data for.
"""
marketplaceIds: [String!]!
"""
Determines how the sales and traffic data should be aggregated.
"""
aggregateBy: AsinGranularity!
): [SalesAndTrafficByAsin] @supportedAccountTypes(types: [MERCHANT])
}
"""
The sales and traffic data for the seller's account aggregated by date.
"""
type SalesAndTrafficByDate {
"""
The marketplace identifier of the sales and traffic data.
"""
marketplaceId: String!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The start date of the sales and traffic data.
"""
startDate: Date!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The end date of the sales and traffic data.
"""
endDate: Date!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The sales data for the seller's account.
"""
sales: ByDateSales!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
"""
The traffic data for the seller's account.
"""
traffic: ByDateTraffic!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
}
"""
The sales data for the seller's account aggregated by date.
"""
type ByDateSales {
"""
The amount of ordered product sales, calculated by multiplying the price of products and the number of units sold for the selected time period.
"""
orderedProductSales: Amount! @resultRetention(duration: "P30D")
"""
The amount of ordered product sales to Amazon Business customers, calculated by multiplying the price of products and the number of units sold for the selected time period.
"""
orderedProductSalesB2B: Amount @resultRetention(duration: "P30D")
"""
The number of units ordered for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
"""
unitsOrdered: Long! @resultRetention(duration: "P30D")
"""
The number of units ordered by Amazon Business customers for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
"""
unitsOrderedB2B: Long @resultRetention(duration: "P30D")
"""
The number of items that were ordered for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
"""
totalOrderItems: Long! @resultRetention(duration: "P30D")
"""
The number of items that were ordered by Amazon Business customers for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
"""
totalOrderItemsB2B: Long @resultRetention(duration: "P30D")
"""
The average ordered product sales, calculated by dividing orderedProductSales by totalOrderItems for the selected time period.
"""
averageSalesPerOrderItem: Amount! @resultRetention(duration: "P30D")
"""
The average ordered product sales to Amazon Business customers, calculated by dividing orderedProductSalesB2B by totalOrderItemsB2B for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
averageSalesPerOrderItemB2B: Amount @resultRetention(duration: "P30D")
"""
The average number of units in each order item for the selected time period.
"""
averageUnitsPerOrderItem: Float! @resultRetention(duration: "P30D")
"""
The average number of units in each order item ordered by Amazon Business customers for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
averageUnitsPerOrderItemB2B: Float @resultRetention(duration: "P30D")
"""
The average price of the units sold in the selected time period, calculated by dividing the orderedProductSales by unitsOrdered for the selected time period.
"""
averageSellingPrice: Amount! @resultRetention(duration: "P30D")
"""
The average price of the units sold to Amazon Business customers, calculated by dividing the orderedProductSalesB2B by unitsOrderedB2B for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
averageSellingPriceB2B: Amount @resultRetention(duration: "P30D")
"""
The number of units refunded in the selected time period.
"""
unitsRefunded: Long! @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many orders were refunded by the seller, calculated by dividing unitsOrdered by unitsRefunded in the selected time period.
"""
refundRate: Float! @resultRetention(duration: "P30D")
"""
The number of A-to-z guarantee claims granted.
"""
claimsGranted: Long! @resultRetention(duration: "P30D")
"""
Monetary amount of filed A-to-z guarantee claims.
"""
claimsAmount: Amount! @resultRetention(duration: "P30D")
"""
The amount of ordered product sales shipped for the selected time period.
"""
shippedProductSales: Amount! @resultRetention(duration: "P30D")
"""
The number of units shipped in the selected time period.
"""
unitsShipped: Long! @resultRetention(duration: "P30D")
"""
The number of orders shipped in the selected time period.
"""
ordersShipped: Long! @resultRetention(duration: "P30D")
}
"""
The traffic data for the seller's account aggregated by date.
"""
type ByDateTraffic {
"""
Browser sessions are visits to your Amazon.com browser pages by a user. All browser activity within a 24-hour period is considered a browser session. For example, if a user visits your pages using a browser multiple times within a 24 hour period it is counted as a single browser session.
"""
browserSessions: Long! @resultRetention(duration: "P30D")
"""
Browser B2B sessions are visits to your Amazon.com browser pages by an Amazon Business customer. All activity within a 24-hour period is considered a browser session. For example, if an Amazon Business customer visits your pages using browser multiple times within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
browserSessionsB2B: Long @resultRetention(duration: "P30D")
"""
Mobile app sessions are visits to your Amazon.com mobile app pages by a user. All mobile app activity within a 24-hour period is considered a mobile app session. For example, if a user visits your pages using a mobile app multiple times within a 24 hour period it is counted as a single mobile app session.
"""
mobileAppSessions: Long! @resultRetention(duration: "P30D")
"""
Mobile app B2B sessions are visits to your Amazon.com mobile app pages by an Amazon Business customer. All activity within a 24-hour period is considered a mobile app session. For example, if an Amazon Business customer visits your pages using mobile app multiple times within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppSessionsB2B: Long @resultRetention(duration: "P30D")
"""
Sessions are visits to your Amazon.com browser or mobile app pages by a user. All browser and mobile app activity within a 24-hour period is considered a session. It is calculated as the sum of browserSessions and mobileAppSessions.
"""
sessions: Long! @resultRetention(duration: "P30D")
"""
B2B sessions are visits to your Amazon.com pages using browser or mobile app by an Amazon Business customer. All activity within a 24-hour period is considered a session. For example, if an Amazon Business customer visits your pages multiple times using mobile app or browser within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
sessionsB2B: Long @resultRetention(duration: "P30D")
"""
Browser page views are the number of times a user visited your Amazon.com browser pages for the selected time period.
"""
browserPageViews: Long! @resultRetention(duration: "P30D")
"""
Browser B2B page views are the number of times an Amazon Business customer visited your Amazon.com browser pages for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
browserPageViewsB2B: Long @resultRetention(duration: "P30D")
"""
Mobile app page views are the number of times a user visited your Amazon.com mobile app pages for the selected time period.
"""
mobileAppPageViews: Long! @resultRetention(duration: "P30D")
"""
Mobile app B2B page views are the number of times an Amazon Business customer visited your Amazon.com mobile app pages for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppPageViewsB2B: Long @resultRetention(duration: "P30D")
"""
Page views are the number of times a user visited your Amazon.com browser or mobile app pages for the selected time period. It is calculated as the sum of browserPageViews and mobileAppPageViews.
"""
pageViews: Long! @resultRetention(duration: "P30D")
"""
B2B page views are the number of times an Amazon Business customer visited your Amazon.com pages using browser or mobile app for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
pageViewsB2B: Long @resultRetention(duration: "P30D")
"""
The percentage of page views where the buy box (the add to shopping cart link) appeared on the page for customers to add your product to their cart.
"""
buyBoxPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of page views by Amazon Business customers where the buy box (the add to shopping cart link) appeared on the page for customers to add your product to their cart. Note: This field is only populated when the seller is a B2B seller.
"""
buyBoxPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many order items were generated relative to the number of people who viewed the products.
"""
orderItemSessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many order items were generated by Amazon Business customers relative to the number of Amazon Business customers who viewed the products. Note: This field is only populated when the seller is a B2B seller.
"""
orderItemSessionPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many units were purchased relative to the number of people who viewed the products.
"""
unitSessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many units were purchased by Amazon Business customers relative to number of Amazon Business customers who viewed the products. Note: This field is only populated when the seller is a B2B seller.
"""
unitSessionPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The average number of offers listed for sale in the selected time period. It is calculated from the total number of offers and the total number of days in the selected time period.
"""
averageOfferCount: Long! @resultRetention(duration: "P30D")
"""
The average number of parent items listed for sale in the selected time period.
"""
averageParentItems: Long! @resultRetention(duration: "P30D")
"""
The number of times customers left feedback in the selected time period.
"""
feedbackReceived: Long! @resultRetention(duration: "P30D")
"""
The number of times customers left negative feedback in the selected time period.
"""
negativeFeedbackReceived: Long! @resultRetention(duration: "P30D")
"""
The negative feedback rate is the number of orders that have received negative feedback divided by the number of orders in the selected time period.
"""
receivedNegativeFeedbackRate: Float! @resultRetention(duration: "P30D")
}
"""
The sales and traffic data for the seller's account aggregated by ASIN.
"""
type SalesAndTrafficByAsin {
"""
The marketplace identifier of the sales and traffic data.
"""
marketplaceId: String!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The start date of the period of the aggregated data.
"""
startDate: Date!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The end date of the period of the aggregated data.
"""
endDate: Date!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The Amazon Standard Identification Number of the parent product. A parent product appears in our catalog as a non-buyable, generic identifier for a product that has buyable variations (child products).
"""
parentAsin: String!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The Amazon Standard Identification Number of the child product. Child products are unique, sellable products that are related in our catalog to a single, non-sellable parent product. Note: This field is only present when ASIN aggregation is CHILD or SKU.
"""
childAsin: String
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The Stock Keeping Unit of the product. The SKU is a seller specific product identifier. Note: This field is only present when ASIN aggregation is SKU.
"""
sku: String
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
@resultRetention(duration: "P30D")
"""
The sales data for the parentAsin/childAsin/sku within the specified date range.
"""
sales: ByAsinSales!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
"""
The traffic data for the parentAsin/childAsin/sku within the specified date range.
"""
traffic: ByAsinTraffic!
@paamRights(require: ["analytics_sales_and_traffic_view_pa"])
}
"""
The sales data for the seller's account aggregated by ASIN.
"""
type ByAsinSales {
"""
The number of units ordered.
"""
unitsOrdered: Long! @resultRetention(duration: "P30D")
"""
The number of units ordered by Amazon Business customers. Note: This field is only populated when the seller is a B2B seller.
"""
unitsOrderedB2B: Long @resultRetention(duration: "P30D")
"""
The amount of ordered product sales, calculated by multiplying the price of products and the number of units sold for the selected time period.
"""
orderedProductSales: Amount! @resultRetention(duration: "P30D")
"""
The amount of ordered product sales to Amazon Business customers, calculated by multiplying the price of products and the number of units sold for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
orderedProductSalesB2B: Amount @resultRetention(duration: "P30D")
"""
The number of items that were ordered for the selected time period.
"""
totalOrderItems: Long! @resultRetention(duration: "P30D")
"""
The number of items that were ordered by Amazon Business customers for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
totalOrderItemsB2B: Long @resultRetention(duration: "P30D")
}
"""
The traffic data for the seller's account aggregated by ASIN.
"""
type ByAsinTraffic {
"""
Browser sessions are visits to your Amazon.com browser pages by a user. All browser activity within a 24-hour period is considered a browser session. For example, if a user visits your pages using a browser multiple times within a 24 hour period it is counted as a single browser session.
"""
browserSessions: Long! @resultRetention(duration: "P30D")
"""
Browser B2B sessions are visits to your Amazon.com browser pages by an Amazon Business customer. All activity within a 24-hour period is considered a browser session. For example, if an Amazon Business customer visits your pages using browser multiple times within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
browserSessionsB2B: Long @resultRetention(duration: "P30D")
"""
Mobile app sessions are visits to your Amazon.com mobile app pages by a user. All mobile app activity within a 24-hour period is considered a mobile app session. For example, if a user visits your pages using a mobile app multiple times within a 24 hour period it is counted as a single mobile app session.
"""
mobileAppSessions: Long! @resultRetention(duration: "P30D")
"""
Mobile app B2B sessions are visits to your Amazon.com mobile app pages by an Amazon Business customer. All activity within a 24-hour period is considered a mobile app session. For example, if an Amazon Business customer visits your pages using mobile app multiple times within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppSessionsB2B: Long @resultRetention(duration: "P30D")
"""
Sessions are visits to your Amazon.com browser or mobile app pages by a user. All browser and mobile app activity within a 24-hour period is considered a session. It is calculated as the sum of browserSessions and mobileAppSessions.
"""
sessions: Long! @resultRetention(duration: "P30D")
"""
B2B sessions are visits to your Amazon.com pages using browser or mobile app by an Amazon Business customer. All activity within a 24-hour period is considered a session. For example, if an Amazon Business customer visits your pages multiple times using mobile app or browser within a 24 hour period it is counted as a single session. Note: This field is only populated when the seller is a B2B seller.
"""
sessionsB2B: Long @resultRetention(duration: "P30D")
"""
The percentage of browser sessions that contain at least one page view for a particular SKU/ASIN relative to the total number of browser sessions for all products.
"""
browserSessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of browser sessions that contain at least one page view by an Amazon Business customer for a particular SKU/ASIN relative to the total number of browser sessions by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
browserSessionPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage of mobile app sessions that contain at least one page view for a particular SKU/ASIN relative to the total number of mobile app sessions for all products.
"""
mobileAppSessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of mobile app sessions that contain at least one page view by an Amazon Business customer for a particular SKU/ASIN relative to the total number of mobile app sessions by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppSessionPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage of sessions that contain at least one page view for a particular SKU/ASIN relative to the total number of sessions for all products.
"""
sessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of sessions that contain at least one page view by an Amazon Business customer for a particular SKU/ASIN relative to the total number of sessions by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
sessionPercentageB2B: Float @resultRetention(duration: "P30D")
"""
Browser page views are the number of times a user visited your Amazon.com browser pages for the selected time period.
"""
browserPageViews: Long! @resultRetention(duration: "P30D")
"""
Browser B2B page views are the number of times an Amazon Business customer visited your Amazon.com browser pages for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
browserPageViewsB2B: Long @resultRetention(duration: "P30D")
"""
Mobile app page views are the number of times a user visited your Amazon.com mobile app pages for the selected time period.
"""
mobileAppPageViews: Long! @resultRetention(duration: "P30D")
"""
Mobile app B2B page views are the number of times an Amazon Business customer visited your Amazon.com mobile app pages for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppPageViewsB2B: Long @resultRetention(duration: "P30D")
"""
Page views are the number of times a user visited your Amazon.com browser or mobile app pages for the selected time period. It is calculated as the sum of browserPageViews and mobileAppPageViews.
"""
pageViews: Long! @resultRetention(duration: "P30D")
"""
B2B page views are the number of times an Amazon Business customer visited your Amazon.com pages using browser or mobile app for the selected time period. Note: This field is only populated when the seller is a B2B seller.
"""
pageViewsB2B: Long @resultRetention(duration: "P30D")
"""
The percentage of browser page views that a particular SKU/ASIN receives relative to the total number of browser page views for all products.
"""
browserPageViewsPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of browser views by Amazon Business customers that a particular SKU/ASIN receives relative to the total number of mobile page views by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
browserPageViewsPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage of mobile app page views that a particular SKU/ASIN receives relative to the total number of mobile app page views for all products.
"""
mobileAppPageViewsPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of mobile page views by Amazon Business customers that a particular SKU/ASIN receives relative to the total number of mobile page views by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
mobileAppPageViewsPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage of browser and mobile app page views that a particular SKU/ASIN receives relative to the total number of browser and mobile app page views for all products.
"""
pageViewsPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of page views by Amazon Business customers that a particular SKU/ASIN receives relative to the total number of page views by Amazon Business customers for all products. Note: This field is only populated when the seller is a B2B seller.
"""
pageViewsPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage of page views where the buy box (the add to shopping cart link) appeared on the page for customers to add your product to their cart.
"""
buyBoxPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage of page views by Amazon Business customers where the buy box (the add to shopping cart link) appeared on the page for customers to add your product to their cart. Note: This field is only populated when the seller is a B2B seller.
"""
buyBoxPercentageB2B: Float @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many units were purchased relative to the number of people who viewed the products, calculated by dividing unitsOrdered by sessions.
"""
unitSessionPercentage: Float! @resultRetention(duration: "P30D")
"""
The percentage conversion metric indicating how many units were purchased by Amazon Business customers relative to the number of Amazon Business customers who viewed the products, calculated by dividing unitsOrderedB2B by sessions. Note: This field is only populated when the seller is a B2B seller.
"""
unitSessionPercentageB2B: Float @resultRetention(duration: "P30D")
}
"""
Monetary amount with the corresponding currency code.
"""
type Amount {
"""
The amount.
"""
amount: Float!
"""
Currency code of the amount in ISO 4217 format.
"""
currencyCode: String!
}
"""
The date granularity used in aggregation.
"""
enum DateGranularity {
"""
Sales and traffic data is aggregated by day.
"""
DAY
"""
Sales and traffic data is aggregated by week.
"""
WEEK
"""
Sales and traffic data is aggregated by month.
"""
MONTH
}
"""
The ASIN granularity used in aggregation.
"""
enum AsinGranularity {
"""
Sales and traffic data is aggregated by parent ASIN.
"""
PARENT
"""
Sales and traffic data is aggregated by child ASIN.
"""
CHILD
"""
Sales and traffic data is aggregated by sku.
"""
SKU
}