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.
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é |
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>);
Appelez trackEvent()
avec AdBreakStart
dans l’instance MediaHeartbeat
pour commencer le suivi de la coupure publicitaire :
tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
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>);
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.
Mise en œuvre de métadonnées de publicité standard sur JavaScript
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";
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);
};
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);
};
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);
};
S’il existe d’autres publicités dans le même AdBreak
, répétez les étapes 3 à 7.
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.