Tracciare gli annunci tramite JavaScript 3.x

IMPORTANTE

Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 3.x. Se stai implementando versioni precedenti dell’SDK, puoi scaricare le Guide per gli sviluppatori qui: Scaricare gli SDK.

Costanti di tracciamento annunci

Nome costante Descrizione
AdBreakStart Costante per il tracciamento dell'evento AdBreak Start
AdBreakComplete Costante per il tracciamento dell'evento AdBreak Complete
AdStart Costante per il tracciamento dell'evento Ad Start
AdComplete Costante per il tracciamento dell'evento Ad Complete
AdSkip Costante per il tracciamento dell'evento Ad Skip

Passaggi di implementazione

  1. Identificate quando inizia il limite di interruzione annuncio, incluso il pre-roll, e create un'interruzione AdBreakObject utilizzando le informazioni di interruzione annuncio.

    AdBreakObject riferimento:

    Nome della variabile Tipo Descrizione
    name string Stringa non vuota che denota il nome dell'interruzione adattiva (pre-roll, mid-roll e post-roll).
    position number La posizione del numero dell'interruzione annuncio che inizia con 1.
    startTime number Valore dell'indicatore di riproduzione all'inizio dell'interruzione dell'annuncio.

    Creazione oggetto di interruzione annuncio:

    var adBreakObject =
      ADB.Media.createAdBreakObject(<ADBREAK_NAME>,
                                       <POSITION>,
                                       <START_TIME>);
    
  2. Chiama trackEvent() con AdBreakStart nell’ MediaHeartbeat istanza per iniziare a monitorare l’interruzione dell’annuncio:

    tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
    
  3. Identificare quando inizia l'annuncio e creare un' AdObject istanza utilizzando le informazioni sull'annuncio.

    AdObject riferimento:

    Nome della variabile Tipo Descrizione
    name string Stringa non vuota che denota il nome dell'annuncio.
    adId string Stringa non vuota che denota un identificatore di annuncio.
    position number La posizione del numero dell'annuncio all'interno dell'interruzione iniziale, iniziando da 1.
    length number Numero positivo che indica la lunghezza dell’annuncio.

    Creazione di oggetti annuncio:

    var adObject =
      ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                    <AD_ID>,
                                    <POSITION>,
                                    <LENGTH>);
    
  4. Se necessario, allegate metadati standard e/o di annunci alla sessione di tracciamento dei supporti tramite le variabili dei dati contestuali.

    • Implementazione dei metadati standard di annunci in JavaScript

    • Metadati annunci personalizzati - Per i metadati personalizzati, create un oggetto variabile per le variabili dati personalizzate e compilate con i dati per l'annuncio corrente:

      /* Set context data */
      // Standard metadata keys provided by adobe.
      adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
      adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign";
      
      // Custom metadata keys
      adMetadata["affiliate"] = "Sample affiliate";
      adMetadata["campaign"] = "Sample ad campaign";
      adMetadata["creative"] = "Sample creative";
      
  5. Chiamate trackEvent() con l’ AdStart evento nell’ MediaHeartbeat istanza per iniziare a monitorare la riproduzione dell’annuncio.

    Includete un riferimento alla variabile di metadati personalizzata (o a un oggetto vuoto) come terzo parametro nella chiamata dell’evento:

    _onAdStart = function() {
        tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata);
    };
    
  6. Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, invoca trackEvent() con l’ AdComplete evento:

    _onAdComplete = function() {
        tracker.trackEvent(ADB.Media.Event.AdComplete);
    };
    
  7. Se la riproduzione dell'annuncio non è stata completata perché l'utente ha scelto di saltare l'annuncio, tieni traccia dell' AdSkip evento:

    _onAdSkip = function() {
        tracker.trackEvent(ADB.Media.Event.AdSkip);
    };
    
  8. Se ci sono altri annunci all'interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.

  9. Al termine dell'interruzione dell'annuncio, utilizzate l' AdBreakComplete evento per tenere traccia:

    _onAdBreakComplete = function() {
        tracker.trackEvent(ADB.Media.Event.AdBreakComplete);
    };
    

Per ulteriori informazioni, consulta lo scenario di tracciamento della riproduzione VOD con annunci pre-roll.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now