Integration von „adremes RAS" dem " Radio Ad-Server für Radio und Audiowerbung¶

• Table of contents
• Integration von „adremes RAS" dem " Radio Ad-Server für Radio und Audiowerbung
  • Funktion von "RAS"
  • Verwaltung der Zugriffsberechtigung
  • Installation und Konfiguration
  • Statusanzeige / Funktionsüberwachung
  • Standardfunktionen der RAS-Schnittstelle
    • RAS-spezifische Daten und Attribute
    • Interaktion zwischen dem Service und RAS
    • Empfangen eines Sendeplans von RAS
    • Importieren des Sendeplans anhand der Text-Datei
  • Erstellen einer Liste mit ausgespielten RAS-Elementen

Funktion von "RAS"¶

Die Integrations-Schnittstelle (folgend "Service") zu dem Radio Ad Server von adremes (folgend "RAS") ermöglicht die Synchronisation von Werbe-Sendeplänen und den Austausch von Mediadaten zwischen dem RAS-Server und der Datenbank sowie dem Sendeplan von Digispot. Außerdem können über diese Schnittstelle Informationen über bereits ausgespielte Elemente, die über die entsprechenden RAS-spezifischen IDs verfügen, abgerufen werden.

Der Service wird verwendet um automatisch von RAS Werbeinhalte in den DIGISPOT Sendeplan zu importieren, die auch über diese Schnittstelle im weiteren Verlauf spontan geändert werden können. Außerdem besteht die Möglichkeit auch neue Datenbankelemente mit dem dazugehörigen Audiomaterial zu erzeugen, um sie später in den Werbeplan zu integrieren.

Verwaltung der Zugriffsberechtigung¶

User die im Digispot-System angelegt sind und über administrative Rechte verfügen, können den Zugriff auf die Konfiguration des Service beschränken. Die entsprechende Konfiguration ist in das Berechtigungs-Verwaltungssystem von Digispot integriert.

Installation und Konfiguration¶

Um die RAS-Integration nutzen zu können müssen die folgenden Voraussetzungen erfüllt sein.

• DIGISPOT II Installation mindestens Version 2.16.3.11
• Die DIGISPOT 3 WEB-Services müssen installiert sein
• DIGISPOT II und DIGISPOT 3 WEB müssen mit derselben SQL-Datenbank verbunden sein
• Führen Sie das SQL-Skript mdb_ras_update.sql auf der aktiven Digispot-Datenbank aus, um die RAS-User-Attribute in der Datenbank zu erstellen.
• Erstellen Sie in der Digispot Medien-Datenbank eine Kategorie für die RAS-Elemente und passen den entsprechenden Parameter unter Service\Globale Einstellungen\Integration\RAS\Default Category an.
• Starten Sie den Service sch_to_db und konfigurieren ihn so, dass er mit der aktiven Digispot-Datenbank und dem dazugehörigen Root-Verzeichnis verbunden ist.
• Erstellen Sie in DIGISPOT II in den Global Settings unter User Properties einen Eintrag mit den folgenden Parametern:
  • Name = RASGuid
  • Description = RASGuid
  • Type = String
  • Applies to = Commercial

Anmerkung: Die Erstellung eines User Properties ist für die Funktion nicht notwendig. Dies dient lediglich dazu, dass Sie die Möglichkeit haben, diesen Wert in der DB und im Sendeplan anzuzeigen.

Die Konfiguration des RAS-Service erfolgt über die Digispot 3 Webservices und wird über die Schaltfläche Radio Ad-Server aufgerufen.
Hier werden die Sendepläne eingerichtet, die über RAS synchronisiert werden sollen. Diese Sendepläne müssen vorher im Digispot II System vorhanden sein. Die Folgenden Parameter müssen für jeden Sendeplan gesetzt werden:

• Name des Sendeplans
• Login -> Benutzername für die Anmeldung am RAS-Server
• Password -> Für die Anmeldung am RAS-Server
• Startup Type (Automatic/Manual):
  • Automatic -> Wenn der Service startet verbindet er sich automatisch mit dem RAS-Server
  • Manual -> Die Verbindung zum RAS-Server muss manuell ausgelöst werden.

Login und Passwort sind für jeden Sendeplan einzigartig und werden von RAS (adremes) zur Verfügung gestellt.

Statusanzeige / Funktionsüberwachung¶

