Gestire gli annunci cliccabili

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.

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

2. 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);
   

3. 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();
       }
   }
   

4. 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);
   

5. 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');
       }
   }
   

Risorse Business.Adobe.com