Client-side Tracking von Werbeanzeigen

Mithilfe der AWS Elemental MediaTailor clientseitigen Tracking-API können Sie Player-Steuerelemente für Werbeunterbrechungen in Streaming-Workflows integrieren. Beim clientseitigen Tracking sendet der Player oder Kunde Tracking-Ereignisse, wie z. B. das Beaconing von Impressionen und Quartil-Anzeigen, an den Ad Decision Server (ADS) und andere Stellen zur Anzeigenverifizierung. Diese Ereignisse verfolgen sowohl den Gesamtstatus der Werbeunterbrechung als auch die Verfügbarkeit einzelner Anzeigen innerhalb der einzelnen Werbeunterbrechungen. Weitere Informationen zu Impression and Quartile (ADS) und anderen Entitäten zur Anzeigenüberprüfung finden Sie hier. Weitere Informationen zum Ad-Beaconing von Impressionen und Quartil finden Sie unter. Client-side Beaconing Weitere Informationen zu ADS und anderen Entitäten zur Anzeigenverifizierung finden Sie unter. Client-side Ad-Tracking-Integrationen

Informationen zur Weitergabe von Spielerparametern und Sitzungsdaten an das ADS für das clientseitige Tracking finden Sie unter und. MediaTailor Player-Variablen für ADS-Anfragen MediaTailor Sitzungsvariablen für ADS-Anfragen

Client-side Tracking ermöglicht Funktionen wie die folgenden:

Mithilfe der MediaTailor clientseitigen Tracking-API können Sie Metadaten an das Wiedergabegerät senden, die zusätzlich zum clientseitigen Tracking weitere Funktionen ermöglichen:

Client-side Arbeitsablauf für die Berichterstattung

Das folgende Diagramm zeigt den gesamten clientseitigen Berichtsworkflow von der Sitzungsinitialisierung über die Anzeigenwiedergabe bis hin zum Beaconing:

Der clientseitige Berichtsworkflow umfasst die folgenden Schritte:

Dieser Workflow ermöglicht erweiterte Funktionen wie Countdown-Timer für Anzeigen, Click-Through-Funktionen, Begleitanzeigen, überspringbare Anzeigen und die Anzeige von VAST-Symbolen zur Einhaltung der Datenschutzbestimmungen.

Aktivierung des clientseitigen Trackings

Sie aktivieren das clientseitige Tracking für jede Sitzung. Der Player sendet ein HTTP POST zum Endpunkt des MediaTailor Sitzungsinitialisierungspräfixes der Konfiguration. Optional kann der Player zusätzliche Metadaten senden, die dann verwendet werden können, wenn Werbeanrufe getätigt, der Ursprung für ein Manifest aufgerufen und MediaTailor Funktionen auf Sitzungsebene aufgerufen oder deaktiviert werden. MediaTailor

Das folgende Beispiel zeigt die Struktur der JSON-Metadaten:

