View a markdown version of this page

Ad-tracking Zeitpunkt der Aktivität - AWS Elemental MediaTailor

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ad-tracking Zeitpunkt der Aktivität

Bei der clientseitigen Berichterstattung muss der Spieler Tracking-Ereignisse (Beacons) mit einer gewissen Präzision aussenden. Mithilfe des MediaTailor clientseitigen Tracking-Schemas können Sie sicherstellen, dass für jedes verfügbare Werbe-, Begleitungs-, Overlay- und Tracking-Ereignis Informationen zu Zeitpunkt und Dauer in unterschiedlicher Form vorliegen.

Verwenden Sie die folgenden MediaTailor key/value Paare, damit der Player die Aktivitäten von Werbeveranstaltungen, wie z. B. das Verfolgen von Ereignissen, präzise mit der Wiedergabeposition abgleicht:

HLS und DASH implementieren den Wert von startTime und unterschiedlich: startTimeInSeconds

  • HLS — Die startTime Werte beziehen sich auf den Beginn der Wiedergabesitzung. Der Beginn der Wiedergabesitzung ist als Zeit Null definiert. Der Wert der Anzeige startTime ist die Summe der kumulativen Werte aller EXT-INF Segmente, die bis zum Avail geführt haben. Die Mediensequenznummer des Segments, auf das die Anzeige oder das Tracking-Ereignis fällt, entspricht auch dem adId oder eventId in der clientseitigen Tracking-Antwort.

  • DASH:

    • Live/dynamic Manifeste — Die startTime Werte beziehen sich auf die Werte des MPD@availabilityStartTime DASH-Manifests. Das MPD@avaibilityStartTime ist ein Timing-Anker für alle MediaTailor Sitzungen, die den Stream konsumieren.

    • VOD/static Manifeste — Die startTime Werte beziehen sich auf den Beginn der Wiedergabesitzung. Der Beginn der Wiedergabesitzung ist als Zeit Null definiert. Jede Anzeige im Avail ist in einem eigenen Period Element enthalten. Das Period Element hat ein @start Attribut mit einem Wert, der den startTime Werten in der clientseitigen Tracking-Nutzlast entspricht. Das entspricht PeriodId auch dem adId oder eventId in der clientseitigen Tracking-Antwort.

Beispiel HLS:

Im folgenden Beispiel wurde die MediaTailor Sitzung gestartet, und das folgende Manifest ist das erste, das an den Client gesendet wurde:

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:4603263
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:23.295678Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_34.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:27.306345Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_35.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:31.317012Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_36.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:35.327679Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_37.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:39.338346Z
#EXTINF:2.538667,
https://123.cloudfront.net/out/v1/index_1_38.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:41.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:43.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00002.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:45.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00003.ts

In der clientseitigen Tracking-JSON-Payload gelten die folgenden Werte:

  • startTime: "PT18.581355S"

  • startTimeInSeconds: 18.581

  • availProgramDateTime: "2023-05-03T21:24:41.453Z"

  • adId: 4603269

Beispiel DASH:

Im folgenden Beispiel erhält die MediaTailor Sitzung eine Midroll im Manifest. Beachten Sie, dass der @start Attributwert der zweiten Periode, bei der es sich um den Anzeigenzeitraum handelt, einen Wert hat, der MPD@availabilityStartTime relativ zum Wert ist. Dieser Wert wird für alle Sitzungen in die clientseitigen startTime Tracking-Antwortfelder MediaTailor geschrieben.

<?xml version="1.0" encoding="UTF-8"?>
<MPD availabilityStartTime="2022-10-05T19:38:39.263Z" minBufferTime="PT10S" minimumUpdatePeriod="PT2S" profiles="urn:mpeg:dash:profile:isoff-live:2011" publishTime="2023-05-03T22:06:48.411Z" suggestedPresentationDelay="PT10S" timeShiftBufferDepth="PT1M30S" type="dynamic" xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd">
    <BaseURL>https://123.channel-assembly.mediatailor.us-west-2.amazonaws.com/v1/channel/my-channel/</BaseURL>
    <Location>https://123.cloudfront.net/v1/dash/94063eadf7d8c56e9e2edd84fdf897826a70d0df/MediaTailor-Live-HLS-DASH/channel/channel1/dash.mpd?aws.sessionId=794a15e0-2a7f-4941-a537-9d71627984e5</Location>
    <Period id="1683151479166_1" start="PT5042H25M59.903S" xmlns="urn:mpeg:dash:schema:mpd:2011">
        <BaseURL>https://123.cloudfront.net/out/v1/f1a946be8efa45b0931ea35c9055fb74/ddb73bf548a44551a0059c346226445a/eaa5485198bf497284559efb8172425e/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
    <Period id="1683151599194_1_1" start="PT5042H27M59.931S">
        <BaseURL>https://123.cloudfront.net/tm/94063eadf7d8c56e9e2edd84fdf897826a70d0df/fpc5omz5wzd2rdepgieibp23ybyqyrme/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
</MPD>

In der clientseitigen Tracking-JSON-Payload gelten die folgenden Werte:

  • startTime: "PT5042H27M59.931S"

  • startTimeInSeconds: 18152879.931

  • availProgramDateTime: null

  • adId: 1683151599194_1_1