Audience Recognition benutzen

Die Audience Recognition (Zielgruppenerkennung) ermöglicht die Übergabe von Live Tag-Informationen von einem Windows Player oder Linux Player an einen SSP-Anbieter über die AdServing API. Das bedeutet, dass Sie Live Tags nicht mehr in der IXM Platform voreinstellen müssen. Das Player Add-on kann nun Live Tag-Informationen in seiner Anfrage senden, und die API leitet die Informationen an den entsprechenden SSP-Anbieter weiter.

Was sind Live Tags?

Live Tags sind spezielle Tags, die die Spotausspielung zur Laufzeit beeinflussen. Sie werden über (lokale) Webdienste aktiviert und deaktiviert. Dieser Prozess wird durch ein angeschlossenes externes System ausgelöst, das die Webdienste des Players aufruft. Solche externen Systeme sind z.B. Sensoren, Kamerabilder, externe dynamische Daten wie Wettervorhersagen oder externe Ereignisse. Sie können den Player so konfigurieren, dass bestimmte Spots angezeigt werden, denen Live Tags zugewiesen sind, die den aktuellen Bedingungen entsprechen.

Systemanforderungen

Stellen Sie sicher, dass Sie die folgenden Systemanforderungen erfüllen:

Voraussetzungen

Vergessen Sie nicht, die Live Tags auf dem Player festzulegen, die Sie an den SPP-Anbieter übergeben möchten. Wenn Sie dies nicht tun, ruft das Add-on einen zufälligen Spot von der AdServing API ab, ohne die Live Tag-Informationen zu übergeben.

→ Um Live Tags auf dem Player manuell festzulegen, können Sie den API-Befehl SetLiveTags verwenden. Weitere Informationen finden Sie in der API Dokumentation.

Komponenten konfigurieren

Um die Zielgruppenerkennung verwenden zu können, müssen Sie die AdServing API und das Player Add-on konfigurieren.

AdServing API konfigurieren

Informationen zur allgemeinen Konfiguration der AdServing API finden Sie in den Artikeln zur SSP Installation.

Führen Sie die folgenden Schritte aus, um die AdServing API zu konfigurieren:

1. Öffnen Sie Ihre SSP config-Datei.

2. Stellen Sie die folgenden Einstellungen ein:

   Einstellung	Beschreibung
   SspLiveTagsUrl	Geben Sie die URL-Vorlage des SSP-Anbieters an, um die Übergabe von Live Tag-Daten zuzulassen. Wenn Sie z. B. die Livetags ac1:1 und a0:5 für den Player festgelegt haben und diese an den SSP-Anbieter senden möchten, können Sie die folgende URL verwenden: https://prod.ssp1.eu/ssp1/?key=c762&seg=ac1%3A1%3Ba0%3A5&playerid=123  https://prod.ssp1.eu/ssp1/ (Englisch) ist die URL des SSP-Anbieters. key identifiziert den Kunden auf dem SSP-Server. seg speichert die Live Tag-Daten. playerid gibt die BoxID des Players an. Hinweis Wenn Sie diese Einstellung nicht konfigurieren, verwendet die Anwendung stattdessen den Wert, den Sie als SspUrl angegeben haben.
   SspLiveTagValuesSeparator	Geben Sie optional ein Trennzeichen für verkettete Live Tag-Werte an. Standardmäßig handelt es sich um ein Semikolon ;

3. Speichern Sie Ihre Änderungen, und schließen Sie die Datei.

Beispielkonfiguration der SSP-Konfigurationsdatei:

{
	"SspConfigurations": [
		{
			"SspPriority": 1,
			"SspUrl": "https://prod.ssp1.eu/ssp1/?key=c762&boxId={boxId}",
			"SspLiveTagsUrl": "https://prod.ssp1.eu/ssp1/?key=c762&boxId={boxId}&seg={seg}",
			"CutMediaUrlBeforeSubString": "?",
			"SspRequestHeaders": {
				"api-key": "8618681688"
			},
			"SspCategoryId": 812,
			"SspPlaylistId": 522,
			"SspSpotGroupId": 1211,
			"SspServiceUserId": 844
		}
	]
}

Player Add-on konfigurieren

Führen Sie die folgenden Schritte aus, um das Player Add-on zu konfigurieren:

