Listing

commerce.listingUnifiedYakında

Tek pazaryerindeki tek ürün sayfası: fiyatı, sıralaması, alıcıların ne dediği ve ne kadar sattığı; arkasındaki mağaza ve şirketle birlikte.

11 pazaryeri5 planlanan çağrı53 alanbirincil anahtar pazaryeri + ürün sayfası ID'siÖnce Amazon ve TikTok Shop

Listing'in diğer varlıklarla bağlantısı

ProductHer pazaryerinde aynı ürün

güven puanıyla bağlı

ListingTek pazaryerinde tek sayfaVariant ve Offer içerir

satan

ShopO pazaryerindeki satıcı hesabı

işleten

OrganizationŞirket; aynı zamanda marka sahibi veya tedarikçi

Brand altında satılır
Category içinde yer alır
Keyword için sıralanır
bir Creator tarafından bir Video veya LiveStream içinde öne çıkarılır
bir IPRight ile çakışabilir
mağazanın adı bir Case içinde geçer

5 çağrı planlıYakında

Çağrılar, e-ticaret API tasarımının 0.1.0-draft sürümünden alındı ve REST yolları olarak yazıldı. Her çağrı bu varlığı, listelediği platformlarda tek bir yapıda döndürür; hiçbiri henüz devreye alınmadı.

GET/v1/e-commerce/listings/{listingId}Kaynağın döndürdüğü Variant ve Offer kayıtlarıyla tek bir ürün sayfasıTikTok Shop · AmazonTasarlandı
GET/v1/e-commerce/listings/searchTek pazaryerinde ürün sayfası arar; her platformun kendi filtreleri vardırTikTok Shop · AmazonTasarlandı
GET/v1/e-commerce/listings/search-by-imageBir ürün fotoğrafından aday ürün sayfaları bulur, bunların aynı ürün olduğunu varsaymazTikTok Shop · AmazonTasarlandı
GET/v1/e-commerce/listings/rankingsKategoriye ve tarihe göre çok satanlar sıralamasıTikTok Shop · AmazonTasarlandı
GET/v1/e-commerce/tiktok-shop/listings/{listingId}/videosBir ürün sayfasını tanıtan videolarTikTok ShopTasarlandı

Alanlar

Türe göre ana alanlar. Gözlemlenebilir alanlar sözleşmenin anahtarlarını kullanır; tam sözleşme aşağıda.

Gözlemlenebilir

Güncel bir anlık görüntü, yoksa canlı okuma, o da olmazsa sıradaki kaynakÜcretlendirme: Değer döndüğünde

Tahmini

Varsayılan olarak tek tahmin kaynağı, en fazla üçü yan yanaÜcretlendirme: Sorgu başına

Doğrulanabilir

Bir yanıt kontrolden geçene kadar kaynaklar tek tek denenirÜcretlendirme: Kontrolden geçtiğinde

Listeler ve risk

Birkaç kaynaktan birleştirilir; işaretlemek için tek eşleşme yeterÜcretlendirme: Satır başına

Alan sözleşmesinde 45 alanTasarım 0.1.0-draft · listing-contract-v3.2

Tasarımın tanımladığı alan anahtarları ve her değerin nasıl yazıldığı. Yalnızca bir kaynağın gerçekten döndürdüğü alanlar gelir.

Kimlik5

AIsa ID'si, platform, site ve platformun kendi ID'si

entity.iduuid
entity.kindstring
entity.platformstring
entity.scopestring
entity.native_idstring

Sayfa11

Başlık, bağlantı, görseller ve sayfada gösterilenler

titlestring
urlurl
imagesobject[]
image.cover_urlurl
description.blocksobject[]
attributes.listobject[]
status.availabilitystring
lifecycle.launch_datedate
badgesstring[]
affiliate.commission_ratedecimal
option_groupsobject[]

Puanlar5

Puan ve değerlendirme sayıları, ayrı ayrı

rating.scoredecimal
rating.countinteger
rating.distributionobject[]
review.summarystring
review.countinteger

Metrikler17

Satışlar, GMV ve etkileşim, her biri kaynağının döneminde

