Stack base · Wayfarer
Las 4 plataformas, en orden
No hay que conectar todo de una. Hay un orden que respeta cómo funciona el negocio: primero el dato de venta, después el dato de pauta, después el dato de tráfico web, y por último marketplaces.
REST API v1
Auth: OAuth 2 / token
Endpoints: /orders /products /checkouts
Es la primera plataforma que conectamos. Sin las ventas como base, todo lo demás es decorativo. Empezás creando una "Tienda Aplicación" dentro del panel de Tiendanube → te genera un token con los permisos que vos elegís. Le das los mínimos: leer órdenes, productos, checkouts.
Qué cosas se desbloquean
Reportes diarios automáticos, clasificación de ventas por canal (vía owner_note), tracking de carritos abandonados con dedup por persona, análisis de productos top y de los que se enfrían.
Graph API v19
Auth: token largo (60 días)
Permisos: ads_read, business_management
La segunda. Sin ROAS de campañas no podés decidir qué escalar. Generás un token de usuario en Business Manager → lo "extiendes" a 60 días → lo guardás en una variable de entorno. Si tenés más de una cuenta publicitaria (es muy común), tenés que listarlas todas y trabajar campaña por campaña.
Qué cosas se desbloquean
Auditoría en vivo de campañas, costo por mensaje aislado de la campaña de mensajes, ROAS por campaña/ad set, generación de creativos a partir de los winners.
GA4 Data API
Auth: service account JSON
Property ID (no Measurement ID)
La tercera. Necesitás el dato de tráfico web para entender el funnel. Desde Google Cloud creás una service account, descargás la JSON con la clave privada, y la invitás a la propiedad GA4 con permisos de "Viewer". El error más común: confundir Measurement ID (G-XXXXXXX) con Property ID (números). El que se usa en la API es el segundo.
Qué cosas se desbloquean
Sessions por día, tasa de conversión por canal (separar directo de paid), funnel de page_view → checkout → purchase, segmentar por dispositivo y fuente.
REST API
Auth: OAuth 2 + refresh_token
Endpoints: /orders/search
La cuarta — solo si vendés en Meli. La autenticación es OAuth 2 con un refresh token: el access token vive 6 horas, así que tu integración tiene que saber refrescarlo automáticamente. Es el que más cuidado pide en el setup, pero una vez que funciona, anda solo.
Qué cosas se desbloquean
Sumar las ventas de Meli al consolidado diario, ver el peso del marketplace vs ecommerce propio, y detectar qué productos rotan distinto en cada canal.
