Collegarsi a Ezoic tramite JavaScript (a volte chiamata integrazione "standalone") è rapido e semplice, fornendo agli editori il controllo e la personalizzazione completi. Funzionalità avanzate ti permettono di ottimizzare la tua configurazione. Queste funzionalità possono essere utilizzate per personalizzare il comportamento della libreria di annunci in modo da soddisfare meglio le esigenze del tuo sito.

Annunci di Ancoraggio

Per impostazione predefinita, Ezoic mostrerà annunci di ancoraggio se abilitati nel cruscotto sotto la scheda EzoicAds.

Disattivazione Annunci di Ancoraggio

Per disattivare l'annuncio di Ancoraggio per una pagina specifica, è possibile utilizzare la funzione ezstandalone.setEzoicAnchorAd.

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

Controllare se l'Annuncio di Ancoraggio è Stato Chiuso

Per verificare se l'annuncio di Ancoraggio è stato chiuso per una sessione dell'utente, usa la funzione hasAnchorAdBeenClosed.

Sotto è riportato un esempio di utilizzo della funzione per determinare se continuare o meno a mostrare l'annuncio di Ancoraggio

<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({
        // Le opzioni di configurazione vanno qui
    });
});

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

Posizione Annuncio di Ancoraggio

Permette di cambiare la posizione dell'annuncio di ancoraggio per essere in cima o in fondo alla pagina. I valori accettabili sono 'top' o 'bottom'. L'annuncio di ancoraggio sarà posizionato in fondo alla pagina per impostazione predefinita.

Ad esempio, per impostare la posizione dell'annuncio di ancoraggio in cima alla pagina:

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

Altre opzioni verranno aggiunte in futuro. Si prega di tornare a controllare gli aggiornamenti.

Tracciamento Dati

Se desideri tracciare i dati anche su pagine che non mostrano annunci, puoi includere lo script sotto. Questo è particolarmente utile nelle fasi iniziali di test quando non sei ancora pronto per mostrare annunci.

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

Nuove Funzionalità (Beta)

Queste sono nuove funzionalità disponibili per essere implementate ma sono ancora in Beta e potrebbero cambiare prima del rilascio completo.

Uso Avanzato di ShowAds

L'implementazione avanzata fornisce funzionalità aggiuntive accettando un array di oggetti. Ogni oggetto può includere i seguenti attributi:

• id (necessario): L'identificatore univoco del placeholder dove l'annuncio dovrebbe essere mostrato.
• required (opzionale, booleano): Un flag che indica se l'annuncio deve essere visualizzato. Se impostato su `true`, il sistema forzerà la visualizzazione di un annuncio nel placeholder specificato, anche se normalmente non verrebbe visualizzato.
• sizes (opzionale, stringa o array di stringhe): Specifica le dimensioni consentite per l'annuncio nel formato `{larghezza}x{altezza}`. Puoi fornire una dimensione singola come stringa o più dimensioni come array di stringhe. Ciò ti permette di controllare le dimensioni dell'annuncio che verrà visualizzato.

Esempio di Implementazione

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

ezstandalone.showAds(placeholders);
</script>

In questo esempio:

1. Placeholder 103:

   • Un annuncio verrà sempre mostrato nel placeholder `103`.
   • Le dimensioni consentite per l'annuncio sono `336x280` e `126x126`.

2. Placeholder 104:

   • Un annuncio verrà mostrato nel placeholder `104` se Ezoic decide che questo annuncio debba essere mostrato.
   • La dimensione consentita per l'annuncio è `1000x450`.

3. Placeholder 105:

   • Un annuncio verrà sempre mostrato nel placeholder `105`.
   • Non vengono fornite dimensioni specifiche, quindi Ezoic deciderà la migliore dimensione per questo placeholder.

Note

• Specificità delle Dimensioni degli Annunci: Le dimensioni degli annunci specificate nell'attributo `sizes` sono trattate come richieste specifiche. Ezoic cercherà di trovare il miglior annuncio possibile che si adatti alla dimensione data. Se non è disponibile una corrispondenza esatta, il sistema sceglierà la dimensione disponibile che può adattarsi meglio alle dimensioni specificate.
• Se l'attributo `required` è impostato su `true`, Ezoic darà priorità alla visualizzazione dell'annuncio in quel placeholder, assicurandosi che venga mostrato anche se altre condizioni potrebbero normalmente impedirlo.
• Se vengono specificate le dimensioni (`sizes`), l'annuncio verrà mostrato solo se è disponibile un annuncio delle dimensioni specificate. Se l'attributo `sizes` è omesso o lasciato vuoto, Ezoic utilizzerà il suo comportamento predefinito per determinare la dimensione dell'annuncio.

Casi d'Uso

• Posizionamento Garantito degli Annunci: Usa l'attributo `required` per garantire che gli annunci vengano mostrati nei placeholder critici, indipendentemente da altre condizioni.
• Annunci di Dimensioni Specifiche: Usa l'attributo `sizes` per controllare le dimensioni degli annunci visualizzati. Questo è particolarmente utile per design reattivi o esigenze di layout specifiche in cui determinate dimensioni sono più efficaci.

Questo metodo avanzato offre flessibilità e controllo sul posizionamento degli annunci, rendendolo adatto per scenari in cui è necessario più del solo ID del placeholder per dettare il comportamento dell'annuncio.

RefreshAds

refreshAds è una nuova funzione in ezstandalone che permette di aggiornare l'annuncio per specifici placeholder. Questo può essere usato se vuoi specificamente aggiornare un annuncio per un visualizzatore in un momento specifico. Sotto è riportato un esempio di utilizzo della funzione.

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

Se hai bisogno di ulteriore assistenza con le funzionalità avanzate dell'integrazione JavaScript, accedi a https://support.ezoic.com/ per utilizzare le nostre risorse dedicate al supporto. Siamo qui per aiutarti!