Die Statusanzeige und Anzeigen zur Funktionsüberprüfung befinden sich auch auf Seite der RAS-Konfiguration.
Dabei wird die Funktionsüberwachung (Tracking) und Service Kontrolle für jeden Sendeplan einzeln ausgeführt.

• - Wenn der Sendeplan erfolgreich mit RAS verbunden ist, wird die Schaltfläche grün dargestellt.

• - Um den Sendeplan mit dem RAS-Server zu verbinden wird die weiße Schaltfläche betätigt

Der Verbindungs-Zustand des jeweiligen Sendeplan-Services wird über die Farbe der Schaltfläche dargestellt. Grün bedeutet, dass der Service verbunden ist.
Außerdem wird in der Spalte "Connection state" angegeben, ob die Verbindung fehlerfrei ist oder nicht. Im Falle eines Fehlers wird zusätzlich der letzte Fehler unter „Last Error" spezifiziert. Der Verbindungsstatus bezieht sich immer auf den letzten Datenaustausch zwischen RAS und dem Service und kann die folgenden Zustände annehmen:

• OK – Der letzte Datenaustausch zwischen dem Service und RAS war erfolgreich
• Error –Es gab einen Fehler beim Datenaustausch
• Unknown – Der Status ist nicht verfügbar

Der Error Status eines Sendeplans kann mit der Taste zurückgesetzt werden. Dies ändert den Error-Status so lange zu „Unkown" bis der nächste Datenaustausch stattgefunden hat.
Über diesen Button kann für jeden Sendeplan ein Protokoll über den Datenverkehr zwischen dem Service und RAS für einen bestimmten Tag eingesehen werden.

Standardfunktionen der RAS-Schnittstelle¶

RAS-spezifische Daten und Attribute¶

Der Service kann die folgenden Daten vom RAS-Server empfangen:

• Das Element. Jedes RAS-Element hat seine eigene GUID und eine dazugehörende Audio-Datei.
• Sendeplan-Element. Jedes RAS Element in einem Sendeplan hat, zusätzlich zur GUID, eine eindeutige Booking-ID, die den genauen Sendezeitpunkt spezifiziert.

Nach dem Empfang des Elementes von RAS wird ein Datenbankeintrag erzeugt, der als zusätzliches Attribut dessen GUID beinhaltet. Diese GUID kann als separate Spalte in der Datenbankansicht und/oder im Sendeplan angezeigt werden.

Außerdem besitzt jedes RAS-Element ein spezielles User-Attribut, welches dieses Element als RAS-Element ausweist.

Der Wert der Booking ID wird im Sendeplan in einer separaten Spalte angezeigt und findet sich auch im Fenster der Element-Eigenschaften wieder.

Diese BookingID ist statisch und kann nicht editiert werden.

Interaktion zwischen dem Service und RAS¶

Nachdem die Verbindung erfolgreich etabliert wurde, befindet sich der Service im Standby Modus und wartet auf Anfragen und Daten von RAS. Ein Datenaustausch wird ausschließlich von RAS initiiert.
Die folgenden Events können von RAS empfangen werden:

• Ein neues DB-Element erzeugen: Durch diesen Event wird ein neues Element von RAS heruntergeladen und in der Digispot-Datenbank angelegt. Wenn dieses Element schon vorhanden ist, wird es entsprechend aktualisiert.
• Erzeugen eines oder mehrerer Sendeplan-Elemente: Ein neues Element für den Sendeplan wird durch einen Request von RAS erzeugt, der die entsprechende GUID und BookingID enthält. Wenn dieses Element noch nicht in der DB vorhanden ist wird es erzeugt und mit dem Sendeplan-Element verlinkt.
• Ändern eines Elementes im Sendeplan: Mit dem entsprechenden Request, der die BookingID des SP-Elementes und die GUID des Elementes enthält, das statt dessen ausgestrahlt werden soll, kann der Austausch eines Elementes im Sendeplan ausgelöst werden.
• Löschen von Elementen im Sendeplan: Mit dem entsprechenden Request können Sendeplan-Elemente anhand der BookingID gelöscht werden.
• Anforderung eines Broadcast-Protokolls: Anhand der BookingID können von RAS Details über die Ausspielung eines oder mehreren Elemente abgefragt werden.

