Abilitare il tracciamento lato client Parametri del server pubblicitario Parametri della query di interazione Origin Funzionalità configurate per la sessione Le migliori pratiche per il tracciamento lato client

Tracciamento lato client

Utilizzando l'API di tracciamento AWS Elemental MediaTailor lato client, puoi incorporare i controlli del lettore durante le interruzioni pubblicitarie nei flussi di lavoro di streaming. Nel tracciamento lato client, il player o il client invia eventi di tracciamento, come impressioni e annunci in quartile, all'Ad Decision Server (ADS) e ad altre entità di verifica degli annunci. Per ulteriori informazioni sulle impressioni e sul quartile ad beaconing, consulta. Beaconing lato client Per ulteriori informazioni su ADS e altre entità di verifica degli annunci, consulta. Integrazioni di tracciamento degli annunci sul lato client

Il tracciamento lato client abilita funzionalità come le seguenti:

Timer per il conto alla rovescia di Ad-Break: per ulteriori informazioni, consulta. Aggiungi un conto alla rovescia
Ad click-through: per ulteriori informazioni, consulta. E click-through
Visualizzazione di annunci complementari - Per ulteriori informazioni, consulta. Annunci complementari
Annunci ignorabili: per ulteriori informazioni, consulta. Annunci ignorabili
Visualizzazione delle icone VAST per la conformità alla privacy - Per ulteriori informazioni, vedere. Icone per Google Why This Ad (WTA)
Controllo dello scorrimento del mouse da parte dei giocatori durante gli annunci - Per ulteriori informazioni, consulta. Lavaggio

Utilizzando l'API di tracciamento MediaTailor lato client, puoi inviare metadati al dispositivo di riproduzione che abilita funzionalità oltre al tracciamento lato client:

Argomenti

Abilitazione del tracciamento lato client

Si abilita il tracciamento lato client per ogni sessione. Il player crea un HTTP sull'endpoint del POST prefisso di MediaTailor inizializzazione della sessione della configurazione. Facoltativamente, il player può inviare metadati aggiuntivi MediaTailor da utilizzare per effettuare chiamate pubblicitarie, richiamare l'origine per un manifesto e richiamare o disabilitare funzionalità a livello di sessione. MediaTailor

L'esempio seguente mostra la struttura dei metadati JSON:


{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

Utilizza la MediaTailor console o l'API per configurare l'URL del modello di richiesta ADS in modo che faccia riferimento a questi parametri. Nell'esempio seguente, player_params.param1 sono i parametri del giocatore per param1 e player_params.param2 sono i parametri del giocatore perparam2.


https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

Parametri del server pubblicitario

Al livello più alto della struttura JSON c'è un oggetto JSON. adsParams All'interno di questo oggetto sono presenti coppie chiave/valore che MediaTailor possono essere lette e inviate all'ad server in tutte le richieste di sessione. MediaTailor supporta i seguenti ad server:

Google Ad Manager
SpringServe
FreeWheel
Publica

Parametri della query di interazione Origin

Qualsiasi coppia chiave/valore riservata all'interno del livello più alto della struttura JSON, ad esempio, e adParams availSuppressionoverlayAvails, non viene aggiunta all'URL della richiesta di origine sotto forma di parametri di query. Ogni richiesta di manifesto di sessione inviata all' MediaTailor origine contiene questi parametri di query. L'origine ignora i parametri di interrogazione estranei. Ad esempio, MediaTailor può utilizzare le coppie chiave/valore per inviare token di accesso all'origine.

Funzionalità configurate in base alla sessione

Utilizza la struttura JSON di inizializzazione della sessione per abilitare, disabilitare o sovrascrivere funzionalità come, e. MediaTailor overlayAvails availSuppression adSignaling Qualsiasi configurazione di funzionalità passata durante l'inizializzazione della sessione ha la precedenza sull'impostazione a livello di configurazione. MediaTailor

Nota

I metadati inviati al MediaTailor momento dell'inizializzazione della sessione sono immutabili e non è possibile aggiungere metadati aggiuntivi per tutta la durata della sessione. Utilizzate i marcatori SCTE-35 per trasportare i dati che cambiano durante la sessione. Per ulteriori informazioni, consulta Utilizzo delle variabili di sessione.

Esempio : Esecuzione del tracciamento degli annunci sul lato client per HLS


POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

Esempio : Esecuzione del tracciamento degli annunci lato client per DASH


POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

Una risposta corretta è un HTTP 200 con un corpo di risposta. Il corpo contiene un oggetto JSON con una chiave manifestUrl e una trackingUrl chiave. I valori sono URL relativi che il giocatore può utilizzare sia per la riproduzione che per il tracciamento degli eventi pubblicitari.


{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

Per ulteriori informazioni sullo schema di tracciamento lato client, consulta. Schema di tracciamento degli annunci sul lato client

Le migliori pratiche per il tracciamento lato client

Questa sezione descrive le migliori pratiche per il tracciamento lato client per i flussi di lavoro live e MediaTailor VOD.

Flussi di lavoro in tempo reale

Esegui un sondaggio sull'endpoint di tracciamento a intervalli corrispondenti a ogni durata prevista per HLS o al periodo minimo di aggiornamento per DASH, in modo da avere sempre i metadati di tracciamento degli annunci più aggiornati. La corrispondenza di questo intervallo è particolarmente importante nei flussi di lavoro in cui i creativi potrebbero avere un componente interattivo o di sovrapposizione.

Nota

Alcuni giocatori supportano gli ascoltatori di eventi, che potrebbero essere usati come alternativa ai sondaggi. Ad esempio, la funzione di decorazione degli ID MediaTailor pubblicitari dovrebbe essere abilitata per ogni sessione. Per ulteriori informazioni, consulta Decorazione dell'annuncio. L'utilizzo di questa funzionalità mette a disposizione un intervallo di date (HLS) o un identificatore di elemento di evento (DASH) su ogni annuncio. I giocatori possono utilizzare questi tag manifest per richiedere la chiamata all'endpoint di MediaTailor tracciamento della sessione.

Flussi di lavoro VOD

Dopo una corretta inizializzazione della sessione e dopo aver MediaTailor ricevuto il primo manifesto contenente i file multimediali, è sufficiente chiamare l'endpoint di tracciamento una sola volta.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Tracciamento lato server

Schema di tracciamento degli annunci