Se connecter à Ezoic via JavaScript (parfois appelé intégration "autonome") est rapide et simple, offrant aux éditeurs un contrôle et une personnalisation complets. Des fonctionnalités avancées vous permettent d'affiner votre configuration. Ces fonctionnalités peuvent être utilisées pour personnaliser le comportement de la bibliothèque de publicités afin de mieux répondre aux besoins de votre site.

Annonces Ancrées

Par défaut, Ezoic affichera des annonces ancrées si activé dans le tableau de bord sous l'onglet EzoicAds.

Désactiver les Annonces Ancrées

Pour désactiver l'annonce ancrée pour une page spécifique, la fonction ezstandalone.setEzoicAnchorAd peut être utilisée.

<script >
    window.ezstandalone = window.ezstandalone || {};
    ezstandalone.cmd = ezstandalone.cmd || [];
    ezstandalone.cmd.push(function() {
        ezstandalone.setEzoicAnchorAd(false);
        ezstandalone.showAds(101, 102, 103);
    });
</script>

Vérifier si l'Annonce Ancrée a été Fermée

Pour voir si l'annonce ancrée a été fermée pour la session d'un utilisateur, utilisez la fonction hasAnchorAdBeenClosed.

Voici un exemple d'utilisation de la fonction pour déterminer s'il faut continuer à afficher l'annonce ancrée

<script >
    window.ezstandalone = window.ezstandalone || {};
    ezstandalone.cmd = ezstandalone.cmd || [];
    ezstandalone.cmd.push(function() {
        let anchorHasBeenClosed = ezstandalone.hasAnchorAdBeenClosed();
        ezstandalone.setEzoicAnchorAd(anchorHasBeenClosed);
        ezstandalone.showAds(101, 102, 103);
    });
</script>

ezstandalone.cmd.push(function() {
    ezstandalone.config({
        // Les options de configuration vont ici
    });
});

ezstandalone.cmd.push(function() {
    ezstandalone.config({ limitCookies: true });
});

Position de l'Annonce Ancrée

Vous permet de modifier la position de l'annonce ancrée pour qu'elle soit en haut ou en bas de la page. Les valeurs acceptables sont 'top' ou 'bottom'. L'annonce ancrée sera située en bas de la page par défaut.

Par exemple, pour définir la position de l'annonce ancrée en haut de la page :

ezstandalone.cmd.push(function() {
    ezstandalone.config({ anchorAdPosition: "top" });
});

D'autres options seront ajoutées à l'avenir. Merci de revenir pour des mises à jour.

Suivi des Données

Si vous souhaitez suivre les données même sur les pages qui n'affichent pas d'annonces, vous pouvez inclure le script ci-dessous. C'est particulièrement utile lors des étapes initiales de test lorsque vous n'êtes pas encore prêt à afficher des annonces.

<script src="//ezoicanalytics.com/analytics.js"></script>

Nouvelles Fonctionnalités (Beta)

Ce sont de nouvelles fonctionnalités disponibles pour être implémentées mais qui sont encore en version bêta et peuvent changer avant d'être entièrement publiées.

Utilisation Avancée de ShowAds

L'implémentation avancée offre des fonctionnalités supplémentaires en acceptant un tableau d'objets. Chaque objet peut inclure les attributs suivants :

• id (obligatoire) : L'identifiant unique de l'emplacement où l'annonce doit être affichée.
• required (optionnel, booléen) : Un indicateur indiquant si l'annonce doit être affichée. Si défini sur `true`, le système forcera l'affichage d'une annonce dans l'emplacement spécifié, même si elle n'y serait pas normalement affichée.
• sizes (optionnel, chaîne ou tableau de chaînes) : Spécifie les tailles autorisées pour l'annonce au format `'{largeur}x{hauteur}'`. Vous pouvez fournir une taille unique sous forme de chaîne ou plusieurs tailles sous forme de tableau de chaînes. Cela vous permet de contrôler les dimensions de l'annonce qui sera affichée.

Implémentation Exemple

<script>
var placeholders = [
    { id: 103, required: true, sizes: ['336x280', '126x126'] },
    { id: 104, sizes: '1000x450' },  
    { id: 105, required: true },
];

ezstandalone.showAds(placeholders);
</script>

Dans cet exemple :

1. Emplacement 103:

   • Une annonce sera toujours affichée dans l'emplacement 103.
   • Les tailles autorisées pour l'annonce sont `336x280` et `126x126`.

2. Emplacement 104:

   • Une annonce sera affichée dans l'emplacement 104 si Ezoic estime que cette annonce doit être affichée.
   • La taille autorisée pour l'annonce est `1000x450`.

3. Emplacement 105:

   • Une annonce sera toujours affichée dans l'emplacement 105.
   • Aucune taille spécifique n'est fournie, donc Ezoic décidera de la meilleure taille pour cet emplacement.

Remarques

• Spécificité des tailles d'annonces : Les tailles d'annonces spécifiées dans l'attribut `sizes` sont traitées comme des demandes spécifiques. Ezoic tentera de trouver la meilleure annonce possible qui correspond à la taille donnée. Si une correspondance exacte n'est pas disponible, le système choisira la taille disponible la plus proche qui peut s'insérer au mieux dans les dimensions spécifiées.
• Si l'attribut `required` est défini sur `true`, Ezoic donnera la priorité à l'affichage de l'annonce dans cet emplacement, garantissant ainsi son affichage même si d'autres conditions pourraient normalement l'en empêcher.
• Si les `sizes` sont spécifiées, l'annonce ne sera affichée que si une annonce des tailles spécifiées est disponible. Si l'attribut `sizes` est omis ou laissé vide, Ezoic utilisera son comportement par défaut pour déterminer la taille de l'annonce.

Cas d'utilisation

• Placement Garanti des Annonces: Utilisez l'attribut `required` pour vous assurer que les annonces sont affichées dans des emplacements critiques, quelles que soient les autres conditions.
• Annonces à Taille Spécifique: Utilisez l'attribut `sizes` pour contrôler les dimensions des annonces affichées. Cela est particulièrement utile pour les conceptions réactives ou les exigences de mise en page spécifiques où certaines tailles sont plus efficaces.

Cette méthode avancée offre une flexibilité et un contrôle sur le placement des annonces, la rendant adaptée aux situations où plus que l'identifiant de l'emplacement est nécessaire pour dicter le comportement de l'annonce.

RefreshAds

refreshAds est une nouvelle fonction dans ezstandalone qui permet de rafraîchir l'annonce pour des emplacements spécifiques. Cela peut être utilisé si vous souhaitez spécifiquement rafraîchir une annonce à un moment précis pour un spectateur. Voici un exemple de la fonction utilisée.

<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.refreshAds(101, 102)
    });
</script>

Si vous avez besoin d'une aide supplémentaire pour l'utilisation des fonctionnalités avancées de l'intégration JavaScript, veuillez vous connecter via https://support.ezoic.com/ pour utiliser nos ressources dédiées à l'assistance. Nous sommes là pour vous aider !