Listing

commerce.listingUnified近日公開

1 つのマーケットプレイスにある 1 つの商品ページ：価格、順位、購入者の評価、販売数と、背後のショップと企業。

11 のマーケットプレイス予定の呼び出し 5 件53 件のフィールドキー マーケットプレイス + 商品ページ IDAmazon と TikTok Shop から先行

Listing の位置づけ

Productすべてのマーケットプレイスで同じ商品
信頼度スコア付きで関連付け
Listing1 つのマーケットプレイスの 1 ページVariant と Offer を含む
販売元
Shopそのマーケットプレイスの販売者アカウント
運営元
Organization企業。ブランド所有者やサプライヤーでもある
  • Brand の名前で販売
  • Category に分類
  • Keyword で順位が付く
  • Creator の Video や LiveStream で紹介
  • IPRight に抵触する可能性
  • ショップが Case で名指し

5 件の呼び出しを予定近日公開

EC API 設計 0.1.0-draft の呼び出しを REST パスとして記載しています。各呼び出しは、記載のプラットフォームでこのエンティティを同じ形式で返します。まだどれもデプロイされていません。

  • GET/v1/e-commerce/listings/{listingId}1 件の商品ページと、ソースが返した Variant と OfferTikTok Shop · Amazon設計済み
  • GET/v1/e-commerce/listings/search1 つのマーケットプレイスで商品ページを検索。フィルターはプラットフォームごとに異なるTikTok Shop · Amazon設計済み
  • GET/v1/e-commerce/listings/search-by-image商品写真から候補の商品ページを探す。同じ商品だとは仮定しないTikTok Shop · Amazon設計済み
  • GET/v1/e-commerce/listings/rankingsカテゴリと日付別のベストセラーランキングTikTok Shop · Amazon設計済み
  • GET/v1/e-commerce/tiktok-shop/listings/{listingId}/videos1 つの商品ページを宣伝する動画TikTok Shop設計済み

フィールド

主なフィールドを種類別に掲載しています。観測可能なフィールドはフィールド仕様のキー名で示し、仕様の全体はその後に掲載します。

種類でフィールドを絞り込む

観測可能

新しいスナップショット、なければリアルタイム取得、それもなければ次のソース課金：値が返ったとき

推定

既定は推定元 1 つ、最大 3 つを並べて課金：クエリごと

検証可能

ソースを 1 つずつ、回答がチェックを通るまで課金：チェックを通ったとき

リストとリスク

複数のソースから集約。1 件ヒットすればフラグを立てる課金：行ごと

フィールド仕様に含まれる 45 件のフィールド設計 0.1.0-draft · listing-contract-v3.2

設計で定義されたフィールドキーと、各値の書き方です。ソースが実際に返したフィールドだけが返ります。

識別情報5

AIsa の ID、プラットフォーム、サイト、プラットフォーム独自の ID
  • entity.iduuid
  • entity.kindstring
  • entity.platformstring
  • entity.scopestring
  • entity.native_idstring

ページ11

タイトル、リンク、画像、ページの表示内容
  • titlestring
  • urlurl
  • imagesobject[]
  • image.cover_urlurl
  • description.blocksobject[]
  • attributes.listobject[]
  • status.availabilitystring
  • lifecycle.launch_datedate
  • badgesstring[]
  • affiliate.commission_ratedecimal
  • option_groupsobject[]

評価5

評価数とレビュー数は分けて保持
  • rating.scoredecimal
  • rating.countinteger
  • rating.distributionobject[]
  • review.summarystring
  • review.countinteger

指標17

販売数、GMV、エンゲージメント。それぞれソースの期間にもとづく
  • 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 件のフィールドを表示
  • 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

関連7

参照先エンティティの AIsa ID
  • relation.shop_iduuid
  • related.variantsuuid[]
  • related.variant_listingsuuid[]
  • related.parent_listingsuuid[]
  • related.child_listingsuuid[]
  • related.offersuuid[]
  • related.categoriesuuid[]

decimal と integer の値は、精度を保つため文字列で返ります。_reported で終わるキーはソース自身の数値で、算出方法は未確認です。_raw はソースの生のコードを保持します。uuid フィールドはほかの AIsa エンティティを指します。

マーケットプレイス別

推定元が 5 つ以上あるマーケットプレイスでは、販売数を並べて返し、最初にキャリブレーションします。それ以外は 2 つの比較、または出典を明記した 1 つのソースから始めます。

マーケットプレイスListing のキーリアルタイム取得推定元販売数の推定ステータス
Amazonamazon:US · ASIN46並べて表示、キャリブレーション済み提供中
TikTok Shoptiktok-shop:US · product_id15並べて表示、キャリブレーション済み提供中
Temutemu:US · goods_id—3並べて表示近日公開
Walmartwalmart:US · item ID122 つを比較近日公開
Shopeeshopee:SG · item_id122 つを比較近日公開
Ozonozon:RU · SKU—22 つを比較近日公開
Mercado Libremercadolibre:BR · item ID—22 つを比較近日公開
Etsyetsy:US · listing_id11単一ソース、ラベル付き近日公開
Shopifyshopify:{store} · product ID—1単一ソース、ラベル付き近日公開
eBayebay:US · item ID1—リアルタイム取得のみ近日公開
16881688:CN · offerId—2サプライヤー一覧を統合近日公開

件数はフェーズ 1 のサプライヤーリストにもとづきます。フィールドごとの充足率は、各マーケットプレイスの提供開始後にここに表示します。

変わらないこと

AIsa はフィールドの背後のソースをいつでも入れ替えられます。次の点は変わりません。

  1. キーはマーケットプレイス独自の ID で、マーケットプレイスが発行したとおりに保存します。
  2. AIsa が発行した ID は変更も再利用もしません。
  3. 数え方の異なる 2 つのソースは 2 つの指標のまま扱い、生の値も保持します。
  4. フィールドは追加されるだけです。意味が変わる場合は新しいバージョンとして提供し、旧バージョンもしばらく残します。

Listing の関連エンティティ

商品ページからのリンクはどれも、同じ呼び出しで取得できるフィールドです。

  • Product

    1 つの商品、すべてのマーケットプレイス

  • Shop

    マーケットプレイス + 販売者 ID

  • Organization

    統一社会信用コード · D-U-N-S

  • Brand

    商標登録番号 + 名称

  • Keyword

    マーケットプレイス + 検索語

  • Category

    分類体系 + コード

カタログを検索

プラットフォーム、Unified エンティティ、ベンダー API、エンドポイント、コネクタ。