API - Jipadvert

Die API wird primär für die Kommunikation mit den verschiedenen Plugins für die Broadcast-Software genutzt. Als Basis wird die “OAuth 2.0 Server Bibliothek für PHP” von Brent Shaffer verwendet.

Funktionen

Authentifizierung

Die Authentifizierung erfolgt nach dem OAuth 2.0 Verfahren - Bearer Token. Auf die Implementierung von Refresh-Token wird in diesem Fall verzichtet.

Events

Die API ist so ausgelegt, dass diese auf Events, die in der Broadcast Software erfolgen, reagiert. Die Übetragung der Events an die API erfolgt über das installierte Plugin. Folgende Events werden registriert und gegebenfalls übermittelt:

Livestreaming wurde gestartet/gestoppt.
Szenenwechsel, Hinzufügen/Entfernen von Szenen.*
Verschieben/Hinzufügen/Entfernen/Überdecken der Plugin-Source.*
Transformation der Plugin-Source.*
Verschiedene Anzeigemodi (Preview/Studio-Modi).*

*Nur wenn Bannergrafik sichtbar.

Benutzerdefinierte Einschränkungen

Livestreamer, wie auch Werbende, können verschiedene Einschränkungen vornehmen. Livestreamer entscheiden welche Art von Werbebotschaften auf deren Livestream zu sehen sind. Werbende bestimmen auf welchen Livestreams deren Werbebotschaft angezeigt wird. Diese Einschränkungen kann jeder Livestreamer/Werbende über das Web-Portal pflegen.

Livestreamer

Werbekategorien ausschließen.
Erwachsenen-Werbebotschaften ausschließen.
Werbebotschaften je Stunde eingrenzen.
Bannergröße und -position bestimmen.

Werbender

Content des Livestreams eisnchränken.
Sprache des Livestreams einschränken.
Zeitspanne (von-bis) einschränken.
Einzelne Livestream Kanäle ausschließen.

Werbeinseln

Basierend auf den Einschränkungen von Livestreaming Plattformen für deren API Anfragen und Chatnachrichten ist ein Konzept von Werbeinseln entwickelt worden.

Um die durchschnittliche Zuschauerzahl je Werbeinsel zu ermitteln werden 3 Messzeitpunkte je Werbebotschaft definiert.

Die Textnachricht wird 1 bis 3 mal während der Einblendung der Bannergrafik im Livestream Chat angezeigt.

Wenn bei der Auslastung der API Anfragen und Chatnachrichten Slots verfügbar sind, wird diese Werbeinsel für eine Werbung reserviert. Informationen wie Bild, Anzeigebeginn und -dauer werden an das Plugin übermittelt.