chevron_right
chevron_right
Integrazione JavaScript (Autonoma)
How-To/Instructional

Integrazione JavaScript (Autonoma)

Last Updated over a month ago
Article Navigation
Introduzione
Istruzioni
Risoluzione dei problemi
Informazioni di contatto per ulteriore assistenza

Introduzione

Collegarsi a Ezoic tramite JavaScript (a volte chiamato integrazione "standalone") è rapido e semplice, offrendo agli editori completo controllo e personalizzazione. Questo metodo d'integrazione è compatibile con tutte le costruzioni di siti e comporta l'inserimento di un piccolo pezzo di codice JavaScript nell'HTML del tuo sito web, il quale consente a Ezoic di gestire e ottimizzare il posizionamento degli annunci sul tuo sito. In questo articolo, forniremo una guida passo-passo su come integrare Ezoic utilizzando il metodo JavaScript.

Istruzioni

```html
  1. Assicurati di avere creato un account Ezoic. Se non lo hai ancora fatto, puoi farlo qui.
  2. Collegati con il tuo Specialista di Onboarding Ezoic se hai bisogno di aiuto per configurare ads.txt o accettare l'invito Google MCM.


Configurazione degli Annunci

Collegare il tuo sito a Ezoic è un processo semplice che comporta l'aggiunta di alcune righe di codice al tuo sito. Mentre aspetti l'approvazione di Google Ad Manager, ti consigliamo di configurare un ambiente di staging o sviluppo per garantire che le posizioni degli annunci siano impostate correttamente e il caricamento degli annunci sia confermato.

Questa guida ti guiderà attraverso i passaggi per implementare EzoicAds sul tuo sito.

Per implementare EzoicAds, dovrai creare posizionamenti degli annunci sul tuo sito. Questi posizionamenti degli annunci verranno utilizzati per definire le posizioni degli annunci sul tuo sito dove verranno visualizzati gli annunci Ezoic.

Puoi creare posizionamenti degli annunci nel tuo Dashboard Ezoic, oppure puoi lavorare con il tuo Specialista di Onboarding Ezoic per creare i posizionamenti degli annunci ideali per il tuo sito.

Aggiungi lo Script di Privacy Ezoic (presuppone che tu stia utilizzando il Modale di Consenso di Ezoic. Se usi un modale di terze parti, segui i passaggi indicati qui) e lo Script nell'Header nella parte superiore del tag <head> (per una configurazione e una consegna degli annunci più rapide, consigliamo di inserire questi script nell'header all'interno del tag <head>. Se non è possibile inserirli nell'head, l'alternativa migliore è posizionarli nella parte superiore del tag <body>). Assicurati di caricare lo script di privacy prima dello script dell'header.

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script async src="//www.ezojs.com/ezoic/sa.min.js"></script>
<script>
  window.ezstandalone = window.ezstandalone || {};
  ezstandalone.cmd = ezstandalone.cmd || [];
</script>

Questo codice verrà chiamato per ogni posizione degli annunci. È importante notare che l'ID a 3 cifre 101 rappresenta una specifica posizione dell'annuncio, e ogni posizione avrà un ID a 3 cifre diverso. I codici degli annunci verranno generati nel tuo Dashboard EzoicAds.

Ogni posizione dell'annuncio avrà la seguente struttura:

<div id="ezoic-pub-ad-placeholder-101"></div>
<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.showAds(101)
    });
</script>

Inserisci questo codice per ogni posizione dell'annuncio sul tuo sito.

NON aggiungere alcun stile al vero placeholder div. Aggiungere stili o riservare spazio per l'annuncio può portare a risultati indesiderati (ad esempio, se un placeholder non viene scelto dal nostro sistema, potrebbe esserci spazio vuoto sulla pagina).

Chiamare ezstandalone.showAds() senza definire un valore di placeholder chiamerà la funzione per ogni placeholder esistente su quella pagina.


Contenuto Dinamico

Se il contenuto del tuo sito web viene caricato o cambia dinamicamente, potrebbe essere necessaria una configurazione aggiuntiva. Guarda qui per ulteriori istruzioni: https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic

L'integrazione ibrida avviene quando un sito si integra tramite server di nomi o Cloudflare, mentre utilizza il frammento di codice lato client per richiamare gli annunci. Il vantaggio dell'integrazione ibrida è che consente ad altri prodotti di Ezoic (ad esempio, Velocità del SitoSEO) di caricare gli annunci dinamicamente. Guarda qui per ulteriori istruzioni: https://support.ezoic.com/kb/article/hybrid-integration


Video Humix

Il Generatore di Codice Embed dal tuo Dashboard Humix può essere utilizzato per aggiungere il nostro Lettore Video al tuo sito web.


Avanzato

EzoicAds fornisce funzionalità avanzate che consentono agli editori di perfezionare il comportamento della libreria degli annunci. Queste funzionalità possono essere utilizzate per personalizzare il comportamento della libreria degli annunci per meglio adattarsi alle esigenze del tuo sito. Guarda qui per ulteriori istruzioni: https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features

```

