View a markdown version of this page

Server-side tracciamento con inserimento di 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 di annunci guidato dal server (SGAI)

Quando utilizzi l'inserimento di annunci guidato dal server (SGAI), il tracciamento lato server utilizza un meccanismo di beaconing senza sessione che differisce dall'approccio in modalità cucita descritto sopra. Invece di unire i segmenti degli annunci MediaTailor 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 di risorse con metadati beacon incorporati negli URI degli annunci.

Come funziona il beaconing lato server senza sessioni

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 inseribile 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 beacon: quando il giocatore incontra un'interruzione pubblicitaria, recupera l'elenco delle risorse. 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 il reporting lato server è attivo, la risposta non include una sezione. TRACKING Gli URI degli annunci contengono tutti i dati dei beacon.

  4. Sostituzione di variabili 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 di variabili 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'utilizzo di ogni segmento dell'annuncio. MediaTailor

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

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

  • Support per EXT-X-DATERANGE con CLASS attributo per HLS Interstitials

  • Support per la sostituzione di #EXT-X-DEFINE:QUERYPARAM variabili (RFC 8216bis). Il player deve decodificare in percentuale i valori dei parametri di query 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 lato server SGAI.

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 cucito e quello guidato dal server:

Aspetto Cucito (SSAI) Server-guided (SGAI)
Memorizzabilità nella cache del manifesto Per-session, non inseribile nella cache Memorizzabile nella cache, condiviso tra gli spettatori
Routing dei segmenti di annunci 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 memorizzato nel parametro crittografato awsBeaconData
URL di tracciamento all'inizio della sessione Restituito nella risposta di inizializzazione della sessione Non fornito: i dati beacon sono incorporati negli URI degli annunci in ogni risposta all'elenco di 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 È separata dall'API di prefetch basata sulla pianificazione utilizzata con le sessioni stitched (SSAI). Per informazioni dettagliate, vedi Prefetch guidato con battito cardiaco manifesto.