Kundenseitiges Ad-Tracking

Mithilfe der AWS Elemental MediaTailor clientseitigen Tracking-API können Sie Player-Steuerelemente während Werbepausen in Streaming-Workflows integrieren. Beim clientseitigen Tracking sendet der Player oder Client Tracking-Ereignisse wie Impressionen und Quartil-Ad-Beaconing an den Ad Decision Server (ADS) und andere Einheiten zur Anzeigenverifizierung. Bei diesen Ereignissen wird sowohl der Gesamtstatus der Werbeunterbrechung als auch die Anzahl der einzelnen Werbezeiträume innerhalb der einzelnen Werbeunterbrechungen erfasst. Weitere Informationen zu Impression and Quartile (ADS) und anderen Einheiten zur Anzeigenverifizierung finden Sie hier. Weitere Informationen zu Impression und Quartil-Ad-Beaconing finden Sie unter. Clientseitiges Beaconing Weitere Informationen zu ADS und anderen Entitäten zur Anzeigenverifizierung finden Sie unter. Kundenseitige Ad-Tracking-Integrationen

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

Das clientseitige 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:

Workflow für die clientseitige Berichterstattung

Das folgende Diagramm zeigt den gesamten Workflow für die clientseitige Berichterstattung 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 Werbeanzeigen, Click-Through-Funktionen, Begleitanzeigen, überspringbare Anzeigen und die Anzeige von VAST-Symbolen zur Einhaltung der Datenschutzbestimmungen.

Aktivierung von clientseitigem Tracking

Sie aktivieren das clientseitige Tracking für jede Sitzung. Der Player sendet ein HTTP POST an den Endpunkt des MediaTailor Sitzungsinitialisierungspräfixes der Konfiguration. Optional kann der Player zusätzliche Metadaten senden, die dann verwendet werden können, wenn er Werbeaufrufe tätigt, den Ursprung für ein Manifest aufruft und MediaTailor Funktionen auf Sitzungsebene aufruft oder deaktiviert. 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 die Player-Parameter für param1 und player_params.param2 die Player-Parameter fürparam2.

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

Serverparameter hinzufügen

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

Abfrageparameter für Origin-Interaktionen

Alle reservierten key/value Paare innerhalb der obersten Ebene der JSON-Struktur, wie, und adsParams availSuppressionoverlayAvails, werden der ursprünglichen Anforderungs-URL nicht in Form von Abfrageparametern hinzugefügt. Jede Sitzungsmanifestanforderung, die an MediaTailor den Ursprung gerichtet wird, enthält diese Abfrageparameter. Der Ursprung ignoriert überflüssige Abfrageparameter. MediaTailor Kann die key/value Paare beispielsweise verwenden, um Zugriffstoken an den Ursprung zu senden.

Für die Sitzung konfigurierte Funktionen

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 während der Sitzungsinitialisierung übergebenen Funktionskonfigurationen überschreiben die Einstellung auf der 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 Anfragetext aufnehmen. Dieser Parameter steuert, ob für die MediaTailor Sitzung clientseitiges oder serverseitiges Ad-Tracking 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 Hauptteil enthält ein JSON-Objekt mit einem manifestUrl und einem trackingUrl Schlüssel. Bei den Werten handelt es sich um relative Werte URLs , die der Player sowohl für die Wiedergabe als auch für die Nachverfolgung von Werbeereignissen 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. Schema und Eigenschaften für das clientseitige Ad-Tracking

Bewährte Methoden für die clientseitige Nachverfolgung

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 Ad-Tracking-Metadaten zu verfügen. Die Anpassung dieses Intervalls ist besonders wichtig in Workflows, bei denen die Kreativen möglicherweise über eine interaktive Komponente oder eine Overlay-Komponente verfügen.

VOD-Workflows

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

Durch Werbe-Beacons blättern mit GetTracking

Verwenden Sie den GetTracking Endpunkt, um die Anzahl der an einen Player zurückgegebenen Anzeigen einzuschränken. Wenn ein Manifestfenster beispielsweise groß ist und sich über einen langen Zeitraum erstreckt, kann sich die Anzahl der zurückgegebenen Werbe-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 nacheinander durchgehen, um den gewünschten Wert im Feld eines Werbe-Beacons zu finden. StartTimeInSeconds

Generalisierte Aufrufsequenz von vom Spieler GetTracking

Eine GetTracking Anfrage vom Client-Spieler ist ein POST mit einem Anforderungstext, der die Werbung NextToken und Beacons im Zusammenhang mit dem Token enthält.

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 mithilfe GetTracking von s die Anzahl der NextToken an einen Player zurückgegebenen Werbe-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 auf die nächste GetTracking Anfrage mit dem NextToken Wert: JF57 ITe48t1441mv7 Tm LKu ZLrox DzfIslp 6Bi SNL1 IJmz PVmDN0LQR Mb. BYycg KEb

MediaTailor antwortet mit Anzeigen und Beacons, die denen entsprechen, StartTimeInSeconds die beim vorherigen Anruf gesetzt wurden. NextToken

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 die Werte 132,41 und 70.339. StartTimeInSeconds

MediaTailor durchläuft alle Beacons in der Sitzung, um die Beacons mit StartTimeInSeconds mehr als 52,286 Sekunden auszuwählen, bei denen es sich um Beacon 3 und Beacon 4 aus der Anzeige mit der ID 9235407 handelt:

{
  "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
    }
  ]
}