Risoluzione dei problemi

Quando configuri EzoicAds sul tuo sito, è importante garantire che tutto funzioni correttamente. Forniamo un Debugger di Integrazione JavaScript integrato che ti consente di diagnosticare rapidamente i problemi con la configurazione degli annunci. Di seguito è riportata una guida passo dopo passo su come utilizzare questo debugger e interpretarne i risultati.

Per attivare il debugger, aggiungi semplicemente il seguente parametro di query all'URL della pagina in cui sono integrati i tuoi EzoicAds:

ez_js_debugger=1

Per esempio:

https://www.tuosito.com?ez_js_debugger=1

Una volta aggiunto il parametro di query e caricata la pagina, apparirà una finestra di dialogo verde nella parte inferiore centrale dello schermo. Questo è il Debugger di Integrazione JavaScript.

La finestra modale del debugger contiene diverse informazioni chiave che ti aiuteranno a risolvere i problemi di configurazione. Ecco una panoramica delle informazioni fornite:

  • Rilevamento Script: Il debugger controllerà se lo script di Ezoic è correttamente incluso nella tua pagina. Se lo script non viene trovato, verrà visualizzato un messaggio di errore. Assicurati che il tag dello script di Ezoic sia posizionato nel posto giusto sulla tua pagina.

  • Rilevamento Placeholder: Verrà visualizzato il numero di placeholder definiti sulla tua pagina. Questo aiuta a verificare se i placeholder sono stati riconosciuti con successo dal sistema Ezoic.

  • Stato Annuncio: Per ogni placeholder, il debugger indicherà se un annuncio è stato visualizzato correttamente. Mostra:

    • Se un annuncio è assegnato a un placeholder specifico.
    • Se è stata inviata una richiesta a Ezoic per recuperare un annuncio per quel placeholder.
  • Successo della Richiesta: Il debugger monitora anche se la richiesta di annuncio è stata inviata con successo. Se c'è un problema, la finestra modale mostrerà i dettagli dell'errore per aiutare a identificare la causa principale (ad es., problemi di rete, configurazione errata).

Le informazioni fornite nella finestra modale del debugger sono inestimabili per diagnosticare problemi comuni come:

  • Annunci Non Visualizzati: Controllare il rilevamento dei placeholder e lo stato dell'annuncio per assicurarsi che i placeholder siano definiti e che gli annunci siano assegnati.

  • Richieste di Annuncio Fallite: Se le richieste di annuncio non vengono inviate o falliscono, il debugger fornirà messaggi di errore che indicano possibili errori di configurazione.

  • Problemi di Caricamento dello Script: Se lo script non viene caricato correttamente, verifica che il tag dello script sia presente nel tuo codice sorgente e configurato correttamente.

Informazioni di contatto per ulteriore assistenza

Se hai bisogno di ulteriore assistenza con l'integrazione JavaScript (Standalone), accedi tramite https://support.ezoic.com/ per utilizzare le nostre risorse dedicate al supporto. Siamo qui per aiutarti!

× Enlarged Image

Loading ...