Listing
commerce.listingUnifiedPróximamenteUna ficha de producto en un marketplace: cuánto cuesta, en qué posición está, qué dicen los compradores y cuánto vende, con la tienda y la empresa que hay detrás.
11 marketplaces5 llamadas previstas53 camposclave marketplace + ID de la fichaPrimero Amazon y TikTok Shop
Dónde se ubica Listing
Variant y Offer- se vende bajo
Brand - clasificada en
Category - se posiciona para
Keyword - aparece en un
VideooLiveStreamde unCreator - puede chocar con un
IPRight - tienda nombrada en un
Case
5 llamadas previstasPróximamente
Llamadas del diseño de la API de e-commerce 0.1.0-draft, escritas como rutas REST. Cada llamada devuelve esta entidad con la misma estructura en las plataformas que indica, y ninguna está desplegada todavía.
- GET
/Una ficha de producto con las variantes y ofertas que devolvió la fuenteTikTok Shop · AmazonDiseñadav1/ e-commerce/ listings/ {listingId} - GET
/Buscar fichas en un marketplace; cada plataforma tiene sus propios filtrosTikTok Shop · AmazonDiseñadav1/ e-commerce/ listings/ search - GET
/Encontrar fichas candidatas a partir de una foto del producto, sin suponer que son el mismo artículoTikTok Shop · AmazonDiseñadav1/ e-commerce/ listings/ search-by-image - GET
/Rankings de más vendidos por categoría y fechaTikTok Shop · AmazonDiseñadav1/ e-commerce/ listings/ rankings - GET
/Videos que promocionan una fichaTikTok ShopDiseñadav1/ e-commerce/ tiktok-shop/ listings/ {listingId}/ videos
Campos
Los campos principales por tipo. Los observables usan las claves del contrato; el contrato completo va a continuación.
Observable
Un snapshot reciente; si no, una lectura en vivo; si no, la siguiente fuenteCobro: Cuando llega un resultado- titlestringCuando llega un resultado
- imagesobject[]Cuando llega un resultado
- related.categoriesuuid[]La categoría más específica confirmada, en la taxonomía propia del marketplaceCuando llega un resultado
- rating.scoredecimal0 puede significar que aún no tiene calificacionesCuando llega un resultado
- review.countintegerSolo reseñas escritas; las calificaciones con solo estrellas van a rating.countCuando llega un resultado
- lifecycle.launch_datedateLa fecha que reporta la fuente, no cuándo AIsa vio la página por primera vezCuando llega un resultado
- relation.shop_iduuidLa tienda que la publicó. En Amazon, el vendedor de la Oferta destacada no se toma como dueñoCuando llega un resultado
- related.offersuuid[]El precio, el inventario y la entrega están en cada OfferCuando llega un resultado
- metrics.sales_countdecimalTotal o por periodo, según cuente la fuente; nunca se suman dos fuentesCuando llega un resultado
- metrics.video_countintegerVideos que promocionan el producto en el periodo, no vistasCuando llega un resultado
Estimado
Un estimador por defecto, hasta tres lado a ladoCobro: Por consulta- units_sold_30dEstimate[]Últimos 30 días móviles, solo esta variantePor consulta
- gmv_30dEstimate[]En la moneda del marketplace, con la fecha del tipo de cambioPor consulta
- gmv_7dEstimate[]Conteos de pedidos y de liquidaciones por separadoPor consulta
- tiktok.creator_gmv_shareEstimate[]Parte del GMV que llegó a través de creadoresPor consulta
Verificable
Una fuente a la vez, hasta que una respuesta pase una verificaciónCobro: Cuando pasa la verificaciónListas y riesgo
Combinado de varias fuentes; basta una coincidencia para marcarloCobro: Por fila45 campos en el contrato de camposDiseño 0.1.0-draft · listing-contract-v3.2
Las claves de los campos y cómo se escribe cada valor, según las define el diseño. Solo llegan los campos que una fuente devolvió de verdad.
Identidad5
El ID de AIsa, la plataforma, el sitio y el ID propio de la plataformaentity.iduuidentity.kindstringentity.platformstringentity.scopestringentity.native_idstring
Página11
Título, enlace, imágenes y lo que muestra la páginatitlestringurlurlimagesobject[]image.cover_urlurldescription.blocksobject[]attributes.listobject[]status.availabilitystringlifecycle.launch_datedatebadgesstring[]affiliate.commission_ratedecimaloption_groupsobject[]
Calificaciones5
Calificaciones y número de reseñas, por separadorating.scoredecimalrating.countintegerrating.distributionobject[]review.summarystringreview.countinteger
Métricas17
Ventas, GMV e interacción, cada una en el periodo de su fuentemetrics.sales_countdecimalmetrics.gmvdecimalmetrics.gmv_totaldecimalmetrics.creator_countintegermetrics.video_countintegermetrics.live_countintegermetrics.video_view_countintegermetrics.creator_order_ratedecimalmetrics.gmv_trendobject
Mostrar 8 campos másMostrar menos
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
Vínculos7
Los ID de AIsa de las entidades a las que apuntarelation.shop_iduuidrelated.variantsuuid[]related.variant_listingsuuid[]related.parent_listingsuuid[]related.child_listingsuuid[]related.offersuuid[]related.categoriesuuid[]
Los valores decimal e integer llegan como cadenas de texto para conservar la precisión. Una clave que termina en _reported es la cifra propia de la fuente, con un método de cálculo sin confirmar; _raw conserva el código original de la fuente. Los campos uuid apuntan a otras entidades de AIsa.
Por marketplace
Donde hay cinco o más estimadores, las ventas llegan lado a lado y se calibran primero. En los demás se empieza con dos comparados, o con una sola fuente indicada como tal.
| Marketplace | Clave de Listing | Lecturas en vivo | Estimadores | Estimaciones de ventas | Estado |
|---|---|---|---|---|---|
| Amazon | amazon:US · ASIN | 4 | 6 | Lado a lado, calibradas | Disponible |
| TikTok Shop | tiktok-shop:US · product_id | 1 | 5 | Lado a lado, calibradas | Disponible |
| Temu | temu:US · goods_id | — | 3 | Lado a lado | Próximamente |
| Walmart | walmart:US · item ID | 1 | 2 | Dos comparadas | Próximamente |
| Shopee | shopee:SG · item_id | 1 | 2 | Dos comparadas | Próximamente |
| Ozon | ozon:RU · SKU | — | 2 | Dos comparadas | Próximamente |
| Mercado Libre | mercadolibre:BR · item ID | — | 2 | Dos comparadas | Próximamente |
| Etsy | etsy:US · listing_id | 1 | 1 | Una fuente, etiquetada | Próximamente |
| Shopify | shopify:{store} · product ID | — | 1 | Una fuente, etiquetada | Próximamente |
| eBay | ebay:US · item ID | 1 | — | Solo lecturas en vivo | Próximamente |
| 1688 | 1688:CN · offerId | — | 2 | Listas de proveedores, combinadas | Próximamente |
Los conteos vienen de la lista de proveedores de la fase uno. La tasa de cobertura por campo aparecerá aquí cuando cada marketplace esté disponible.
Lo que no cambia
AIsa puede cambiar las fuentes detrás de un campo en cualquier momento. Esto se mantiene fijo.
- El ID propio del marketplace es la clave, guardada exactamente como la emitió el marketplace.
- Un ID que asigna AIsa nunca se cambia ni se reutiliza.
- Dos fuentes que cuentan distinto siguen siendo dos métricas, y se conservan los valores originales.
- Los campos solo se agregan. Un cambio de significado sale como una versión nueva, y la anterior se mantiene un tiempo.