metrics.sales_countdecimal
metrics.gmvdecimal
metrics.gmv_totaldecimal
metrics.creator_countinteger
metrics.video_countinteger
metrics.live_countinteger
metrics.video_view_countinteger
metrics.creator_order_ratedecimal
metrics.gmv_trendobject

8 alan daha göster

metrics.video_average_views_reporteddecimal
metrics.video_gpm_reporteddecimal
metrics.video_conversion_reporteddecimal
metrics.live_average_viewers_reporteddecimal
metrics.ad_gmv_reporteddecimal
metrics.ad_cost_reporteddecimal
metrics.seller_creator_sales_count_30ddecimal
metrics.seller_creator_gmv_30ddecimal

Bağlantılar7

İşaret ettiği varlıkların AIsa ID'leri

relation.shop_iduuid
related.variantsuuid[]
related.variant_listingsuuid[]
related.parent_listingsuuid[]
related.child_listingsuuid[]
related.offersuuid[]
related.categoriesuuid[]

decimal ve integer değerler, hassasiyeti korumak için dize olarak gelir. _reported ile biten bir anahtar kaynağın kendi rakamıdır ve hesaplama yöntemi doğrulanmamıştır; _raw kaynağın ham kodunu korur. uuid alanları diğer AIsa varlıklarını gösterir.

Pazaryerine göre

Beş veya daha fazla tahmin kaynağı olan yerlerde satışlar yan yana gelir ve önce bunlar kalibre edilir. Diğer yerlerde iki kaynak karşılaştırılarak ya da tek kaynakla, bu belirtilerek başlanır.

Pazaryeri	Listing anahtarı	Canlı okuma	Tahmin kaynakları	Satış tahminleri	Durum
Amazon	`amazon:US · ASIN`	4	6	Yan yana, kalibre edilmiş	Yayında
TikTok Shop	`tiktok-shop:US · product_id`	1	5	Yan yana, kalibre edilmiş	Yayında
Temu	`temu:US · goods_id`	—	3	Yan yana	Yakında
Walmart	`walmart:US · item ID`	1	2	İki kaynak, karşılaştırmalı	Yakında
Shopee	`shopee:SG · item_id`	1	2	İki kaynak, karşılaştırmalı	Yakında
Ozon	`ozon:RU · SKU`	—	2	İki kaynak, karşılaştırmalı	Yakında
Mercado Libre	`mercadolibre:BR · item ID`	—	2	İki kaynak, karşılaştırmalı	Yakında
Etsy	`etsy:US · listing_id`	1	1	Tek kaynak, etiketli	Yakında
Shopify	`shopify:{store} · product ID`	—	1	Tek kaynak, etiketli	Yakında
eBay	`ebay:US · item ID`	1	—	Yalnızca canlı okuma	Yakında
1688	`1688:CN · offerId`	—	2	Tedarikçi listeleri, birleştirilmiş	Yakında

Sayılar birinci aşama sağlayıcı listesinden gelir. Alan başına doluluk oranı, her pazaryeri yayına girdiğinde burada gösterilecek.

Sabit kalanlar

AIsa bir alanın arkasındaki kaynakları istediği zaman değiştirebilir. Aşağıdakiler ise değişmez.

Anahtar, pazaryerinin kendi ID'sidir ve pazaryerinin verdiği haliyle aynen saklanır.
AIsa'nın verdiği bir ID asla değiştirilmez veya yeniden kullanılmaz.
Farklı sayan iki kaynak iki ayrı metrik olarak kalır ve ham değerler saklanır.
Şemaya yalnızca yeni alan eklenir. Anlamı değişen bir alan yeni bir sürüm olarak yayımlanır, eskisi bir süre korunur.

Listing ile bağlantılı varlıklar

Bir ürün sayfasından çıkan her bağlantı, aynı çağrıda isteyebileceğiniz bir alandır.

Product
tek ürün, tüm pazaryerleri
Shop
pazaryeri + satıcı ID'si
Organization
USCC · D-U-N-S
Brand
marka tescil no. + ad
Keyword
pazaryeri + terim
Category
taksonomi + kod