View a markdown version of this page

Server-side tracciamento con inserimento degli annunci guidato dal server (SGAI) - AWS Elemental MediaTailor

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à.

Server-side tracciamento con inserimento degli annunci guidato dal server (SGAI)

Quando utilizzi l'inserimento di annunci guidati dal server (SGAI), il tracciamento lato server utilizza un meccanismo di beaconing senza sessione che differisce dall'approccio in modalità congiunta descritto sopra. Invece di unire segmenti di MediaTailor annunci nel manifesto dei contenuti (dove tiene traccia delle /v1/segment richieste), SGAI restituisce i riferimenti agli annunci come playlist separate in una risposta all'elenco delle risorse con metadati beacon incorporati negli URI degli annunci.

Come funziona il beaconing lato server senza sessione

I passaggi seguenti descrivono come funziona il beaconing lato server per le sessioni SGAI:

  1. Inizializzazione della sessione: il giocatore richiede la playlist multivariante HLS con. aws.insertionMode=GUIDED Server-side il reporting è l'impostazione predefinita (non è necessario alcun parametro). aws.reportingMode A differenza della modalità stitched, la risposta di inizializzazione della sessione non include un. trackingUrl

  2. Manifesto memorizzabile nella cache: MediaTailor restituisce un manifesto memorizzabile nella cache contenente EXT-X-DATERANGE tag CLASS="com.apple.hls.interstitial" e X-ASSET-LIST attributi che puntano all'endpoint dell'elenco di risorse interstiziali. MediaTailor

  3. Elenco delle risorse con metadati dei beacon: quando il giocatore incontra un'interruzione pubblicitaria, recupera l'elenco degli asset. MediaTailorrestituisce una risposta JSON in cui ogni URI dell'annuncio include metadati beacon crittografati:

    { "ASSETS": [ { "DURATION": 30.0, "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>" } ] }

    Quando la segnalazione lato server è attiva, la risposta non include una sezione. TRACKING Gli URI degli annunci contengono tutti i dati dei beacon.

  4. Sostituzione variabile HLS: il giocatore recupera la playlist multivariante dell'annuncio. Il manifesto dell'annuncio utilizza le #EXT-X-DEFINE:QUERYPARAM direttive per passare i parametri del beacon dalla stringa di query URI agli URL dei segmenti tramite la sostituzione della variabile HLS:

    #EXTM3U #EXT-X-DEFINE:QUERYPARAM="awsBeaconData" #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain" #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName" #EXTINF:5.0, {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts

    Il player risolve le {$awsConfigurationName} variabili{$awsBeaconData},{$awsBeaconDomain}, e utilizzando i valori della stringa di query URI del manifesto dell'annuncio, quindi richiede l'invio di ogni segmento dell'annuncio. MediaTailor

  5. Il beacon viene attivato su richiesta di segmento: quando il giocatore richiede ogni segmento di annuncio, la richiesta viene inoltrata. MediaTailor Il servizio decodifica i dati del beacon, determina la posizione del segmento all'interno dell'annuncio (impressione, primo quartile, punto medio, terzo quartile o completo) e invia il beacon di tracciamento VAST appropriato all'ad server. MediaTailor quindi reindirizza il giocatore al segmento effettivo del contenuto dell'annuncio.

Requisiti del giocatore per il beaconing lato server SGAI

Per utilizzare il beaconing lato server con SGAI, il giocatore deve soddisfare i seguenti requisiti:

  • HLS versione 11 o successiva

  • Supporto per l'CLASSattributo EXT-X-DATERANGE with per HLS Interstitials

  • Supporto per la sostituzione delle #EXT-X-DEFINE:QUERYPARAM variabili (RFC 8216bis). Il giocatore deve decodificare in percentuale i valori dei parametri di interrogazione prima di sostituirli negli URL dei segmenti.

Nota

Il beaconing lato server SGAI è attualmente supportato solo per HLS. DASH non è ancora supportato per il beaconing SGAI lato server.

Confronto con il tracciamento lato server in modalità cucita

La tabella seguente riassume in che modo il tracciamento lato server differisce tra l'inserimento di annunci unito e guidato dal server:

Aspetto Stitched (SSAI) Server-guided (SGAI)
Capacità di memorizzazione nella cache manifesta Per-session, non memorizzabile nella cache Inseribile nella cache, condiviso tra gli spettatori
Routing dei segmenti pubblicitari Tramite /v1/segment/ l'utilizzo dell'ID di sessione Tramite /v1/segment/ l'utilizzo di un blob di dati beacon crittografato
Stato della sessione per i beacon Memorizzato per sessione in MediaTailor Senza sessione: tutto lo stato viene riportato nel parametro crittografato awsBeaconData
URL di tracciamento all'inizio della sessione Restituito nella risposta di inizializzazione della sessione Non fornito: i dati dei beacon sono incorporati negli URI degli annunci in ogni risposta all'elenco delle risorse
Supporto per DASH Supportata Non ancora supportato
Nota

Per le sessioni SGAI live, puoi abilitare il prefetching degli annunci basato su manifesti utilizzando. aws.guidedPrefetchMode=MANIFEST Questa è diversa dall'API di prefetch basata sulla pianificazione utilizzata con le sessioni Stitched (SSAI). Per informazioni dettagliate, vedi Prefetch guidato con battito cardiaco manifesto.