TVSDK supporta annunci per banner complementari, che sono annunci che accompagnano un annuncio lineare e spesso rimangono sulla pagina dopo la fine dell’annuncio lineare. La tua applicazione è responsabile della visualizzazione dei banner complementari che sono forniti con un annuncio lineare.
Quando si visualizzano gli annunci companion, attenersi alle seguenti raccomandazioni:
Tenta di presentare il numero di annunci banner di un annuncio video come si adatterà al layout del tuo giocatore.
Presentare un banner complementare solo se si dispone di una posizione che corrisponde esattamente alla sua altezza e larghezza specificate.
Non ridimensionare il banner.
Presenta i banner associati il prima possibile dopo l’inizio dell’annuncio.
Non sovrapporre il contenitore principale annuncio/video con banner complementari.
Continua a visualizzare i banner complementari dopo la fine dell’annuncio.
Lo standard è quello di visualizzare ogni banner associato fino a quando non si dispone di una sostituzione per questo banner.
Il contenuto di un AdBannerAsset descrive un banner correlato.
L'evento AdPlaybackEvent.AD_STARTED
restituisce un'istanza Ad
che contiene una proprietà companionAssets
( Vector.<AdAsset>
).
Ogni elemento AdAsset
fornisce informazioni sulla visualizzazione della risorsa.
Informazioni disponibili | Descrizione |
---|---|
larghezza | Larghezza del banner correlato in pixel. |
altezza | Altezza del banner correlato in pixel. |
tipo di risorsa | Tipo di risorsa per il banner correlato:
|
dati banner | I dati del tipo specificato da resourceType per questo banner correlato. |
URL statico | A volte, il banner associato ha anche un URL statico che è un URL diretto all'immagine o a un .swf (banner flash). Se non desideri utilizzare html o iframe, puoi utilizzare un URL diretto per un’immagine o un swf per visualizzare il banner nella fase di Flash. In questo caso, puoi utilizzare staticURL per visualizzare il banner. Importante: È necessario verificare se l’URL statico è una stringa valida, perché questa proprietà potrebbe non essere sempre disponibile. |
Per visualizzare gli annunci banner, devi creare istanze banner e consentire a TVSDK di ascoltare gli eventi relativi agli annunci.
TVSDK fornisce un elenco di banner pubblicitari associati a un annuncio lineare tramite l'evento AdPlaybackEvent.AD_STARTED
.
I manifesti possono specificare annunci di banner complementari per:
Per ogni annuncio correlato, TVSDK indica quali tipi sono disponibili per l’applicazione.
Aggiungi un listener per l'evento AdPlaybackEvent.AD_STARTED
che esegue le seguenti operazioni:
Cancella gli annunci esistenti nell'istanza del banner.
Ottiene l'elenco degli annunci companion da Ad.companionAssets
.
Se l’elenco degli annunci associati non è vuoto, ripeti l’errore sopra l’elenco per le istanze del banner.
Ogni istanza di banner ( an AdBannerAsset
) contiene informazioni quali larghezza, altezza, tipo di risorsa (html, iframe o statico) e dati necessari per visualizzare il banner correlato.
Se un annuncio video non ha annunci correlati prenotati con esso, l’elenco delle risorse correlate non contiene dati per quell’annuncio video.
Per mostrare un annuncio di visualizzazione indipendente, aggiungi la logica al tuo script per eseguire un tag di annunci di visualizzazione normale DFP (DoubleClick for Publishers) nell’istanza di banner appropriata.
Invia le informazioni sul banner a una funzione nella pagina, in genere JavaScript, utilizzando ExternalInterface
, che visualizza i banner in una posizione appropriata.
In genere si tratta di una div
e la funzione utilizza div ID
per visualizzare il banner. Ad esempio:
Aggiungi il listener di eventi:
_player.addEventListener(AdobePSDK.PSDKEventType.AD_STARTED, onAdStarted);
Implementa il gestore di listener:
private function onAdStarted(event:AdPlaybackEvent):void {
// check if there are any companion banner
if (event.ad && event.ad.companionAssets
&& event.ad.companionAssets.length > 0) {
for each (var banner:AdBannerAsset in event.ad.companionAssets) {
if (ExternalInterface.available) {
//-- call the java script that will handle the banner display.
ExternalInterface.call('addBanner', banner.resourceType,
banner.width, banner.height, banner.bannerData);
}
}
}
//...
}
Esempio di JavaScript per gestire la visualizzazione:
function addBanner(resourceType, width, height, data) {
console.log(resourceType + "," + width + "," + height);
//Assume an html element on the page with id like 'banner300x250'
var bannerDiv = document.getElementById('banner' + width +
'x' + height);
if (bannerDiv != null) {
if (resourceType == "html") { // for html resource
bannerDiv.innerHTML = data;
}
else if (resourceType == "iframe") { // for iframe resource
bannerDiv.innerHTML = "<iframe src='" + data +
"' width='100%' height='100%'></iframe>";
}
}
}