chevron_right
chevron_right
Come integrare con Ezoic usando JavaScript
How-To/Instructional

Come integrare con Ezoic usando JavaScript

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, fornendo agli editori il controllo e la personalizzazione completi. Questo metodo di integrazione è compatibile con tutte le strutture dei siti e comporta l'inserimento di un piccolo pezzo di codice JavaScript nel codice HTML del tuo sito web, che consente a Ezoic di gestire e ottimizzare le posizioni degli annunci sul tuo sito. In questo articolo, forniremo una guida passo-passo su come integrare Ezoic utilizzando il metodo JavaScript.

Istruzioni

  1. Assicurati di aver creato un account Ezoic. Se non lo hai ancora fatto, puoi farlo qui.
  2. Connettiti 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 coinvolge 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 di sviluppo per assicurarti che le posizioni degli annunci siano impostate correttamente e che il caricamento degli annunci sia confermato.

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

Per implementare EzoicAds, dovrai creare le posizioni degli annunci sul tuo sito. Queste posizioni degli annunci verranno utilizzate per definire le aree sul tuo sito dove verranno mostrati gli annunci Ezoic.

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

Aggiungi lo Script per la Privacy Ezoic (questo presuppone che tu stia utilizzando il Modulo di Consenso di Ezoic. Se usi un modulo di terze parti, segui i passaggi indicati qui) e lo Script nell'Header proprio all'inizio del tag <head> (per una configurazione e distribuzione degli annunci più rapida, ti consigliamo di inserire questi script all'interno del tag <head>. Se non è possibile inserirli nell'head, la seconda migliore opzione è posizionarli proprio all'inizio del tag <body>). Assicurati di caricare lo script per la privacy prima dello script nell'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 dell'annuncio. È importante notare che l'ID a 3 cifre 101 rappresenta una specifica posizione dell'annuncio, e ogni posizione avrà un diverso ID a 3 cifre. 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 alcuno stile al vero placeholder div. Aggiungere stili o riservare spazio per l'annuncio potrebbe portare a risultati indesiderati (ad esempio, se un placeholder non è scelto dal nostro sistema, potrebbe esserci uno spazio vuoto sulla pagina).

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


Contenuti Dinamici

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

L'Integrazione Ibrida è quando un sito si integra tramite name server o Cloudflare, utilizzando il frammento di codice lato client per richiamare gli annunci. Il vantaggio dell'integrazione ibrida è che consente agli altri prodotti di Ezoic (ad esempio, Site Speed, SEO) di caricare gli annunci dinamicamente. Vedi qui per ulteriori istruzioni: https://support.ezoic.com/kb/article/hybrid-integration


Video Humix

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


Avanzato

EzoicAds fornisce funzionalità avanzate che permettono ai publisher di ottimizzare il comportamento della libreria degli annunci. Queste funzionalità possono essere utilizzate per personalizzare il comportamento della libreria degli annunci per adattarsi meglio alle esigenze del tuo sito. Vedi 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 assicurarsi 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-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

Ad esempio:

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

Una volta aggiunto il parametro di query e caricata la pagina, apparirà una finestra modale verde al centro inferiore dello schermo. Questo è il Debugger di Integrazione JavaScript.

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

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

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

  • Stato Annuncio: per ogni segnaposto, il debugger indicherà se un annuncio è stato visualizzato con successo. Mostra:

    • Se un annuncio è assegnato a un segnaposto specifico.
    • Se è stata inviata una richiesta a Ezoic per recuperare un annuncio per quel segnaposto.
  • Successo della Richiesta: il debugger monitora anche se la richiesta dell'annuncio è stata inviata con successo. Se c'è un problema, la finestra modale mostrerà dettagli di 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: Controlla il rilevamento dei segnaposto e lo stato dell'annuncio per assicurarti che i segnaposto 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 potenziali configurazioni errate.

  • Problemi di Caricamento dello Script: Se lo script non viene caricato correttamente, verifica che il tag script sia presente nel 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 usufruire delle nostre risorse dedicate al supporto. Siamo qui per aiutarti!

× Enlarged Image

Loading ...