Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Satış API'si v1 Kullanım Senaryosu Rehberi

Satış API'si için kullanım senaryoları.

API Sürümü: v1

Satış API'si nedir?

Satışlar için Satış Ortağı API'si (Satış API'si), satıcılara satış performansı bilgileri sağlar. Bu, ayrıntı düzeyine ve alıcı türüne göre ayrılmış belirli bir dönemdeki toplu sipariş metriklerinin döndürülmesiyle gerçekleştirilir. Satış API'si işlemlerinin yanı sıra ilgili veri türleri ve şemaları hakkında daha fazla bilgi için bkz. Satış API'si Başvurusu.

Ön koşullar

Bu eğitici içeriği başarıyla tamamlamak için şunlara ihtiyacınız olacak:

  1. Adına çağrı yaptığınız satış ortağından yetkilendirme. Daha fazla bilgi için Satış Ortağı API'si uygulamalarını yetkilendirme bölümüne bakın.
  2. Geliştirici profilinize atanan Fiyatlandırma rolü.
  3. Uygulamanızın Uygulama kaydı sayfasında seçilen Fiyatlandırma rolü.

Eğitici içerik: Satış performansı bilgilerini alın

Bu bölüm, Satış API'sini kullanarak satış performansı bilgilerini alma sürecinde size yol gösterecektir.

Satış performansı bilgilerini alın

Belirli bir aralıkla ilgili toplu sipariş metriklerini almak için aşağıdaki parametrelerle getOrderMetrics işlemini çağırın:

Sorgu Parametresi:

Parametre Açıklama Zorunlu mu?
marketplaceIds

Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir.

Örneğin ATVPDKIKX0DER, ABD pazaryerini belirtir.

Tür: < dize > dizi

Evet
interval

A time interval used for selecting order metrics. This takes the form of two dates separated by two hyphens (first date is inclusive; second date is exclusive). Dates are in ISO 8601 format and must represent absolute time (either Z notation or offset notation).

Örnek: 2018-09-01T00:00:00-07:00--2018-09-04T00:00:00-07:00, -07:00 bölgesinde 1, 2 ve 3 Eylül sipariş metriklerini istiyor.

Tür: dize

Evet
granularityTimeZone

Gün sınırını belirleyen IANA uyumlu bir saat dilimi. Saatten büyük bir ayrıntı düzeyi değeri belirtirken gerekir. granularityTimeZone değeri, belirtilen aralık değerinin zaman farkına uygun olmalıdır. Örneğin, aralık değeri Z gösterimini kullanıyorsa granularityTimeZone, UTC olmalıdır. Aralık değeri, zaman farkı kullanıyorsa granularityTimeZone, farkla eşleşen IANA uyumlu bir saat dilimi olmalıdır.

Örnek: ABD/Pasifik bölgesinde yaz saatini hesaba katarak gün sınırlarını hesaplamak için ABD/Pasifik kullanın.

Tür: dize

Hayır
granularity

Bir zaman birimine göre sipariş metriklerinin gruplandırılmasına ait granularity. granularity=Hour değeri belirtildiğinde yalnızca belirtilen aralığın şu andan itibaren 30 güne eşit veya daha az olması durumunda başarılı bir istek oluşur. Diğer tüm ayrıntı düzeyleri için belirtilen aralık şu andan itibaren 2 yıl sonrasına eşit veya daha az olmalıdır. granularity=Total değerinin belirtilmesi, belirttiğiniz aralığın tamamı boyunca toplanan sipariş metrikleriyle sonuçlanır. Aralık başlangıç ve bitiş tarihi, belirtilen granularity değerine uygun değilse yanıt aralığının baş ve son ucunda kısmi veri bulunur.

Örnek: Gün sınırının granularityTimeZone tarafından tanımlandığı istek aralığının günlük dökümünü almak için gün kullanın.

Type: enum (Granularity)

Evet
buyerType

Sonuçları, B2B (işletmeler arası) veya B2C (işletmeden müşteriye) şeklinde belirttiğiniz alıcı türüne göre filtreler.

Örnek: Yanıtın yalnızca B2B alıcılara yönelik sipariş metriklerini içermesini istiyorsanız B2B kullanın.

Type: enum (BuyerType)