{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

Verwenden Sie die MediaTailor Konsole oder API, um die URL der ADS-Anforderungsvorlage so zu konfigurieren, dass sie auf diese Parameter verweist. Im folgenden Beispiel player_params.param1 sind das die Player-Parameter für param1 und player_params.param2 sind die Player-Parameter fürparam2.

https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

Parameter für den Anzeigenserver

Auf der obersten Ebene der JSON-Struktur befindet sich ein JSON-Objekt. adsParams In diesem Objekt befinden sich key/value Paare, die alle Sitzungsanfragen lesen und an den Anzeigenserver senden MediaTailor können. MediaTailor unterstützt die folgenden Anzeigenserver:

Abfrageparameter für die Origin-Interaktion

Alle reservierten key/value Paare auf der obersten Ebene der JSON-Struktur, wie, und adsParams availSuppressionoverlayAvails, werden der URL der Quellanfrage nicht in Form von Abfrageparametern hinzugefügt. Jede Sitzungsmanifestanforderung, die an MediaTailor den Ursprung gesendet wird, enthält diese Abfrageparameter. Der Ursprung ignoriert überflüssige Abfrageparameter. Sie MediaTailor können die key/value Paare beispielsweise verwenden, um Zugriffstoken an den Ursprung zu senden.

Session-configured features

Verwenden Sie die JSON-Struktur für die Sitzungsinitialisierung, um Funktionen wie, und zu aktivieren, zu deaktivieren oder zu überschreiben MediaTailor. overlayAvails availSuppression adSignaling Alle Funktionskonfigurationen, die während der Sitzungsinitialisierung übergeben werden, überschreiben die Einstellung auf Konfigurationsebene. MediaTailor

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

Parameter für den Berichtsmodus

Sie können den Berichtsmodus bei der Initialisierung einer Sitzung angeben, indem Sie den reportingMode Parameter in den Anforderungstext aufnehmen. Dieser Parameter steuert, ob MediaTailor eine clientseitige oder serverseitige Anzeigenverfolgung für die Sitzung durchgeführt wird.

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad",
               "uid": "abdgfdyei-2283004-ueu"                     
           },
           "reportingMode": "server"
        }

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           },
           "reportingMode": "client"
        }

Eine erfolgreiche Antwort ist ein HTTP 200 mit einem Antworttext. Der Text enthält ein JSON-Objekt mit einem Schlüssel manifestUrl und einem trackingUrl Schlüssel. Die Werte sind relative URLs, die der Player sowohl für die Wiedergabe als auch für das Tracking von Werbeveranstaltungen verwenden kann.

{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

Weitere Informationen zum clientseitigen Tracking-Schema finden Sie unter. Client-side Schema und Eigenschaften für die Anzeigenverfolgung

Bewährte Methoden für das clientseitige Tracking

In diesem Abschnitt werden die bewährten Methoden für das clientseitige Tracking sowohl für Live- als auch MediaTailor für VOD-Workflows beschrieben.

Live-Workflows

Fragen Sie den Tracking-Endpunkt in einem Intervall ab, das jeder Zieldauer für HLS oder dem minimalen Aktualisierungszeitraum für DASH entspricht, um immer über die aktuellsten Metadaten zur Anzeigenverfolgung zu verfügen. Die Einhaltung dieses Intervalls ist besonders wichtig in Workflows, in denen die Kreativen möglicherweise eine interaktive Komponente oder eine Overlay-Komponente verwenden.

VOD-Arbeitsabläufe

Nach einer erfolgreichen Sitzungsinitialisierung und nach Erhalt des ersten MediaTailor Manifests, das Medien enthält, müssen Sie den Tracking-Endpunkt nur einmal aufrufen.

Server-guided Einfügen von Anzeigen

Server-guided Bei SGAI-Sitzungen (Ad Insertion) wird die API nicht verwendet. GetTracking Wenn du sie verwendestaws.reportingMode=CLIENT, werden stattdessen MediaTailor Tracking-Informationen im TRACKING Abschnitt jeder Antwort auf die Asset-Liste angezeigt, wenn Spieler Anzeigeninhalte anfordern. Die Antwort auf die Sitzungsinitialisierung enthält keine. trackingUrl

Die Antwort auf die Asset-Liste für clientseitig verfolgte SGAI-Sitzungen hat die folgende Struktur:

{
  "ASSETS": [
    { "DURATION": 20.0, "URI": "https://cdn.example.com/ad1/master.m3u8" },
    { "DURATION": 10.0, "URI": "https://cdn.example.com/ad2/master.m3u8" }
  ],
  "TRACKING": {
    ...VAST tracking events and beacon URLs for each ad...
  }
}

Bei der Implementierung von clientseitigem Tracking für SGAI-Methoden:

Durchblättern von Ad-Beacons mit GetTracking

Verwenden Sie den GetTracking Endpunkt, um die Anzahl der Anzeigen einzugrenzen, die an einen Player zurückgegeben werden. Wenn ein Manifestfenster beispielsweise breit ist und sich über einen langen Zeitraum erstreckt, kann sich die Anzahl der zurückgegebenen Ad-Beacons auf die Leistung des Players auswirken.

GetTrackinggibt einen NextToken Wert zurück, mit dem Sie die Anzahl der zurückgegebenen Beacons einschränken können, indem Sie die Liste der zurückgegebenen Beacons durchblättern. Sie können die NextToken Werte durchgehen, um den gewünschten Wert im Feld eines Ad-Beacons zu finden. StartTimeInSeconds

Generalisierte Aufrufsequenz von vom Player GetTracking

Eine GetTracking Anfrage des Client-Players ist ein POST mit einem Anforderungstext, der die Anzeigen NextToken und Beacons enthält, die sich auf das Token beziehen.

https://YouMediaTailorUrl/v1/tracking
{

     "NextToken": "value"
     .
     .
     .
}      
    

Die allgemeine Reihenfolge für die Verwendung von GetTracking with NextToken lautet wie folgt:

Erweitertes Beispiel

Dieses Beispiel zeigt, wie Sie die Anzahl GetTracking der NextToken an einen Player zurückgegebenen Ad-Beacons einschränken können.

MediaTailor erhält eine GetTracking Anfrage. Die Antwort enthält eine Anzeige mit der ID 9935407 und zwei Beacons mit den StartTimeInSeconds Werten 52,286 und 48,332 Sekunden.

MediaTailor sendet die JSON-Antwort wie folgt: NextToken

  {
  "NextToken": JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN0lqrBYycgMbKEb
  "avails": [
    {
      "ads": [
        {
          "adId": "9935407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15S",
          "durationInSeconds": 15,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT30S",
          "StartTimeInSeconds": 45,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=Impression "
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935414",
              "eventType": "secondQuartile",
              "startTime": "PT52.286S",
              "StartTimeInSeconds": 52.286
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=firstQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935412",
              "eventType": "firstQuartile",
              "startTime": "PT48.332S",
              "StartTimeInSeconds": 48.332
            }
          ],
          "vastAdId": ""
        }
      ],
      "startTime": "PT46.47S",
      "StartTimeInSeconds": 46.47
    }
  ]
}      
    

