Amazon Selling Partner를 통해 사용 가능한 데이터 API - AWS 권장 가이드
보고서 API데이터 키오스크 API

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Selling Partner를 통해 사용 가능한 데이터 API

Amazon Selling PartnerAPI(SP-API)는 Amazon 판매자와 공급업체가 주문, 배송, 결제 등에 대한 데이터에 프로그래밍 방식으로 액세스할 수 API 있도록 지원하는 REST기반입니다. 이를 통해 얻은 데이터는 판매 효율성을 높이고, 노동 요구 사항을 줄이고, 고객에 대한 응답 시간을 개선할 API 수 있습니다. 이 안내서는 Selling Partner API for Reports(보고서 API) 및 Selling Partner API for Data Kiosk(데이터 키오스크 )를 통해 액세스할 수 있는 데이터에 중점을 둡니다API.

보고서 API

보고서의 데이터는 Amazon 마켓플레이스에서 비즈니스를 관리하는 데 도움이 되도록 API 설계되었습니다. 분석 보고서는 다음과 같은 제품, 고객 및 전반적인 성능에 대한 귀중한 통찰력을 제공합니다.

  • 판매 성과 - 판매 데이터를 분석하면 추세와 고객 구매 패턴을 식별하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 판매 전략을 최적화할 수 있습니다.

  • 제품 성능 - 제품 데이터를 분석하면 어떤 제품이 잘 판매되고 있고 어떤 제품이 잘 판매되지 않는지 식별하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 제품을 최적화할 수 있습니다.

  • 고객 행동 - 고객 데이터를 분석하면 고객의 선호도와 요구 사항을 이해하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 마케팅 및 영업 전략을 개인화할 수 있습니다.

다음 표에서는 각 브랜드 분석 보고서를 설명합니다. 다음 보고서는 브랜드 분석 판매 파트너 API 역할을 가지고 있고 Amazon 브랜드 레지스트리에 등록된 Amazon 판매자 및 공급업체가 사용할 수 있습니다.

보고서 설명 파라미터
시장 장바구니 분석 보고서 결제 시 고객의 장바구니(카트)에 있는 항목과 함께 가장 일반적으로 구매되는 항목에 대한 데이터를 제공합니다. 보고서는 다양한 보고 기간(DAY, WEEK, MONTH또는 )에 대해 요청할 수 있습니다QUARTER. 데이터는 해당 기간 동안 제공됩니다.
Amazon 검색어 보고서 검색 키워드 및 마켓플레이스 부서별로 가장 자주 선택한 Amazon 표준 식별 번호(ASINs)에 대한 데이터를 포함합니다. 보고서는 다양한 보고 기간(DAY, WEEK, MONTH또는 )에 대해 요청할 수 있습니다QUARTER. 요청은 여러 보고 기간에 걸쳐 있을 수 없습니다.
반복 구매 보고서 판매 파트너의 품목에 대한 반복 구매량에 대한 데이터를 포함합니다. 보고서는 다양한 보고 기간(WEEK, MONTH또는 )에 대해 요청할 수 있습니다QUARTER. 데이터는 여러 보고 기간에 걸쳐 있을 수 있습니다.

다음 표에서는 각 공급업체 소매 분석 및 판매자 소매 분석 보고서를 설명합니다.

보고서 설명 가용성 파라미터
Rapid Retail Analytics 인벤토리 보고서 ASIN 수준별 인벤토리 데이터를 포함하며 시간별 세분화로 집계됩니다. 공급업체 보고서는 요청만 가능합니다. 데이터는 현재 날짜를 포함하여 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다.
Rapid Retail Analytics 트래픽 보고서 시간별로 세분화하여 공급업체 항목의 세부 정보 페이지로 이동하는 고객 트래픽에 대한 데이터를 포함합니다. 공급업체 보고서는 요청만 가능합니다. 데이터는 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다.
Rapid Retail Analytics 판매 보고서 판매 데이터를 한 ASIN 수준에서 시간별 세분화로 집계하여 포함합니다. 공급업체 보고서는 요청만 가능합니다. 데이터는 여러 날짜 범위 기간에 걸쳐 있을 수 있습니다.
공급업체 판매 보고서 카탈로그 수준 및 ASIN 수준에서 보고된 주요 소매 판매 지표(예: 주문 및 배송된 수익 및 단위)를 포함합니다. 공급업체

