MediaPlayer fornisce una funzione notificationClick() che invia eventi relativi agli annunci durante la riproduzione di un annuncio cliccabile. Questi eventi forniscono informazioni su annunci e interruzioni pubblicitarie che l’app può utilizzare per fornire funzionalità di click-through.
Quando viene riprodotto un annuncio cliccabile, MediaPlayer genera i seguenti eventi:
AdobePSDK.PSDKEventType.AD_STARTED
AdobePSDK.PSDKEventType.AD_CLICKED
AdobePSDK.PSDKEventType.AD_COMPLETED
Il AdClickedEvent
contiene le informazioni necessarie per elaborare la funzione di click-through.
Fornisci un controllo nel lettore che consenta agli utenti di fare clic sugli annunci cliccabili.
Potrebbe trattarsi di un pulsante o di qualsiasi altro elemento per acquisire il clic dell’utente.
Aggiungi un listener di eventi per l’evento ad click dell’utente.
Ad esempio:
document.getElementById([
<i>your_click_control_id</i>]).addEventListener("click", onAdClick);
Aggiungi un gestore per l’evento clic dell’utente.
Questo gestore deve richiedere a MediaPlayer di attivare AdClicked
evento.
onAdClick = function (event) {
// Get a reference to your player
var player = getPlayer();
if (player) {
// Call the MediaPlayer's notifyClick function
// which gets MediaPlayer to fire AdClicked
player.notifyClick();
}
}
Aggiungi i listener di eventi per le notifiche di avvio, clic e completamento degli annunci di MediaPlayer.
<i>your_player</i>().addEventListener(AdobePSDK.PSDKEventType.AD_STARTED, onAdStarted);
<i>your_player</i>().addEventListener(AdobePSDK.PSDKEventType.AD_COMPLETED, onAdCompleted);
<i>your_player</i>().addEventListener(AdobePSDK.PSDKEventType.AD_CLICKED, onAdClickedEvent);
Aggiungi gestori eventi.
a. Gestisci l’evento di inizio annuncio.
Questa operazione può comportare qualsiasi cosa, ad esempio la configurazione dell’interfaccia utente per l’utente.
onAdStarted = function (event) {
if (clickAddButton && event && event.ad) {
var adClick = event.ad.primaryAsset && event.ad.primaryAsset.adClick;
if (adClick && adClick.isValid) {
// Do some initial processing
// when the ad starts, prior
// to the user's click.
}
}
}
b. Gestisce l’evento su cui è stato fatto clic sull’annuncio.
In questo esempio, otteniamo informazioni sull’annuncio dall’evento e apriamo una nuova finestra del browser utilizzando tali informazioni:
onAdClickedEvent = function (event) {
if (event && event.ad) {
var adClick = event.adClick;
if (!(adClick && adClick.isValid)) {
adClick = event.ad.primaryAsset && event.ad.primaryAsset.adClick;
}
if (adClick && adClick.isValid)
{
// Do something with the currently playing ad
window.open(adClick.url);
}
}
}
c. Gestisci l’evento di annuncio completato.
onAdCompleted = function (event) {
if (clickAddButton) {
clickAddButton.setAttribute('hidden', 'true');
}
}