adapters de configure(). En web, los adaptadores cargan el script del proveedor por su cuenta. En React Native, pasas las funciones del SDK nativo.
Todos los destinos de un mismo track() reciben el mismo id de evento, así Meta y TikTok pueden deduplicarlo contra tus eventos de servidor. El fallo de un destino va a onError y no afecta a los demás.
GA4
Web
configse pasa agtag("config", measurementId, config).consentDefaultsse envía comogtag("consent", "default", …)antes del primerconfig.- Cada evento se envía con
send_toigual a tumeasurementId, también cuando la página ya configura otra propiedad de GA4. Varios adaptadoresga4()con ids distintos reciben cada uno sus eventos. - Si la página ya tiene
window.gtag(el snippet oficial o Google Tag Manager), el adaptador lo usa y no carga un segundo gtag.js. Si no, crea el stub oficial y carga gtag.js una vez por página. - Si gtag.js no carga, el evento se informa con
onErrory el siguiente evento lo vuelve a intentar.
setUser() se convierte en gtag("set", { user_id }) y gtag("set", "user_properties", …). setConsent() se convierte en gtag("consent", "update", …): analytics corresponde a analytics_storage, y ads a ad_storage, ad_user_data y ad_personalization.
React Native (Firebase)
logEvent. Un nombre reservado (por ejemplo session_start), un prefijo reservado (firebase_, google_, ga_) o un nombre inválido se informa con onError en lugar de perderse. Más de 25 parámetros, o valores de más de 100 caracteres, se informan con el onWarning del adaptador. Las claves con undefined o null se quitan antes de la llamada.
Meta
fbq, o el que ya tiene la página, y envía cada evento solo a tu píxel (trackSingle o trackSingleCustom) con eventID. Los eventos estándar (Purchase, AddToCart) y los personalizados se envían con la llamada que corresponde. El correo, el teléfono y el id de usuario con hash se pasan como advanced matching. setConsent() se convierte en fbq("consent", "grant" | "revoke").
En React Native, logEvent(name, params, valueToSum) recibe el evento. Los nombres deben cumplir las reglas de app events de Meta (hasta 40 caracteres: letras, números, _, - y espacios); un nombre inválido se informa con onError. setUserId recibe el SHA-256 del id de usuario.
TikTok
ttq. Si la página ya carga TikTok, lo reutiliza y carga tu píxel ahí. Los eventos van a la instancia de tu píxel con event_id, después de identify con los datos de usuario con hash. setConsent() se convierte en ttq.grantConsent() o ttq.revokeConsent().
En React Native, identify recibe los datos de usuario con hash y logout se ejecuta cuando se borra el usuario.
Masivo
track, el adaptador usa el SDK de Masivo que ya está en la página (window.masivo) e informa un error si no existe.
El adaptador envía el cuerpo de Emit event de Masivo, como se describe en Send an event. El nombre del evento es el type de Masivo (por ejemplo PURCHASE o ADD_TO_CART). customer_id, brand_id y type son obligatorios: un evento sin ellos se informa con onError y no se envía.
Los montos se calculan con decimales exactos y nunca se redondean. El correo y el teléfono sin hash, y los tenders del pedido, nunca se envían a Masivo. En el plan de tracking del dashboard, los parámetros de Masivo son estas rutas del cuerpo, y una ruta que no está en el cuerpo de Emit event muestra una advertencia.