1. Öffnen Sie die Datei config.ini:

   • Unter Windows befindet sich die Konfigurationsdatei unter: C:\GVClient\addonConfigs\gfPlayer\DoohPlaybackService\config.ini

   • Unter Linux befindet sich die Konfigurationsdatei unter: /opt/grassfish/addonConfigs\gfPlayer\DoohPlaybackService\config.ini

2. Geben Sie in der Konfigurationsdatei die folgende Einstellung an:

   Einstellung	Beschreibung
   Dooh.SspLiveTagKey	Wenn der Player über Live Tag-Werte mit diesem Key verfügt, werden alle Werte dieses Live Tag-Keys URL-codiert an den Parameter SspLiveTagsUrl übergeben. Der Standardwert ist ADV_SEGMENTS. Hinweis Sie können nur einen Live Tag-Key festlegen.

3. Speichern Sie Ihre Änderungen, und schließen Sie die Datei.

Beispielkommunikation an den Player:

[
  {
    "Name": "ADV_SEGMENTS",
    "Values": {
      {
        "Value": "a12:2"
      },
      {
        "Value": "bx1:1"
      },
      {
        "Value": "rx1:5"
      }
    }
  }
]

Ausspielen von SSP-Spots

Standardmäßig gibt es eine Look-Back-Zeit von zehn Minuten.

Wenn Sie z.B. ein Sendezeitverhältnis von 50% haben, werden die SSP-Spots wie folgt ausgespielt:

• Wenn DOOH- und SSP-Spots innerhalb der letzten zehn Minuten insgesamt eine Minute abgespielt wurden, fragt das System nach einem neuen SSP-Spot. Eine Minute entspricht 10 %, was kleiner als 50 % Sendezeitverhältnis ist.

• Wenn DOOH- und SPP-Spots innerhalb der letzten zehn Minuten insgesamt neun Minuten gespielt wurden, fragt das System nicht nach einem neuen SSP-Spot. Neun Minuten entsprechen 90 %, was einem Verhältnis von mehr als 50 % Sendezeit entspricht.

Troubleshooting

Wenn Sie Probleme bei der Verwendung der Zielgruppenerkennungsfunktion haben, beachten Sie die folgenden Informationen.

Allgemeine Fehler

Die folgenden Fehler können auftreten, wenn Ihr Setup die Systemanforderungen nicht erfüllt:

• Wenn Sie einen 404-Fehler erhalten, wenn das Add-on eine Anfrage stellt, ist Ihre AdServing API-Version zu alt. Sie müssen Version 1.2.0 oder später installieren.

• Wenn die neue Funktion nicht funktioniert, ist Ihre Player Add-on-Version zu alt. Sie müssen Version 2.7.0 oder später installieren.

• Wenn das Add-on keine DOOH-Berechnung enthält, ist Ihre Player-Version zu alt. Sie müssen Version 11.13 oder später installieren.

Keine verketteten Zeichenfolgen

Nur verkettete Zeichenfolgen werden als Livetaginformationen an den SSP-Anbieter gesendet. Unter Verkettung versteht man das Verbinden von Zeichenfolgen von Ende zu Ende, indem eine Zeichenfolge an das Ende einer anderen Zeichenfolge angehängt wird. Verwenden Sie dazu das Trennzeichen, das Sie als SspLiveTagValuesSeparator angegeben haben. 

Beispiel:

• Die folgende verkettete Zeichenfolge funktioniert: GET https://prod.ssp1.eu/ssp1/?seg=a12%3A2%3Bbx1%3A1%3Brx1%3A5

• Die folgende Zeichenfolge wird nicht unterstützt: GET https://prod.ssp1.eu/ssp1/?seg=a12%3A2&seg=bx1%3A1&seg=rx1%3A5

Keine Live Tags auf dem Player

Sie müssen die Live Tags auf dem Player festlegen. Wenn Sie dies nicht tun, ruft das Add-on eine zufällige Stelle von der AdServing API ab, ohne die Live Tag-Informationen zu übergeben.

Wert für leere Live Tags

Wenn der Wert der Live Tags null oder leer ist, ignoriert das System den Parameter seg. Das bedeutet, dass null an den SSP-Anbieter übergeben wird.

Beispiel: GET https://prod.ssp1.eu/ssp1/?key=c762&boxId=BOX_ID&seg=

Warnung in den Logs

Das System protokolliert eine Warnung, wenn der Live Tag-Wert dasselbe Zeichen wie das konfigurierte Trennzeichen enthält. Wenn Sie z. B. folgendes verwenden: value=a12:1 und separator=: