기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Selling Partner API를 통해 사용 가능한 데이터
[Amazon Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/welcome)(SP-API)는 Amazon 판매자와 공급업체가 주문, 배송, 결제 등에 대한 데이터에 프로그래밍 방식으로 액세스할 수 있도록 지원하는 REST 기반 API입니다. 이 API의 데이터는 판매 효율성을 높이고, 노동 요구 사항을 줄이고, 고객에 대한 응답 시간을 개선할 수 있습니다. 이 가이드는 [보고서용 파트너 판매 API](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide)(보고서 API) 및 [데이터 키오스크용 파트너 판매 API](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide)(데이터 키오스크 API)를 통해 액세스할 수 있는 데이터에 중점을 둡니다.
## 보고서 API
보고서 API의 데이터는 Amazon Marketplace에서 비즈니스를 관리하는 데 도움이 되도록 설계되었습니다. [분석 보고서는](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics) 다음과 같이 제품, 고객 및 전반적인 성능에 대한 중요한 인사이트를 제공합니다.
+ **판매 성과** - 판매 데이터를 분석하면 추세와 고객 구매 패턴을 식별하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 판매 전략을 최적화할 수 있습니다.
+ **제품 성능** - 제품 데이터를 분석하면 어떤 제품이 잘 판매되고 있고 어떤 제품이 판매되지 않는지 식별하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 제품을 최적화할 수 있습니다.
+ **고객 행동** - 고객 데이터를 분석하면 고객의 선호도와 요구 사항을 이해하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 마케팅 및 영업 전략을 개인화할 수 있습니다.
다음 표에서는 각 [브랜드 분석](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports) 보고서를 설명합니다. 다음 보고서는 브랜드 분석 판매 파트너 API 역할이 있고 Amazon 브랜드 레지스트리에 등록된 Amazon 판매자 및 공급업체가 사용할 수 있습니다.
****
| Report | 설명 | 파라미터 |
| --- | --- | --- |
| [Market Basket 분석 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | 체크아웃 시 고객의 장바구니(카트)에 있는 항목과 함께 가장 일반적으로 구매되는 항목에 대한 데이터를 제공합니다. | 보고서는 다양한 보고 기간(DAY, WEEKMONTH, 또는 QUARTER)에 대해 요청할 수 있습니다. 데이터는 해당 기간 동안 제공됩니다. |
| [Amazon 검색어 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | 검색 키워드 및 마켓플레이스 부서별로 가장 자주 선택한 Amazon 표준 식별 번호(ASINs)에 대한 데이터를 포함합니다. | 보고서는 다양한 보고 기간(DAY, WEEKMONTH, 또는 QUARTER)에 대해 요청할 수 있습니다. 요청은 여러 보고 기간에 걸쳐 있을 수 없습니다. |
| [반복 구매 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | 판매 파트너 품목의 반복 구매 수량에 대한 데이터를 포함합니다. | 보고서는 다양한 보고 기간(WEEK, MONTH또는 QUARTER)에 대해 요청할 수 있습니다. 데이터는 여러 보고 기간에 걸쳐 있을 수 있습니다. |
다음 표에서는 각 [공급업체 소매 분석](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports) 및 [판매자 소매 분석](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports) 보고서를 설명합니다.
****
| Report | 설명 | 가용성 | 파라미터 |
| --- | --- | --- | --- |
| [Rapid Retail Analytics 인벤토리 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | 시간별 세부 수준으로 집계된 ASIN 수준의 인벤토리 데이터를 포함합니다. | Vendors | 보고서는 요청만 가능합니다. 데이터는 현재 날짜를 포함하여 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다. |
| [Rapid Retail Analytics 트래픽 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | 공급업체 항목의 세부 정보 페이지에 대한 고객 트래픽에 대한 데이터를 시간별로 세분화하여 포함합니다. | Vendors | 보고서는 요청만 가능합니다. 데이터는 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다. |
| [Rapid Retail Analytics 판매 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | 시간별 세부 수준으로 집계된 ASIN 수준의 판매 데이터를 포함합니다. | Vendors | 보고서는 요청만 가능합니다. 데이터는 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다. |
| [공급업체 판매 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | 카탈로그 수준 및 ASIN 수준에서 보고된 주요 소매 판매 지표(예: 주문 및 배송 수익 및 단위)를 포함합니다. | Vendors | 보고서는 다양한에 대해 요청할 수 있습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [순 순수 제품 마진 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | 카탈로그 수준 및 ASIN 수준에서 보고된 공급업체 품목 판매를 위한 Amazon의 순 순수 제품 마진에 대한 데이터를 포함합니다. | Vendors | 보고서는 다양한 보고 기간(DAY, , WEEK, MONTH QUARTER또는 YEAR)에 대해 요청할 수 있습니다. |
| [공급업체 트래픽 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | 카탈로그 수준 및 ASIN 수준에서 보고된 개요 보기와 같은 주요 소매 트래픽 지표 포함 | Vendors | 보고서는 다양한 보고 기간(DAY, , WEEK, MONTH QUARTER또는 YEAR)에 대해 요청할 수 있습니다. |
| [공급업체 예측 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | 가장 최근 주간 예측 생성일에 ASIN 수준에서 보고된 미래 예측 평균, 이전 70, 이전 80 및 이전 90 주간 고객 수요 예측을 포함합니다. | Vendors | 보고서는 다양한 판매 프로그램(RETAIL 또는 )에 대해 요청할 수 있습니다FRESH. |
| [공급업체 인벤토리 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | 카탈로그 수준 및 ASIN 수준에서 보고된 인벤토리 및 운영 상태 지표(예: 판매 가능한 보유 단위 및 공급업체 확인율)를 포함합니다. | Vendors | 보고서는 다양한에 대해 요청할 수 있습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [영업 및 트래픽 비즈니스 보고서](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | 날짜 및 ASIN별로 집계된 판매자의 전체 카탈로그에 대한 주요 판매 성과 지표(예: 주문한 제품 판매, 수익, 주문한 단위 및 클레임 금액) 및 페이지 트래픽 지표(예: 페이지 보기 및 구매 상자 백분율)를 포함합니다. | 판매자 | 보고서를 요청하거나 예약할 수 있습니다. 데이터는 다양한 날짜 범위 집계 수준(DAY, WEEK또는 MONTH) 및 ASIN 집계 수준(PARENT, CHILD또는 )에 대해 제공될 수 있습니다SKU. |
## Data Kiosk API
Data Kiosk API는 [GraphQL](https://graphql.org/) 기반 동적 보고 제품군을 제공합니다. 이를 통해 사용자 지정 GraphQL 쿼리를 생성하고 Amazon의 데이터 세트에서 대량 데이터에 액세스할 수 있습니다. 이 API를 사용하여 다음을 포함한 다양한 데이터에 액세스할 수 있습니다.
+ [판매자 판매 및 트래픽 데이터](#data-kiosk-api-seller-sales-traffic-data)
+ [공급업체 분석 데이터](#data-kiosk-api-vendor-analytics-data)
+ [판매자 경제 데이터](#data-kiosk-api-seller-economics-data)
다음은 Data Kiosk API의 주요 기능입니다.
+ **GraphQL 기반 동적 보고 -** API는 GraphQL 쿼리 작업을 지원하므로 사용자 지정 쿼리를 생성하여 필요한 특정 데이터를 검색할 수 있습니다.
+ **대량 데이터 액세스** - API를 통해 대규모 데이터 세트에 액세스하여 포괄적인 분석 및 보고를 용이하게 할 수 있습니다.
+ **유연한 데이터 탐색 **- GraphQL 기반 접근 방식을 사용하면 동적 애드혹 데이터 탐색이 가능합니다. 이러한 유연성은 쿼리를 반복하고 인사이트를 추출하는 데 도움이 됩니다.
+ **포괄적인 데이터 적용** 범위 - API는 광범위한 판매자 및 공급업체 데이터에 대한 액세스를 제공하여 전체적인 성능 분석 및 비즈니스 인텔리전스를 지원합니다.
Data Kiosk API의 스키마 및 명령은 특정 요구 사항에 따라 데이터를 집계하고 필터링할 수 있는 기능과 함께 GraphQL API를 통해 데이터에 액세스하는 구조화된 방법을 제공합니다. Data Kiosk API를 사용하면 판매, 트래픽 및 분석 데이터에 대한 더 심층적이고 실행 가능한 인사이트를 얻을 수 있습니다. 이를 통해 정보에 입각한 데이터 기반 결정을 내려 비즈니스 전략을 최적화할 수 있습니다.
**참고**
쿼리 보존은 요청된 필드에 따라 달라집니다. 스키마 내의 각 필드에는 해당 필드가 포함된 쿼리를 보존할 기간을 정의하는 `@resultRetention` 명령이 주석으로 추가됩니다. 쿼리에 보존 기간이 서로 다른 여러 필드가 포함된 경우 가장 짧은(최소) 보존 기간이 적용됩니다. 쿼리의 결과 문서 보존은 항상 쿼리 보존과 일치합니다.
### 판매자 판매 및 트래픽 데이터
Data Kiosk API에서 `Analytics_SalesAndTraffic_2024_04_24`는 영업 및 트래픽 쿼리의 루트 유형입니다. 이 루트 유형에는 두 가지 쿼리를 사용할 수 있습니다.
+ `salesAndTrafficByAsin`는 ASIN(`PARENT`, `CHILD`또는 )별로 집계된 판매 및 트래픽 데이터를 검색합니다`SKU`.
+ `salesAndTrafficByDate`는 날짜(`DAY`, `WEEK`또는 )별로 집계된 판매 및 트래픽 데이터를 검색합니다`MONTH`.
이러한 쿼리에 대해 다음 사항에 유의하세요.
+ `AsinGranularity` 및와 같은 열거형 유형( 열거형)은 집계 수준을 `DateGranularity`지정합니다.
+ [날짜와](https://the-guild.dev/graphql/scalars/docs/scalars/date) 같은 스칼라 형식은 데이터를 나타내는 데 사용됩니다.
### 공급업체 분석 데이터
Data Kiosk API에서 `Analytics_vendorAnalytics_2024_09_30`는 공급업체 분석 쿼리의 루트 유형입니다. 이 루트 유형에는 두 가지 뷰를 사용할 수 있습니다.
+ `manufacturingView`는 지정한 날짜별로 집계된 제조 제품에 대한 지표를 검색합니다.
+ `sourcingView`는 지정된 날짜별로 집계된 Amazon으로 직접 소싱하는 제품에 대한 지표를 검색합니다.
공급업체(`SOURCING` 또는 )로 할당된 역할을 기반으로 관련 보기 및 관련 지표에 액세스합니다`MANUFACTURING`. 이러한 쿼리에는 시작 및 종료 날짜, 마켓플레이스 식별자, 집계된 지표 및 총 지표가 포함됩니다. 이러한 쿼리에 대해 다음 사항에 유의하세요.
+ 지표는 `ManufacturingViewMetricsGroupedBy` 및 `SourcingViewMetricsGroupedBy` 유형을 사용하여 다양한 속성(예: ASIN 또는 브랜드)별로 그룹화됩니다.
+ , `costs`, `orders`, `customerSatisfaction`등의 지표 유형은 다양한 지표 그룹을 `productAvailability`나타냅니다.
+ `DateGranularity` 열거형은 날짜 집계 수준을 지정합니다.
### 판매자 경제 데이터
판매자 경제 보고서는 Amazon Marketplace의 성과와 재무에 대한 포괄적인 보기를 제공합니다. 여기에는 판매 데이터, 광고 지출, 수수료, 비용 및 순 수익이 포함됩니다. 날짜 및 제품 식별자별로 데이터를 집계할 수 있습니다.
Data Kiosk API에서 `Analytics_Economics_2024_03_15`는 판매자 경제 쿼리의 루트 유형입니다. 지정된 제품에 대한 판매자 경제 데이터는 `Economics` 유형으로 표시됩니다. 이 유형에는 다음과 같은 주요 측면이 포함됩니다.
+ `ads` - 지정된 날짜 범위 내의 제품에 대한 광고 지출 데이터입니다.
+ `cost` - 판매자가이 제품에 대해 제공하는 오프 Amazon 비용(단위당).
+ `fees` - 지정된 날짜 범위 내에 제품에 적용되는 요금입니다.
+ `fnsku` - 제품의 Fulfillment Network Stock Keeping Unit(FNSKU)입니다.
+ `msku` - 제품의 Merchant Stock Keeping Unit(MSKU)입니다.
+ `netProceeds` - 지정된 날짜 범위 내에서이 제품에 대해 순이 진행됩니다.
+ `sales` - 지정된 날짜 범위 내의 제품에 대한 판매 데이터입니다.