보고서는 다음과 같이 다양한 에 대해 요청할 수 있습니다.

  • 보고 기간(DAY, WEEK, MONTHQUARTER, 또는 YEAR)

  • 총판 보기(MANUFACTURING 또는 SOURCING)

  • 판매 프로그램(RETAIL, BUSINESS또는 FRESH)
Net Pure 제품 마진 보고서 카탈로그 수준 및 ASIN 수준에서 보고된 공급업체의 항목을 판매하기 위한 Amazon의 순 순수 제품 마진에 대한 데이터를 포함합니다. 공급업체 보고서는 다양한 보고 기간(DAY, , WEEK, MONTH QUARTER또는 )에 대해 요청할 수 있습니다YEAR.
공급업체 트래픽 보고서 카탈로그 수준 및 ASIN 수준에서 보고된 개요 보기와 같은 주요 소매 트래픽 지표가 포함됩니다. 공급업체 보고서는 다양한 보고 기간(DAY, , WEEK, MONTH QUARTER또는 )에 대해 요청할 수 있습니다YEAR.
공급업체 예측 보고서 가장 최근의 주간 예측 생성일에 대한 ASIN 수준에서 보고된 미래 예측 평균, 이전 70, 이전 80 및 이전 90 주간 고객 수요 예측을 포함합니다. 공급업체 보고서는 다양한 판매 프로그램(RETAIL 또는 )에 대해 요청할 수 있습니다FRESH.
공급업체 인벤토리 보고서 카탈로그 수준 및 ASIN 수준에서 보고된 인벤토리 및 운영 상태 지표(예: 판매 가능한 보유 단위 및 공급업체 확인률)를 포함합니다. 공급업체

보고서는 다음과 같이 다양한 에 대해 요청할 수 있습니다.

  • 보고 기간(DAY, WEEK, MONTHQUARTER, 또는 YEAR)

  • 총판 보기(MANUFACTURING 또는 SOURCING)

  • 판매 프로그램(RETAIL 또는 FRESH)
영업 및 트래픽 비즈니스 보고서 판매자의 전체 카탈로그에 대한 주요 판매 성과 지표(예: 주문한 제품 판매, 수익, 주문한 단위 및 클레임 금액) 및 페이지 트래픽 지표(예: 페이지 보기 및 바이박스 백분율)를 날짜 및 별로 집계하여 포함합니다. ASIN 판매자 보고서를 요청하거나 예약할 수 있습니다. 데이터는 서로 다른 날짜 범위 집계 수준(DAY, WEEK또는 MONTH) 및 ASIN 집계 수준(PARENT, CHILD또는 )에 제공할 수 있습니다SKU.

데이터 키오스크 API

Data Kiosk는 GraphQL 기반 동적 보고 제품군을 API 제공합니다. 사용자 지정 GraphQL 쿼리를 생성하고 Amazon의 데이터 세트에서 대량 데이터에 액세스하는 데 도움이 됩니다. 이를 사용하여 다음과 같은 다양한 데이터에 API 액세스할 수 있습니다.

다음은 Data Kiosk 의 주요 기능입니다API.

  • GraphQL 기반 동적 보고 - API는 GraphQL 쿼리 작업을 지원하므로 사용자 지정 쿼리를 생성하여 필요한 특정 데이터를 검색할 수 있습니다.

  • 대량 데이터 액세스 - 를 통해 대규모 데이터 세트에 액세스할 수 있으므로 포괄적인 분석 및 보고가 API용이합니다.

  • 유연한 데이터 탐색 - GraphQL 기반 접근 방식을 통해 동적 임시 데이터 탐색이 가능합니다. 이러한 유연성은 쿼리를 반복하고 인사이트를 추출하는 데 도움이 됩니다.

  • 포괄적인 데이터 적용 범위 - API는 광범위한 판매자 및 공급업체 데이터에 대한 액세스를 제공하여 전체 성능 분석 및 비즈니스 인텔리전스를 지원합니다.

Data Kiosk의 스키마 및 지침은 GraphQL 을 통해 데이터에 액세스하는 구조화된 방법을 API 제공하며API, 특정 요구 사항에 따라 데이터를 집계하고 필터링할 수 있습니다. Data Kiosk를 사용하면 영업API, 트래픽 및 분석 데이터에 대한 더 심층적이고 실행 가능한 인사이트를 얻을 수 있습니다. 이를 통해 정보에 입각한 데이터 기반 결정을 내려 비즈니스 전략을 최적화할 수 있습니다.

