Listing
commerce.listingUnifiedIn arrivoUna scheda prodotto su un marketplace: quanto costa, come si posiziona, cosa dicono gli acquirenti e quanto vende, con il negozio e l'azienda che ci sono dietro.
11 marketplace5 chiamate previste53 campichiave marketplace + ID schedaSi parte da Amazon e TikTok Shop
Dove si colloca Listing
Variant e Offer- venduto con il
Brand - classificato in
Category - si posiziona per
Keyword - presente in un
VideooLiveStreamdi unCreator - può interferire con un
IPRight - negozio citato in un
Case
5 chiamate previsteIn arrivo
Chiamate tratte dalla specifica dell'API e-commerce 0.1.0-draft, scritte come percorsi REST. Ogni chiamata restituisce questa entità con la stessa struttura sulle piattaforme che elenca, e nessuna è ancora in produzione.
- GET
/Una scheda prodotto con le Variant e le Offer restituite dalla fonteTikTok Shop · AmazonProgettatav1/ e-commerce/ listings/ {listingId} - GET
/Cerca schede prodotto su un marketplace; ogni piattaforma ha i suoi filtriTikTok Shop · AmazonProgettatav1/ e-commerce/ listings/ search - GET
/Trova schede prodotto candidate da una foto, senza dare per scontato che siano lo stesso articoloTikTok Shop · AmazonProgettatav1/ e-commerce/ listings/ search-by-image - GET
/Classifiche dei best seller per categoria e dataTikTok Shop · AmazonProgettatav1/ e-commerce/ listings/ rankings - GET
/Video che promuovono una scheda prodottoTikTok ShopProgettatav1/ e-commerce/ tiktok-shop/ listings/ {listingId}/ videos
Campi
I campi principali per tipo. Quelli osservabili usano le chiavi del contratto; il contratto completo è più sotto.
Osservabile
Uno snapshot recente, altrimenti una lettura in tempo reale, altrimenti la fonte successivaAddebito: Quando arriva- titlestringQuando arriva
- imagesobject[]Quando arriva
- related.categoriesuuid[]La categoria più specifica confermata, nella tassonomia propria del marketplaceQuando arriva
- rating.scoredecimal0 può significare che non ci sono ancora valutazioniQuando arriva
- review.countintegerSolo recensioni scritte; le valutazioni con sole stelle vanno in rating.countQuando arriva
- lifecycle.launch_datedateLa data riportata dalla fonte, non quella in cui AIsa ha visto la pagina per la prima voltaQuando arriva
- relation.shop_iduuidIl negozio che l'ha pubblicata. Su Amazon, il venditore dell'Offerta in evidenza non viene considerato il titolareQuando arriva
- related.offersuuid[]Prezzo, disponibilità e consegna stanno in ogni OfferQuando arriva
- metrics.sales_countdecimalTotale o per periodo, come lo conta la fonte; due fonti non vengono mai sommateQuando arriva
- metrics.video_countintegerVideo che promuovono il prodotto nel periodo, non visualizzazioniQuando arriva
Stimato
Uno stimatore di default, fino a tre a confrontoAddebito: Per queryVerificabile
Una fonte alla volta, finché una risposta supera un controlloAddebito: Quando supera il controlloElenchi e rischio
Uniti da più fonti; basta un riscontro per segnalareAddebito: Per riga45 campi nel contratto dei campiSpecifica 0.1.0-draft · listing-contract-v3.2
Le chiavi dei campi e il formato di ogni valore, come li definisce la specifica. Tornano solo i campi che una fonte ha effettivamente restituito.
Identità5
L'ID AIsa, la piattaforma, il sito e l'ID proprio della piattaformaentity.iduuidentity.kindstringentity.platformstringentity.scopestringentity.native_idstring
Pagina11
Titolo, link, immagini e ciò che mostra la paginatitlestringurlurlimagesobject[]image.cover_urlurldescription.blocksobject[]attributes.listobject[]status.availabilitystringlifecycle.launch_datedatebadgesstring[]affiliate.commission_ratedecimaloption_groupsobject[]
Valutazioni5
Valutazione e numero di recensioni, tenuti separatirating.scoredecimalrating.countintegerrating.distributionobject[]review.summarystringreview.countinteger
Metriche17
Vendite, GMV e interazioni, ciascuna sul periodo della sua fontemetrics.sales_countdecimalmetrics.gmvdecimalmetrics.gmv_totaldecimalmetrics.creator_countintegermetrics.video_countintegermetrics.live_countintegermetrics.video_view_countintegermetrics.creator_order_ratedecimalmetrics.gmv_trendobject
Mostra altri 8 campiMostra meno
metrics.video_average_views_reporteddecimalmetrics.video_gpm_reporteddecimalmetrics.video_conversion_reporteddecimalmetrics.live_average_viewers_reporteddecimalmetrics.ad_gmv_reporteddecimalmetrics.ad_cost_reporteddecimalmetrics.seller_creator_sales_count_30ddecimalmetrics.seller_creator_gmv_30ddecimal
Collegamenti7
Gli ID AIsa delle entità a cui puntarelation.shop_iduuidrelated.variantsuuid[]related.variant_listingsuuid[]related.parent_listingsuuid[]related.child_listingsuuid[]related.offersuuid[]related.categoriesuuid[]
I valori decimal e integer arrivano come stringhe per mantenere la precisione. Una chiave che termina in _reported è il dato proprio della fonte, con metodo di calcolo non confermato; _raw conserva il codice grezzo della fonte. I campi uuid puntano ad altre entità AIsa.
Per marketplace
Dove esistono cinque o più stimatori, le vendite arrivano affiancate e vengono calibrate per prime. Altrove si parte con due a confronto, o con una sola fonte indicata come tale.
| Marketplace | Chiave della scheda | Letture in tempo reale | Stimatori | Stime di vendita | Stato |
|---|---|---|---|---|---|
| Amazon | amazon:US · ASIN | 4 | 6 | Affiancate, calibrate | Disponibile |
| TikTok Shop | tiktok-shop:US · product_id | 1 | 5 | Affiancate, calibrate | Disponibile |
| Temu | temu:US · goods_id | — | 3 | Affiancate | In arrivo |
| Walmart | walmart:US · item ID | 1 | 2 | Due a confronto | In arrivo |
| Shopee | shopee:SG · item_id | 1 | 2 | Due a confronto | In arrivo |
| Ozon | ozon:RU · SKU | — | 2 | Due a confronto | In arrivo |
| Mercado Libre | mercadolibre:BR · item ID | — | 2 | Due a confronto | In arrivo |
| Etsy | etsy:US · listing_id | 1 | 1 | Una fonte, sempre indicata | In arrivo |
| Shopify | shopify:{store} · product ID | — | 1 | Una fonte, sempre indicata | In arrivo |
| eBay | ebay:US · item ID | 1 | — | Solo letture in tempo reale | In arrivo |
| 1688 | 1688:CN · offerId | — | 2 | Elenchi di fornitori uniti | In arrivo |
I conteggi vengono dall'elenco dei fornitori della prima fase. Il tasso di compilazione di ogni campo comparirà qui quando il marketplace sarà attivo.
Cosa resta fisso
AIsa può sostituire in qualsiasi momento le fonti dietro un campo. Questi punti non cambiano.
- La chiave è l'ID proprio del marketplace, salvato esattamente come lo ha emesso il marketplace.
- Un ID assegnato da AIsa non viene mai cambiato né riutilizzato.
- Due fonti che contano in modo diverso restano due metriche, e i valori grezzi vengono conservati.
- I campi vengono solo aggiunti. Un cambio di significato arriva come nuova versione, e quella vecchia resta disponibile per un periodo.