View a markdown version of this page

Client-side intégrations de suivi des publicités - AWS Elemental MediaTailor
Open Measurement SDKSDK pour lecteurs gratuits DatazoomRAFTheoPlayerMediaTailor SDK

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.

Client-side intégrations de suivi des publicités

Cette section décrit les intégrations entre MediaTailor et divers serveurs de suivi des publicités côté client.

Open Measurement SDK

Le SDK Open Measurement (OM SDK) de l'Interactive Advertising Bureau (IAB) facilite la mesure de la visibilité et de la vérification par des tiers pour les publicités diffusées dans des environnements de vidéos Web et d'applications natives.

Pour les anciens documents VAST version 3, le code de vérification doit être chargé avec le nœud Extension, avec le type d'extensionAdVerifications. La racine du nœud d'extension est un AdVerifications nœud dont le schéma est le même que celui de l'élément VAST 4.1.

Pour faciliter l'adoption du SDK OM, MediaTailor a établi un partenariat avec Datazoom pour fournir des SDK gratuits pour les joueurs qui sont configurés et vérifiés pour Open Measurement. Pour de plus amples informations, veuillez consulter SDK pour lecteurs gratuits Datazoom.

Note

MediaTailor ne prend actuellement en charge que la version 3 de VAST.

Exemple: nœud de vérification dans VAST 3, avant la version 4.1
...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>

MediaTailor extrait les AdVerifications données du <Extensions> nœud et les place dans le adVerifications tableau dans la réponse de suivi côté client.

Exemple: tableau ADVerifications dans la réponse de suivi côté client
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}
Note

Collaborez avec l'IAB Tech Lab pour vous assurer que les applications sont certifiées chaque année afin de garantir la conformité.

Pour plus d'informations sur le SDK OM, consultez Open Measurement SDK sur le site Web de l'IAB Tech Lab.

SDK pour lecteurs gratuits Datazoom

Pour faciliter l'adoption des SDK pour les joueurs, MediaTailor a établi un partenariat avec Datazoom pour fournir des SDK gratuits pour les joueurs qui sont configurés et testés avec et avec la Client-side AWS Elemental MediaTailor intégration avec Google Ad Manager technologie IAB. Open Measurement SDK

Le SDK du lecteur Datazoom prend en charge les fonctionnalités suivantes :

  • Playlists en direct et VOD

  • Spécifications DASH et HLS

  • Support des fournisseurs de lecteurs pour Bitmovin, exoplayer, lecteur multimédia Android, Apple AVPlayer, Brightcove, Chromecast Receiver, hls.js, JWPlayer, lecteur Dash.js Shaka, lecteur THEO, Roku, etc. Video.js

  • Certification IAB Tech Lab Open Measurement, si disponible sur certains appareils

  • Click-through gestion des événements

  • Ad-event les répartiteurs, tels que les comptes à rebours des publicités, les événements non linéaires et superposés d'annonces, le début de la pause publicitaire, la fin de la pause publicitaire

  • Client-side et balisage

  • SDK PAL (Google Programmatic Access Library), en tant que paramètre de configuration facultatif

Datazoom propose également un service d'analyse et de télémétrie payant pris en charge par les SDK des joueurs. Les clients peuvent activer et contrôler la télémétrie du SDK des joueurs depuis la console de gestion Datazoom. Pour accéder aux SDK du lecteur Datazoom et en savoir plus sur le service de télémétrie et d'analyse à valeur ajoutée, utilisez les coordonnées figurant sur le site Datazoom. https://www.datazoom.io/partner-aws

Cadre publicitaire Roku (RAF)

Le Roku Ad Framework (RAF) assure une expérience publicitaire cohérente sur l'ensemble de la plateforme Roku. Toutes les chaînes, y compris les publicités vidéo, doivent répondre aux exigences de certification de Roku pour la RAF. Notamment, l'application doit toujours utiliser le déclenchement d'événements côté client via la RAF. MediaTailor, en tant que fournisseur d'insertion d'annonces côté serveur (SSAI), prend en charge le déclenchement d'événements côté client. Les adaptateurs RAFX SSAI fournissent des interfaces à la fois avec les serveurs de manifestes SSAI, ou Stitchers, et avec RAF. Ces interfaces incluent :

  • Analyse de la masterURL réponse et extractionplayURL,AdURL, et des métadonnées de l'annonce.

  • Transformation des métadonnées publicitaires MediaTailor SSAI en métadonnées RAF-usable publicitaires et configuration de la RAF pour la lecture.

  • Observation des événements des flux et des métadonnées chronométrées.

  • Faire correspondre les événements de diffusion, les métadonnées des publicités et les pixels de l'événement de déclenchement à temps.

  • Pinging/polling leAdURL, comme l'exige le serveur de manifeste MediaTailor SSAI, puis l'analyse et la reconfiguration de RAF.

Pour plus d'informations sur les adaptateurs SSAI pour RAF, consultez la section Mise en œuvre de l'insertion d' Server-Side annonces à l'aide d'adaptateurs Roku sur le site Web de Roku.

TheoPlayer

TheoPlayer l'intégration avec MediaTailor effectue les opérations suivantes :

  • Fournit des fonctionnalités permettant de prendre en charge le suivi des événements MediaTailor côté client pour HLS et DASH pour les flux de travail en direct et de VOD.

  • Prend en charge l'envoi de balises de suivi uniquement pour les publicités linéaires.

  • Désactive la recherche pendant une annonce. Cependant, aucune logique n'est en place pour diffuser une annonce lorsque l'utilisateur cherche après la pause publicitaire.

Pour plus d'informations sur SSAI in TheoPlayer et pour passer en revue les SDK Web, Android, iOS et tvOS pour MediaTailor, consultez MediaTailor le site Web. TheoPlayer

MediaTailor SDK

AWS Elemental gère un kit de JavaScript-based développement logiciel (SDK). AWS Elemental fournit le SDK tel quel, sans garantie implicite. Utilisez le SDK comme démonstration de référence pour rationaliser votre intégration à l'utilisation. MediaTailor Le SDK montre comment interagir avec l'API de suivi MediaTailor côté client. Le SDK met en œuvre le suivi des publicités côté client et la création de rapports pour les joueurs. HTML5-based Le SDK initialise une session de reporting MediaTailor côté client, puis demande périodiquement des informations de suivi des publicités. Pendant la lecture, le SDK émet des événements de suivi des publicités lorsque de nouveaux événements publicitaires sont détectés.

Le MediaTailor SDK prend en charge les fonctionnalités suivantes :

  • Playlists en direct et VOD

  • Spécifications DASH et HLS

  • Click-through gestion des événements

  • Ad-event répartiteurs

  • Crochets événementiels personnalisés

  • Client-side et balisage. Pour plus d'informations sur l'envoi de balises publicitaires, consultezClient-side balisage.

Note

Soumettez un ticket d' AWS assistance pour recevoir un exemple de JavaScript SDK pour MediaTailor. Vous recevrez un lien de téléchargement pour le package et ses fichiers.