> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Destinos de analítica

> Opciones de los adaptadores de GA4, Meta, TikTok y Masivo, en web y en React Native.

Cada destino es un paquete que pasas en `adapters` de [`configure()`](https://firespark.cloud/docs/es/guides/analytics/use-analytics-in-the-sdk). 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

```bash theme={null}
pnpm add @fire-spark/analytics-ga4
```

### Web

```typescript theme={null}
import { ga4 } from "@fire-spark/analytics-ga4";

ga4({
  measurementId: "G-XXXXXXX",
  config: { send_page_view: false, debug_mode: true },
  consentDefaults: { analytics_storage: "denied", ad_storage: "denied", wait_for_update: 500 }
});
```

* `config` se pasa a `gtag("config", measurementId, config)`.
* `consentDefaults` se envía como `gtag("consent", "default", …)` antes del primer `config`.
* Cada evento se envía con `send_to` igual a tu `measurementId`, también cuando la página ya configura otra propiedad de GA4. Varios adaptadores `ga4()` 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 `onError` y 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)

```typescript theme={null}
import { getAnalytics, logEvent, setConsent, setUserId, setUserProperties } from "@react-native-firebase/analytics";

const firebase = getAnalytics();

ga4({
  logEvent: (name, params) => logEvent(firebase, name, params),
  setUserId: id => setUserId(firebase, id),
  setUserProperties: properties => setUserProperties(firebase, properties),
  setConsent: consent => setConsent(firebase, consent)
});
```

Envuelve la API modular como en el ejemplo: sus funciones reciben la instancia de analytics como primer argumento.

El adaptador revisa las reglas de Firebase antes de llamar a `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

```bash theme={null}
pnpm add @fire-spark/analytics-meta
```

```typescript theme={null}
import { meta } from "@fire-spark/analytics-meta";

meta({ pixelId: "1234567890" }); // web
meta({ logEvent, setUserId, setConsent }); // app events de React Native
```

En web, el adaptador usa el snippet oficial de `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

```bash theme={null}
pnpm add @fire-spark/analytics-tiktok
```

```typescript theme={null}
import { tiktok } from "@fire-spark/analytics-tiktok";

tiktok({ pixelId: "CXXXXXXXXXXXXXXX" }); // web
tiktok({ logEvent, identify, logout, setConsent }); // React Native
```

En web, el adaptador usa el snippet oficial de `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

```bash theme={null}
pnpm add @fire-spark/analytics-masivo
```

```typescript theme={null}
import { masivo } from "@fire-spark/analytics-masivo";

masivo({ publishableKey: "pk_live_..." });
masivo({ publishableKey, track: (type, body) => client.track(type, body) });
```

Sin `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](https://docs.masivo.ai/api-reference/behavior/events/post) de Masivo, como se describe en [Send an event](https://docs.masivo.ai/api-reference/guides/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.

| Fire Spark | Cuerpo de Masivo |
| - | - |
| Cliente | `customer_id` |
| Marca de `getScope()` | `brand_id` |
| Siempre `firespark` | `platform` |
| Hora del evento | `issued_at` |
| `order_id` o `transaction_id` (`PURCHASE`) | `order.purchase_id` |
| `value` (`PURCHASE`) | `order.value` |
| `items` (`PURCHASE`) | `order.products`: `sku` (`item_id`), `amount` (`quantity`), `value` (precio × cantidad) |
| `payment_method` (`PURCHASE`) | `order.payment_method`: `CASH`, `BANK_TRANSFER` u `OTHER` |
| Tienda y canal | `order.store_id`, `order.channel_id` y `metadata` |
| Primer ítem (`ADD_TO_CART`) | `product` |
| Parámetros UTM, ids de clic (`gclid`, `fbclid`, `ttclid`) | `attribution` |
| Moneda y cualquier otro parámetro | `metadata` |
| Recompensas canjeadas en los tenders del pedido | `metadata.redemptions` |

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.