Show Menu
TOPICS×

Suivi des publicités à l’aide de JavaScript 3.x

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 3.x. If you are implementing any previous versions of the SDK, you can download the Developers Guides here: Download SDKs.

Constantes de suivi des publicités

Nom de constante
Description  
AdBreakStart
Constante permettant d’effectuer le suivi de l’événement AdBreak Start
AdBreakComplete
Constante permettant d’effectuer le suivi de l’événement AdBreak Complete
AdStart
Constante permettant d’effectuer le suivi de l’événement Début de la publicité
AdComplete
Constante permettant d’effectuer le suivi de l’événement Fin de la publicité
AdSkip
Constante permettant d’effectuer le suivi de l’événement Saut de publicité

Procédure de mise en œuvre

  1. Identifiez le moment où la limite de coupure publicitaire commence, y compris preroll, et créez un
    AdBreakObject
    à l’aide des informations de coupure publicitaire.
    Référence 
    AdBreakObject
     :
    Nom de variable
    Type
    Description
    name
    string
    Chaîne non vide indiquant le nom de l’abréviation (preroll, mid-roll et post-roll).
    position
    nombre
    Position du nombre au début de la coupure publicitaire commençant par 1.
    startTime
    nombre
    Valeur du curseur de lecture au début de la coupure publicitaire.
    Création d’objet de coupure publicitaire :
    var adBreakObject = ADB.Media.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
  2. Appelez
    trackEvent()
    avec
    AdBreakStart
    dans l’instance
    MediaHeartbeat
    pour commencer le suivi de la coupure publicitaire :
    tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
  3. Déterminez le moment où la publicité commence, puis créez une instance
    AdObject
    à l’aide des informations sur la publicité.
    Référence 
    AdObject
     :
    Nom de variable
    Type
    Description
    name
    string
    Chaîne non vide indiquant le nom de la publicité.
    adId
    string
    Chaîne non vide indiquant l'identifiant de publicité.
    position
    nombre
    Position du numéro de la publicité dans l'adbreak, commençant par 1.
    length
    nombre
    Numéro positif indiquant la longueur de la publicité.
    Création d’objet publicitaire :
    var adObject = ADB.Media.createAdObject.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
  4. Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi multimédia par le biais de variables de données contextuelles.
    • Métadonnées de publicité personnalisées -
      Pour les métadonnées personnalisées, créez un objet de variable pour les variables de données personnalisées et renseignez les données de la publicité actuelle :
      /* 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. Appelez
    trackEvent()
    avec l’événement
    AdStart
    dans l’instance
    MediaHeartbeat
    pour commencer le suivi de la lecture de publicité.
    Incluez une référence à votre variable de métadonnées personnalisées (ou un objet vide) comme troisième paramètre dans l’appel d’événement :
    _onAdStart = function() { tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata); };
  6. Lorsque la lecture de la publicité atteint la fin de la publicité, appelez
    trackEvent()
    avec l’événement
    AdComplete
     :
    _onAdComplete = function() { tracker.trackEvent(ADB.Media.Event.AdComplete); };
  7. Si la lecture de la publicité ne s’est pas terminée car l’utilisateur a choisi d’ignorer la publicité, suivez l’événement
    AdSkip
     :
    _onAdSkip = function() { tracker.trackEvent(ADB.Media.Event.AdSkip); };
  8. S’il existe d’autres publicités dans le même
    AdBreak
    , répétez les étapes 3 à 7.
  9. Lorsque la coupure publicitaire est terminée, utilisez l’événement
    AdBreakComplete
    pour en effectuer le suivi :
    _onAdBreakComplete = function() { tracker.trackEvent(ADB.Media.Event.AdBreakComplete); };
Consultez le scénario de suivi Lecture VOD avec publicités preroll pour en savoir plus.