---
updatedAt: 2026-09-07T08:28:06.000Z
agentTools:
  siteIndex: https://developer.bitmovin.com/llms.txt
  projectIndex: https://developer.bitmovin.com/playback/llms.txt
---

# Live Exporting via Google Pub/Sub

The Bitmovin Analytics Pub/Sub Export system enables real-time delivery of analytics data to customer-owned infrastructure using **Google Cloud Pub/Sub**. This setup allows customers to receive, store, and process analytics events in a scalable and decoupled manner.

All analytics data is pushed to a **Google Cloud Pub/Sub topic** defined and controlled by the customer. The message payload is encoded using **Protocol Buffers (Protobuf)** format for efficient and structured encoding.

## Setup

As a customer, you must first create the necessary Pub/Sub components in your **Google Cloud Platform (GCP)** account:

* **Pub/Sub Topic:** A new or existing topic where Bitmovin will publish analytics data.
* **Subscription:** A subscription attached to the topic which enables you to pull and process messages.

**Required IAM Permissions**

You must **grant Bitmovin Analytics Pub/Sub writer permissions** to the topic. This is done by assigning the `roles/pubsub.publisher` role to the Bitmovin service account:

`Service Account: 1077355926250-compute@developer.gserviceaccount.com`

`Role: roles/pubsub.publisher`

This allows Bitmovin to publish messages to the topic without access to other resources in your GCP project.

## Message receiving

To receive messages from Google Pub/Sub, please follow the Google Pub/Sub tutorial: <https://cloud.google.com/pubsub/docs/overview>

Bitmovin Analytics uses Protocol Buffers for the Pub/Sub message payload. This allows customers to generate deserialization logic in multiple languages (e.g., Java, Python, Go).

See [this sample .proto file schema](https://demo.bitmovin.com/public/sample.proto) as a reference. For more information about Protocol Buffers, please see:<br /><https://protobuf.dev/overview/>

## Completion and activation

*To enable this feature on your account and for pricing details, please get in touch with your Bitmovin Account Manager first.&#x20;*

Once the necessary Pub/Sub components are created and the required IAM permissions are granted to the Bitmovin service account, please reach out to Bitmovin support and share the following details:

* Google Project ID
* Pub/Sub Topic ID
* Do you want all licenses in your organisation to be pushed, or specific ones only? If so, which ones?

Upon notification, Bitmovin will configure the live-exporting process, and data will begin streaming into your Pub/Sub topic in real-time.

<br />