MediaTailor Antwortet bei der nächsten GetTracking Anfrage mit dem NextToken Wert: JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN0lqrBYycgMbKEb.

MediaTailor reagiert mit Anzeigen und Beacons, StartTimeInSeconds die den Einstellungen NextToken des vorherigen Anrufs entsprechen.

Gehen Sie davon aus, dass die Antwort jetzt zusätzlich zur vorherigen Anzeige mit der ID 9935407 eine weitere Anzeige mit der ID 9235407 enthält. Die Beacons der Anzeigen-ID 9235407 haben s 132.41 und 70.339. StartTimeInSeconds

MediaTailor durchläuft alle Beacons in der Sitzung, um diejenigen auszuwählen, die länger als 52,286 Sekunden sind. Dabei handelt es sich um StartTimeInSeconds Beacon 3 und Beacon 4 aus der Anzeige mit der ID 9235407:

{
  "NextToken": ZkfknvbfsdgfbsDFRdffg12EdffecFRvhjyjfhdfhnjtsg5SDGN
  "avails": [
    {
      "ads": [
        {
          "adId": "9235407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15.816S",
          "durationInSeconds": 19.716,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT2M0S",
          "StartTimeInSeconds": 120.0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=complete"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935414",
              "eventType": "firstQuartile",
              "startTime": "PT1M10.330S",
              "StartTimeInSeconds": 70.339
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=thirdQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935412",
              "eventType": "secondQuartile",
              "startTime": "PT2M12.41S",
              "StartTimeInSeconds": 132.41
            }
          ],
          "vastAdId": ""
        },   
      ],
      "startTime": "PT36.47S",
      "StartTimeInSeconds": 36.47
    }
  ]
}