Hayır
fulfillmentNetwork

Sonuçları, MFN (Satıcıdan Gönderim Ağı) veya AFN (Amazon Lojistik Ağı) şeklinde belirttiğiniz gönderim ağına göre filtreler. Yanıtın tüm gönderim ağlarıyla ilgili sipariş metriklerini içermesini istiyorsanız bu filtreyi eklemeyin.

Örnek: Yanıtın yalnızca Amazon Lojistik Ağı ile ilgili sipariş metriklerini içermesini istiyorsanız AFN kullanın.

Tür: dize

Hayır
firstDayOfWeek

granularity=Week ayarlandığında haftanın başlayacağı günü belirtir. Monday veya Sunday olabilir. Varsayılan: Monday.

Örnek: Haftanın Pazar günü başlamasını istiyorsanız Sunday kullanın.

Type: enum (FirstDayOfWeek)

Hayır
asin

Sonuçları, belirttiğiniz ASIN'e göre filtreler. Hem asin hem de sku değerinin belirtilmesi hata döndürür. Yanıtın tüm ASIN'lerle ilgili sipariş metriklerini içermesini istiyorsanız bu filtreyi eklemeyin.

Örnek: Yanıtın yalnızca asin B0792R1RSN ile ilgili sipariş metriklerini içermesini istiyorsanız B0792R1RSN kullanın.

Tür: dize

Hayır
sku

Sonuçları, belirttiğiniz SKU'ya göre filtreler. Hem asin hem de sku değerinin belirtilmesi hata döndürür. Yanıtın tüm SKU'larla ilgili sipariş metriklerini içermesini istiyorsanız bu filtreyi eklemeyin.

Örnek: Yanıtın yalnızca TestSKU SKU'suyla ilgili sipariş metriklerini içermesini istiyorsanız TestSKU kullanın.

Tür: dize

Hayır

İstek örneği

GET https://sellingpartnerapi-na.amazon.com/sales/v1/orderMetrics?marketplaceIds=&interval=&granularityTimeZone=&granularity=&buyerType=&fulfillmentNetwork=&firstDayOfWeek=&asin=&sku="

Yanıt

Parametre Açıklama Zorunlu mu?
interval

İstenilen ayrıntı düzeyine göre zaman aralığı (ör. Saat, Gün vb.). Bu, listedeki ilk ya da son aralıksa ve istenen aralık, istenen ayrıntı düzeyine uymuyorsa eksik veriler içerebilir.

(ör. 2018-09-01T02:00:00Z--2018-09-04T19:00:00Z istek aralığı ve ayrıntı düzeyi günü, 1 Eylül UTC günü ve 4 Eylül UTC gününde kısmi veri olmasına neden olacaktır).

Tür: dize

Evet
unitCount

Belirtilen filtrelere göre siparişlerdeki birim sayısı.

Tür: tam sayı

Evet
orderItemCount

Belirtilen filtrelere göre sipariş ürünlerinin sayısı.

Tür: tam sayı

Evet
orderCount Belirtilen filtrelere göre sipariş sayısı.

Tür: tam sayı

Evet
averageUnitPrice Belirtilen filtrelere göre bir ürünün ortalama fiyatı. Formül, totalSales/unitCount şeklindedir.

Type: Money

Evet
totalSales Belirtilen filtrelere göre tüm siparişlerdeki toplam sipariş edilen ürün satışları.

Type: Money

Evet

Yanıt örneği

{ "request": { "parameters": { "granularity": { "value": "Day" } } }, "response": { "payload": [ { "interval": "2019-08-01T00:00-07:00--2018-08-02T00:00-07:00", "unitCount": 1, "orderItemCount": 1, "orderCount": 1, "averageUnitPrice": { "amount": "22.95", "currencyCode": "USD" }, "totalSales": { "amount": "22.95", "currencyCode": "USD" } }, { "interval": "2019-08-02T00:00-07:00--2018-08-03T00:00-07:00", "unitCount": 1, "orderItemCount": 1, "orderCount": 1, "averageUnitPrice": { "amount": "2.05", "currencyCode": "USD" }, "totalSales": { "amount": "2.05", "currencyCode": "USD" } } ] } }

Bu sayfa size yardımcı oldu mu?