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

# Plantilla de Transmisión

> Rastrear el consumo de datos de transmisión para video, audio, transmisiones en vivo y facturación de transferencia de datos en tiempo real.

## Casos de Uso

Explora escenarios comunes soportados por la Plantilla de Transmisión:

<CardGroup cols={2}>
  <Card title="Video Platforms" icon="video">
    Facture a los clientes según el consumo de ancho de banda de video y la calidad de transmisión.
  </Card>

  <Card title="Music Streaming" icon="music">
    Controle el uso de transmisión de audio por usuario para los niveles de suscripción.
  </Card>

  <Card title="Live Events" icon="signal-stream">
    Supervise el consumo de transmisiones en vivo y cobre por el uso de ancho de banda.
  </Card>

  <Card title="Real-Time Data" icon="wave-pulse">
    Controle la transferencia de datos en tiempo real para aplicaciones de IoT y telemetría.
  </Card>
</CardGroup>

<Info>
  Perfecto para plataformas de transmisión de video/audio, servicios de transmisiones en vivo y aplicaciones de datos en tiempo real.
</Info>

## Inicio Rápido

Rastrear los bytes de transmisión consumidos por tus clientes:

<Steps>
  <Step title="Install the SDK">
    ```bash theme={null}
    npm install @dodopayments/ingestion-blueprints
    ```
  </Step>

  <Step title="Get Your API Keys">
    * **Dodo Payments API Key**: Consíguela en [Dodo Payments Dashboard](https://app.dodopayments.com/developer/api-keys)
  </Step>

  <Step title="Create a Meter">
    Cree un medidor en su [Dodo Payments Dashboard](https://app.dodopayments.com/):

    * **Event Name**: `stream_consumption` (o el nombre que prefiera)
    * **Aggregation Type**: `sum` para rastrear el total de bytes transmitidos
    * **Over Property**: `bytes` para facturar según el uso de ancho de banda
  </Step>

  <Step title="Track Stream Usage">
    <CodeGroup>
      ```javascript Video Streaming theme={null}
      import { Ingestion, trackStreamBytes } from '@dodopayments/ingestion-blueprints';

      const ingestion = new Ingestion({
        apiKey: process.env.DODO_PAYMENTS_API_KEY,
        environment: 'test_mode',
        eventName: 'stream_consumption'
      });

      // Track video stream consumption
      await trackStreamBytes(ingestion, {
        customerId: 'customer_123',
        bytes: 10485760, // 10MB
        metadata: {
          stream_type: 'video',
        }
      });
      ```
    </CodeGroup>
  </Step>
</Steps>

## Configuración

### Configuración de Ingesta

<ParamField path="apiKey" type="string" required>
  Su clave de API de Dodo Payments desde el panel.
</ParamField>

<ParamField path="environment" type="string" required>
  Modo de entorno: `test_mode` o `live_mode`.
</ParamField>

<ParamField path="eventName" type="string" required>
  Nombre del evento que coincida con la configuración de su medidor.
</ParamField>

### Opciones para Rastrear Bytes de Transmisión

<ParamField path="customerId" type="string" required>
  El ID del cliente para la atribución de facturación.
</ParamField>

<ParamField path="bytes" type="number">
  Número de bytes consumidos en la transmisión. Requerido para la facturación basada en ancho de banda.
</ParamField>

<ParamField path="metadata" type="object">
  Metadatos opcionales sobre la transmisión, como tipo de transmisión, calidad, sessionId, etc.
</ParamField>

## Mejores Prácticas

<Tip>
  **Seguimiento por fragmento**: Para transmisiones largas, rastree el consumo por fragmentos en lugar de esperar a que la transmisión completa finalice.
</Tip>

<Warning>
  **Conteo preciso de bytes**: Asegúrese de que los recuentos de bytes incluyan toda la sobrecarga (encabezados, sobrecarga del protocolo) si factura por el ancho de banda total.
</Warning>