View a markdown version of this page

Amazon Selling Partner API를 통해 사용 가능한 데이터 - AWS 권장 가이드
보고서 APIData Kiosk API

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

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

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

보고서 API

보고서 API의 데이터는 Amazon Marketplace에서 비즈니스를 관리하는 데 도움이 되도록 설계되었습니다. 분석 보고서는 다음과 같이 제품, 고객 및 전반적인 성능에 대한 중요한 인사이트를 제공합니다.

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

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

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

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

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

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

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

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

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

  • 배포자 보기(MANUFACTURING 또는 SOURCING)

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

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

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

  • 배포자 보기(MANUFACTURING 또는 SOURCING)

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

Data Kiosk API

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

다음은 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지정합니다.

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

공급업체 분석 데이터

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 - 지정된 날짜 범위 내의 제품에 대한 판매 데이터입니다.