> For the complete documentation index, see [llms.txt](https://audalaxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://audalaxy.gitbook.io/docs/console/streamurl.md).
# StreamURL
## StreamURLs und Aggregatoren
StreamURLs und deren Verbreitungskanäle bilden in der Streaming-Infrastruktur die wichtigste Schnittstelle zur Verbreitung digitaler Radio-Kanäle im Internet. Ihre Systematisierung ist wichtig und spielt gerade beim Betrieb von sehr vielen Audiostreams eine große Rolle.
Um so mehr Verbreitung die StreamURLs durch Aggregatoren wie z.B. TuneIn, radio.de, etc. erfahren, desto größer ist die sogenannte [technische Reichweite](https://de.wikipedia.org/wiki/Technische_Reichweite) des Streams. Und das bedeutet: je mehr Verbreitung die StreamURL erfährt, desto mehr Personen werden den Stream hören können.
***
Eine StreamURL ist nach folgendem Schema aufgebaut:
`https://domain/programm/format/aggregator/listenerid/`
{% hint style="info" %}
Siehe auch:
[StreamRoute in der Audalaxy Platform Documentation](/docs/platform-description/networking-and-content-delivery.md#streamroute)
{% endhint %}
***
Um über die StreamURL die jeweiligen Reichweiten von Homepage, Apps und Aggreagtoren zu messen, muss an die StreamURL die entsprechende Zuordnung angehangen und entsprechend verlinkt werden.
**Homepage:**
`https://domain/programm/format/homepage/`
**App:**
`https://domain/programm/format/app/`
**Aggregatoren, z.B. TuneIn:**
`https://domain/programm/format/tunein/`
Die entsprechenden StreamURLs können mit dem [StreamURL-Generator](/docs/console/streamurl.md#streamurl-generator) erzeugt werden.
***
Um das Capping für Werbeausspielung (Unterdrücken von Preroll-Spots) zu optimieren, kann eine vom Player erzeugte Hörer-ID an die StreamURL gehängt werden.
`http://domain/programm/format/Homepage/Hörer-ID/`
Die Hörer-ID muss als weiterer Teil des URL-Path nach dem Aggregator angegeben werden. Die Hörer-ID kann ein alphanumerischer Wert sein.
`http://domain/programm/format/App/ak446W4ggg12UU8/`
## StreamURL-Generator
Um bei der Auswertung zu erkennen, welcher Hörer über welchen Aggregator kommt, kann man entsprechend gekennzeichnete URLs verwenden. Zur Erstellung kann der „StreamURL-Generator“ genutzt werden.
Dafür in der Console unter „StreamURLs“ auf „StreamURL-Generator“ gehen.
Nun öffnet sich der „StreamURL-Generator“ in einem neuen Browser-Fenster. Im Formular bei „Programm“ den entsprechenden Channel auswählen und „Format“ und „Distributor / Aggregator / Zugriffsquelle“ angeben. Dann auf „StreamURL generieren“ klicken.
Nun erhält man die StreamURLs für verschiedene Wiedergabelisten-Formate (m3u, pls, HLS).
Diese können dann entsprechend eingebunden werden.
{% hint style="info" %}
Hinweis:
[Weitere Informationen zum Aufbau von StreamURLs](#streamurls-und-aggregatoren)
{% endhint %}
## StreamURL-Domain
In der Audalaxy Console können unter dem Menüpunkt „StreamURLs“ Domains bearbeitet, hinzugefügt oder gelöscht werden.
Unter „StreamURL-Domain bearbeiten“ hat man die Möglichkeit einen Primärchannel als Fallback zu konfigurieren, falls in der StreamURL kein gültiger Channel erkannt wird.
Außerdem könnte man für bestimmte Aggregatorkeys die Prerollspots unterdrücken.
***
Es ist ebenfalls möglich eine eigene Domain für die StreamURLs eintragen zu lassen. Dafür unter „StreamURLs“ in „StreamURL-Domain hinzufügen / löschen“ gehen. Unter „System StreamURL-Domänen“ finden Sie ihrer aktuell eingerichtete StreamURL-Domain.
Nun muss der Kunde im DNS für die gewünschte Domain einen CNAME auf der aktuell eingerichtete StreamURL-Domain einrichten.
z.B. streams.meine-domain.de IN CNAME {system-name}.stream.vip.
Anschließend bitte dein Ticket im Helpdesk öffnen [https://streamabc.zammad.com](https://streamabc.zammad.com/) und uns diese Information zukommen lassen. Wir schalten dann ihre individuelle StreamURL-Domain frei.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://audalaxy.gitbook.io/docs/console/streamurl.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
