View a markdown version of this page

Ad-tracking calendrier des activités - AWS Elemental MediaTailor

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ad-tracking calendrier des activités

Avec les rapports côté client, le joueur doit émettre des événements de suivi (balises) avec un certain niveau de précision. À l'aide du schéma de suivi MediaTailor côté client, vous pouvez vous assurer que, pour chaque événement d'annonce, d'accompagnement, de superposition et de suivi, les informations relatives au calendrier et à la durée sont présentes, sous différentes formes.

Utilisez les MediaTailor key/value paires suivantes pour que le lecteur réconcilie avec précision les activités liées aux événements publicitaires, telles que le suivi des événements, avec la position de lecture :

HLS et DASH mettent en œuvre la valeur de startTime et startTimeInSeconds différemment :

  • HLS - Les startTime valeurs sont relatives au début de la session de lecture. Le début de la session de lecture est défini comme l'heure zéro. L'annonce startTime est la somme des valeurs cumulées de toutes les durées des EXT-INF segments qui ont précédé la mise en vente. Le numéro de séquence multimédia du segment auquel se rapporte l'annonce ou l'événement de suivi correspond également à la réponse adId de suivi côté client. eventId

  • DASH :

    • Live/dynamic manifestes - Les startTime valeurs sont relatives à celles MPD@availabilityStartTime du manifeste DASH. MPD@avaibilityStartTimeIl s'agit d'un point d'ancrage temporel pour toutes les MediaTailor sessions qui consomment le flux.

    • VOD/static manifestes : les startTime valeurs sont relatives au début de la session de lecture. Le début de la session de lecture est défini comme l'heure zéro. Chaque annonce contenue dans le produit est contenue dans son propre Period élément. L'Periodélément possède un @start attribut dont la valeur est identique à celle de la startTime charge utile de suivi côté client. Cela correspond PeriodId également au adId ou eventId dans la réponse de suivi côté client.

Exemple HLS :

Dans l'exemple suivant, la MediaTailor session a démarré et le manifeste suivant est le premier transmis au client :

#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

Dans la charge utile JSON de suivi côté client, les valeurs suivantes s'appliquent :

  • startTime: "PT18.581355S"

  • startTimeInSeconds: 18.581

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

  • adId: 4603269

Exemple DASH :

Dans l'exemple suivant, la MediaTailor session obtient un midroll dans le manifeste. Notez que la valeur d'@startattribut de la deuxième période, qui est la période de l'annonce, possède une valeur relative à la MPD@availabilityStartTime valeur. Cette valeur est celle qui est écrite dans MediaTailor les startTime champs de réponse de suivi côté client, pour toutes les sessions.

<?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>

Dans la charge utile JSON de suivi côté client, les valeurs suivantes s'appliquent :

  • startTime: "PT5042H27M59.931S"

  • startTimeInSeconds: 18152879.931

  • availProgramDateTime: null

  • adId: 1683151599194_1_1