참고

쿼리 보존은 요청된 필드에 따라 달라집니다. 스키마 내의 각 필드에는 해당 필드가 포함된 쿼리가 보존되는 기간을 정의하는 @resultRetention 지시문이 주석으로 달립니다. 쿼리에 보존 기간이 다른 필드가 여러 개 포함된 경우 최단(최소) 보존 기간이 적용됩니다. 쿼리의 결과 문서의 보존은 항상 쿼리의 보존과 일치합니다.

판매자 판매 및 트래픽 데이터

Data Kiosk 에서 APIAnalytics_SalesAndTraffic_2024_04_24는 판매 및 트래픽 쿼리의 루트 유형입니다. 이 루트 유형에는 두 가지 쿼리를 사용할 수 있습니다.

  • salesAndTrafficByAsin 는 ASIN (PARENT, CHILD또는 )로 집계된 판매 및 트래픽 데이터를 검색합니다SKU.

  • salesAndTrafficByDate 는 날짜(DAY, WEEK또는 )별로 집계된 판매 및 트래픽 데이터를 검색합니다MONTH.

이러한 쿼리에 대해서는 다음 사항에 유의하세요.

  • AsinGranularity 및 와 같은 열거형 유형( 열거형)은 집계 수준을 DateGranularity지정합니다.

  • 날짜 와 같은 스칼라 유형은 데이터를 나타내는 데 사용됩니다.

공급업체 분석 데이터

Data Kiosk 에서 APIAnalytics_vendorAnalytics_2024_09_30는 공급업체 분석 쿼리의 루트 유형입니다. 이 루트 유형에는 두 가지 뷰를 사용할 수 있습니다.

  • manufacturingView 는 지정한 날짜까지 집계된 제조 제품에 대한 지표를 검색합니다.

  • sourcingView 는 지정된 날짜까지 집계되어 Amazon에 직접 소싱하는 제품에 대한 지표를 검색합니다.

공급업체( 또는 )SOURCING로 할당된 역할을 기반으로 관련 보기 및 관련 지표에 액세스합니다MANUFACTURING. 이러한 쿼리에는 시작 및 종료 날짜, 마켓플레이스 식별자, 집계된 지표 및 총 지표가 포함됩니다. 이러한 쿼리에 대해서는 다음 사항에 유의하세요.

  • 지표는 ManufacturingViewMetricsGroupedBy 및 SourcingViewMetricsGroupedBy 유형을 사용하여 다양한 속성(예: ASIN 또는 브랜드)별로 그룹화됩니다.

  • , costs, customerSatisfaction및 orders와 같은 지표 유형은 서로 다른 지표 그룹을 productAvailability나타냅니다.

  • DateGranularity 열거형은 날짜 집계 수준을 지정합니다.

판매자 경제학 데이터

판매자 경제학 보고서는 Amazon 마켓플레이스의 성과 및 재무에 대한 포괄적인 보기를 제공합니다. 여기에는 판매 데이터, 광고 지출, 요금, 비용 및 순 수익이 포함됩니다. 날짜 및 제품 식별자별로 데이터를 집계할 수 있습니다.

Data Kiosk 에서 APIAnalytics_Economics_2024_03_15는 판매자 경제 쿼리의 루트 유형입니다. 지정된 제품의 판매자 경제학 데이터는 Economics 유형으로 표시됩니다. 이 유형에는 다음과 같은 주요 측면이 포함됩니다.

  • ads - 지정된 날짜 범위 내의 제품에 대한 광고 지출 데이터입니다.

  • cost - 판매자가 이 제품에 대해 제공한 Amazon 비용 외(단위당)입니다.

  • fees - 지정된 날짜 범위 내에 제품에 적용되는 요금입니다.

  • fnsku - 제품의 Fulfillment Network Stock Keeping Unit(FNSKU)입니다.

  • msku - 제품의 가맹점 재고 보관 단위(MSKU)입니다.

  • netProceeds - 지정된 날짜 범위 내에서 이 제품에 대한 순 수익률입니다.

  • sales - 지정된 날짜 범위 내의 제품에 대한 판매 데이터입니다.