Also verarbeitet der Service ausschließlich Anfragen von RAS um Elemente um Sendeplan oder in der Datenbank zu erzeugen, zu ändern, auszutauschen oder zu löschen. Neue RAS-Elemente werden dabei in einer speziellen Datenbank-Kategorie angelegt, die im Digispot System dafür konfiguriert wurde. Wenn ein Element ersetzt wird, wird es automatisch in das Standart-Format konvertiert und alle Sendeplan-Elemente, die mit diesem Element verbunden sind, werden entsprechend aktualisiert.

NOTE: RAS-Spots müssen grundsätzlich in der DB angelegt sein bevor sie im Sendeplan geplant werden. Das Gegenteil beschreibt eine außerordentliche Situation, die aber dennoch durchgeführt werden kann. Damit diese Situation korrekt bedient werden kann, muss im Digispot System die Funktion aktiv und konfiguriert sein, die Sendeplanelemente automatisch aus der DB aktualisiert.

Empfangen eines Sendeplans von RAS¶

Ein Sendeplan kann auf 2 Arten von RAS empfangen werden:

• Synchronisation der Sendpläne zwischen dem Service und RAS (ausgelöst durch entsprechende Requests von RAS, um Sendeplan-Elemente zu erzeugen, zu ändern oder zu löschen)
• Import einer Text-Datei (direkt in den Sendeplan), die vom Dispo-System zur Verfügung gestellt wird

Dafür müssen die RAS Booking ID und die RAS GUID, die in dieser Textdatei enthalten sind auch im Digispot angelegt sein, um das Importformat entsprechend konfigurieren zu können.
Wenn dieses Feld vorhanden ist, hat ein Element welches von RAS importiert wurde auch die entsprechende RAS Markierung.
Außer den Standardfeldern müssen auch die folgenden beiden Felder zwingend vorhanden sein:

• GUID
• ID of schedule item added from RAS (BookingId)

Der Digispot II Werbe-Sendeplan wird durch entsprechende Anfragen von RAS organisiert, indem Elemente direkt erzeugt, geändert oder gelöscht werden.

Importieren des Sendeplans anhand der Text-Datei¶

Um den Sendeplan über eine Textdatei zu importieren muss ein entsprechendes Import-Format in Digispot II konfiguriert sein. Bitte achten Sie beim Konfigurieren des Import-Formats darauf, dass die Felder RAS Booking ID, RAS GUID und ID Nummer korrekt konfiguriert sind.

NOTE: Die RASGuid kann als ID_Nummer verwendet werden, wenn das Element keine eigene ID-Nummer hat.

Neben den Standard-Feldern müssen für RAS die folgenden Felder zwingend vorhanden sein:

• Element ID (GUID)
• ID des Sendeplan-Elements (BookingId)
• ID Nummer

Beispiel einer solchen Text-Datei für den Import:

File	BookingId	Id Number	DateTime
test_0.mp3	DIGV.TST._12_0_0	ff4edada-9b77-4b01-94cd-63f18775d3aa	07-04-2016 12:00
test_1.mp3	DIGV.TST._12_0_1	cc1a784c-91c6-4b87-963b-74795d57fd7b	07-04-2016 12:05

Wenn ein Sendeplan-Element über eine Textdatei in den Sendeplan importiert wird, werden alle Daten und Informationen die sich auf RAS beziehen beibehalten.
Bevor ein Element der Datenbank hinzufügt wird, wird eine Suche auf Basis der GUID ausgeführt:

• Wenn das Element bereits vorhanden ist, werden die entsprechenden Daten aktualisiert
• Für den Fall dass es nicht vorhanden ist, wird die dazugehörige Audio-Datei heruntergeladen und dann das Element in die DB eingetragen

Sollte die Verbindung zu RAS durch einen Fehler unterbrochen werden, wird sie automatisch wieder hergestellt.
Wenn die Verbindung nicht automatisch wieder hergestellt werden kann, wird eine zusätzliche Fehlermeldung ausgegeben.

Erstellen einer Liste mit ausgespielten RAS-Elementen¶

Die Information, welche RAS-Elemente wann ausgespielt wurden, wird mit der jeweiligen BookingID in einer separaten Datenbanktabelle automatisch gespeichert.
Diese Angaben zu den ausgespielten RAS-Inhalten können vom RAS-Server über einen entsprechenden Request angefordert werden.