Guide de conception du composant Expanding

Ajouter le composant Enabler

Qu'est-ce que le composant Enabler de DoubleClick ?

Cet article s'applique aux créations Flash. Pour savoir comment ajouter le composant Enabler à des créations HTML5, consultez l'article Ajouter le composant Enabler HTML5.

Le composant Enabler constitue la bibliothèque de code centrale de DoubleClick Studio. On peut le comparer au cerveau d'une création. Tous les composants Rich Media et les appels d'API doivent passer par le composant Enabler.

Enabler symbol of 2 intersecting dark green and light green circles with a right-pointing arrow to the right of the symbol

Suivi

Fonctionnalités

Complexité

Pourquoi dois-je ajouter le composant Enabler de DoubleClick ?

Le composant Enabler est obligatoire pour toutes les créations Rich Media. Grâce au composant Enabler, votre création :

  • intègre les fonctionnalités de suivi de statistiques de base (durée d'affichage, nombre d'impressions et durée d'interaction, par exemple) ainsi que d'autres statistiques standards ;
  • est compatible avec des fonctionnalités plus complexes, telles que les vidéos et les fonctions expand.

Pour les créations diffusées sur des pages HTML, le composant Enabler est référencé dans ActionScript sous le nom HtmlEnabler (nom de la classe Enabler). L'icône du composant Enabler constitue une représentation graphique de la classe HTMLEnabler au sein d'une création.

Comment puis-je configurer le composant Enabler ?

La classe HtmlEnabler permet de diffuser des créations au sein d'un environnement HTML dans AS2 et AS3.

  • Dans AS2, pour inclure la classe Enabler dans un fichier, il convient d'ajouter une instance du composant Enabler dans l'espace de création du fichier parent. Il est inutile d'ajouter le composant dans le fichier enfant.
  • Dans AS3, vous devez ajouter la classe Enabler aux fichiers via ActionScript. Par ailleurs, votre bibliothèque Flash doit également inclure une instance du composant Enabler.
Ajouter le composant Enabler dans AS2

Vous devez ajouter le composant Enabler dans le fichier parent de la création, et non dans les fichiers enfants. Sinon, vous obtiendrez l'erreur suivante lors de l'importation des éléments dans l'interface utilisateur Web de Studio : "La création ne peut pas comporter plus de 1 éléments Flash principaux".

Sélectionnez l'une des options suivantes pour ajouter le composant Enabler :

  • Option 1 : accédez au menu Flash Commandes > DoubleClick Studio v2 > et sélectionnez Insérer le composant Enabler pour DoubleClick Studio v2. Le composant Enabler est alors automatiquement ajouté à votre bibliothèque.
     
  • Option 2 : faites glisser l'icône du composant Enabler  vers la première image de la timeline root du fichier parent, juste à côté de l'espace de création.

Une fois le composant Enabler ajouté à la création, vous avez toujours la possibilité d'accéder à la classe HtmlEnabler dans ActionScript via la référence globale Enabler.

Ajouter le composant Enabler dans AS3

Dans AS3, vous devez inclure le composant Enabler dans les fichiers via ActionScript et en ajouter une instance dans votre bibliothèque Flash. Pour ajouter le composant Enabler dans vos fichiers, il convient d'inclure la classe HtmlEnabler dans le fichier parent et la classe ProxyEnabler dans chaque fichier enfant.

La classe ProxyEnabler est obligatoire dans tous les fichiers enfants qui effectuent des appels vers l'API du composant Enabler. Cette classe sert de proxy pour toutes les API du véritable composant Enabler parent. Contrairement au composant Enabler parent, le composant Enabler enfant ne nécessite pas d'initialisation, ce qui permet de réduire la taille du fichier de création. Il vous suffit de l'importer avant tout appel vers l'API du composant Enabler. En pratique, la classe ProxyEnabler semble envoyer les mêmes événements que le composant Enabler parent.

Sélectionnez l'une des options suivantes pour ajouter le composant Enabler :

  • Option 1 : pour inclure le composant Enabler dans chaque fichier FLA de votre création, accédez au menu Flash Commandes > DoubleClick Studio v2, puis sélectionnez Insérer le composant Enabler pour DoubleClick Studio v2.
    1. Pour un fichier parent, cliquez sur OK lorsque le système vous demande s'il s'agit du fichier animé parent.
    2. Pour un fichier enfant, cliquez sur Annuler.
    La classe HtmlEnabler est automatiquement importée dans la création parent, tandis que la classe ProxyEnabler est directement incluse dans les créations enfants. Notez également que le composant Enabler est ajouté à votre bibliothèque Flash.

  • Option 2 : faites glisser l'icône du composant Enabler  vers la bibliothèque de vos fichiers parents et enfants, puis ajoutez le code suivant dans le fichier parent :

    import com.google.ads.studio.HtmlEnabler;

    // Faire référence au composant HtmlEnabler;
    var enabler:HtmlEnabler = HtmlEnabler.getInstance();

    // Initialiser le composant HtmlEnabler. Le mot clé "this" fait référence à l'espace de création.
    enabler.init(this);

Ajoutez le code suivant dans le fichier enfant :

import com.google.ads.studio.ProxyEnabler;

// Faire référence au composant ProxyEnabler
var enabler:ProxyEnabler = ProxyEnabler.getInstance();

Quelle que soit l'option retenue pour configurer le composant Enabler, vous avez toujours la possibilité d'accéder à la classe HtmlEnabler via la variable enabler.

Essayez dès maintenant !

Ajoutez la classe HtmlEnabler dans le fichier parent et la classe ProxyEnabler dans le ou les fichiers enfants.