View a markdown version of this page

Client-side integrazioni per il tracciamento degli annunci - AWS Elemental MediaTailor
Apri l'SDK di misurazioneSDK per lettori gratuiti DatazoomRAFTheoPlayerMediaTailor SDK

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Client-side integrazioni per il tracciamento degli annunci

Questa sezione descrive le integrazioni tra MediaTailor e vari server di tracciamento degli annunci lato client.

Apri Measurement SDK

L'Interactive Advertising Bureau (IAB) Open Measurement SDK (OM SDK) facilita la misurazione della visibilità e della verifica da parte di terze parti degli annunci pubblicati in ambienti con video web e app native.

Per i documenti VAST precedenti alla versione 3, il codice di verifica deve essere caricato con il nodo Extension, con il tipo di estensione. AdVerifications La radice del nodo di estensione è un AdVerifications nodo con lo stesso schema dell'elemento VAST 4.1.

Per facilitare l'adozione dell'OM SDK, MediaTailor ha collaborato con Datazoom per fornire SDK gratuiti per i giocatori configurati e verificati per Open Measurement. Per ulteriori informazioni, consulta SDK per lettori gratuiti Datazoom.

Nota

MediaTailor attualmente supporta solo la versione 3 di VAST.

Esempio: nodo di verifica in VAST 3, precedente alla versione 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 estrae i AdVerifications dati dal <Extensions> nodo e li inserisce nell'adVerificationsarray nella risposta di tracciamento lato client.

Esempio: array AdVerifications nella risposta di tracciamento lato 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": []
}
Nota

Rivolgiti allo IAB Tech Lab per garantire che le applicazioni siano certificate annualmente per garantire la conformità.

Per ulteriori informazioni sull'OM SDK, consulta Open Measurement SDK sul sito web di IAB Tech Lab.

SDK per lettori gratuiti Datazoom

Per facilitare l'adozione degli SDK del player, MediaTailor ha collaborato con Datazoom per fornire SDK gratuiti per i giocatori configurati e testati con IAB Tech. Client-side AWS Elemental MediaTailor integrazione con Google Ad Manager Apri Measurement SDK

L'SDK del lettore Datazoom supporta queste funzionalità:

  • Playlist live e VOD

  • Specifiche DASH e HLS

  • Supporto dei fornitori di lettori per Bitmovin, exoplayer, lettore multimediale Android, Apple AVPlayer, Brightcove, Chromecast Receiver, hls.js, JWPlayer, Shaka player, THEO player Dash.js, Roku e altro Video.js

  • Certificazione IAB Tech Lab Open Measurement, se disponibile su dispositivi selezionati

  • Click-through gestione degli eventi

  • Ad-event dispatcher, come i timer per il conto alla rovescia degli annunci, gli eventi in sovrapposizione e non lineari, l'inizio dell'interruzione dell'annuncio, la fine dell'interruzione dell'annuncio

  • Client-side e beaconing

  • Google Programmatic Access Library (PAL) SDK, come impostazione di configurazione opzionale

Datazoom offre anche un servizio di analisi e telemetria a pagamento supportato dagli SDK del player. I clienti possono attivare e controllare la telemetria SDK del giocatore dalla console di gestione Datazoom. Per accedere agli SDK del lettore Datazoom e per saperne di più sul servizio di telemetria e analisi a valore aggiunto, utilizza le informazioni di contatto sul sito Datazoom.

Roku Advertising Framework (RAF)

Il Roku Ad Framework (RAF) mantiene un'esperienza pubblicitaria coerente su tutta la piattaforma Roku. Tutti i canali, compresi gli annunci video, devono soddisfare i requisiti di certificazione di Roku per RAF. In particolare, l'app deve sempre utilizzare la generazione di eventi lato client tramite RAF. MediaTailor, in qualità di provider SSAI (server-side ad insertion), supporta la generazione di eventi lato client. Gli adattatori SSAI RAFX forniscono interfacce sia ai server manifest SSAI, o stitcher, che a RAF. Queste interfacce includono:

  • Analisi della masterURL risposta ed estrazione e dei playURL metadati degli AdURL annunci.

  • Trasformazione dei metadati degli annunci MediaTailor SSAI in metadati degli annunci RAF-usable e configurazione di RAF per la riproduzione.

  • Osservazione degli eventi di streaming e dei metadati temporizzati.

  • Corrispondenza puntuale degli eventi di streaming, dei metadati degli annunci e dei pixel degli eventi di attivazione.

  • Pinging/polling poiAdURL, come richiesto dal server manifest MediaTailor SSAI, quindi analisi e riconfigurazione di RAF.

Per ulteriori informazioni sugli adattatori SSAI per RAF, consulta Implementazione dell'inserimento di Server-Side annunci tramite adattatori Roku sul sito Web di Roku.

TheoPlayer

TheoPlayer l'integrazione con MediaTailor effettua le seguenti operazioni:

  • Fornisce funzionalità per supportare il tracciamento degli eventi MediaTailor lato client per HLS e DASH sia per i flussi di lavoro VOD che live.

  • Supporta l'invio di beacon di tracciamento solo per annunci lineari.

  • Disattiva la ricerca durante un annuncio. Tuttavia, non esiste alcuna logica per riprodurre un annuncio quando l'utente cerca oltre l'interruzione pubblicitaria.

Per ulteriori informazioni su SSAI in TheoPlayer e per rivedere gli SDK per il Web, Android, iOS e tvOS MediaTailor, consulta il MediaTailorsito Web. TheoPlayer

MediaTailor SDK

AWS Elemental gestisce un kit di JavaScript-based sviluppo software (SDK). AWS Elemental fornisce l'SDK così com'è, senza alcuna garanzia implicita. Utilizzate l'SDK come dimostrazione di riferimento per semplificare l'onboarding e utilizzarlo. MediaTailor L'SDK mostra come interagire con l'API di tracciamento lato client. MediaTailor L'SDK implementa il monitoraggio e il reporting degli annunci sul lato client per i giocatori. HTML5-based L'SDK inizializza una sessione di reporting MediaTailor lato client, quindi richiede periodicamente informazioni sul tracciamento degli annunci. Durante la riproduzione, l'SDK emette eventi di tracciamento degli annunci quando vengono rilevati nuovi eventi pubblicitari.

L' MediaTailor SDK supporta queste funzionalità:

  • Playlist live e VOD

  • Specifiche DASH e HLS

  • Click-through gestione degli eventi

  • Ad-event spedizionieri

  • ganci per eventi personalizzati

  • Client-side e beaconing. Per ulteriori informazioni sull'invio di ad beacon, consulta. Client-side beaconing

Nota

Invia un ticket di AWS supporto per ricevere un JavaScript SDK di esempio per MediaTailor. Riceverai un link per il download del pacchetto e dei relativi file.