Se sei preoccupato di utilizzare Ezoic con siti più complessi che hanno un mix di contenuti statici e dinamici, non preoccuparti! Questo articolo fornirà indicazioni su come integrare efficacemente con Ezoic tramite l'Integrazione Ibrida, consentendo al tuo sito di beneficiare di tutte le potenti funzionalità di Ezoic.
L'integrazione ibrida tiene conto di siti più complessi che hanno un mix di contenuti statici e dinamici, consentendo loro di utilizzare tutte le funzionalità di Ezoic (ad es. Velocità del sito, SEO), utilizzando lo snippet di codice lato client per richiamare gli annunci.
Tutte le strutture dei siti possono beneficiare di questo metodo di integrazione, tuttavia i siti che non utilizzano contenuti dinamici e/o non desiderano apportare modifiche al loro DNS hanno l'opzione di utilizzare l'integrazione JavaScript (Standalone) https://support.ezoic.com/kb/article/javascript-standalone-integration invece. I siti che utilizzano contenuti dinamici e non desiderano apportare modifiche al loro DNS possono anche integrarsi con Ezoic tramite questo metodo, tuttavia potrebbe essere necessaria una configurazione aggiuntiva. Vedi https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic per ulteriori istruzioni.
Assicurati che i segnaposto siano creati tramite la dashboard. Vedi questo articolo per saperne di più sui segnaposto e su come crearli.
Carica la libreria di codice aggiungendo questo script all' <head> della pagina. Alcune funzionalità di Ezoic richiedono che l'HTML esista staticamente piuttosto che venga caricato tramite JavaScript.
<script async src="https://www.ezojs.com/ezoic/sa.min.js"></script>
Per aggiungere un segnaposto alla pagina, crea un elemento div nel punto in cui dovrebbe essere l'annuncio. L'attributo id dell'elemento dovrebbe essere l'ID del segnaposto con il prefisso ezoic-pub-ad-placeholder-.
Ad esempio, per aggiungere segnaposto con gli id 103 e 104, l'HTML sarebbe simile a questo:
<body>
<div id="ezoic-pub-ad-placeholder-103">
</div>
<!-- Contenuto -->
<div id="ezoic-pub-ad-placeholder-104">
</div>
</body>
Una volta che i segnaposto sono stati aggiunti all'HTML, richiedi il codice annuncio di Ezoic utilizzando ezstandalone.displayMore().
<script type="text/javascript">
window.ezstandalone = window.ezstandalone || {};
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
ezstandalone.showAds(103, 104);
});
</script>
Per i siti integrati senza segnaposto statici che desiderano caricare tutti i segnaposto dinamicamente utilizzando la nostra configurazione degli annunci lato client, si prega di utilizzare invece la seguente guida: Primi Passi con EzoicAds.
Segnaposto statici sono segnaposto che vengono aggiunti all'html quando si passa attraverso il nostro proxy, piuttosto che essere aggiunti tramite JavaScript.Simile alla divisione del traffico su un sito utilizzando l'opzione dello snippet di codice lato client, puoi aggiungere la stessa funzione senza passare alcun parametro:
<script type="text/javascript">
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
if(ezstandalone.isEzoicUser()) {
ezstandalone.showAds(100,101);
} else {
// Esecuzione del normale codice annuncioEzoicAds fornisce funzionalità avanzate che consentono agli editori di regolare finemente 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://docs.ezoic.com/docs/ezoicads/advanced/
Quando configuri EzoicAds sul tuo sito, è importante assicurarsi che tutto funzioni correttamente. Offriamo un Debugger di Integrazione JavaScript integrato che ti permette di diagnosticare rapidamente i problemi con la tua configurazione degli annunci. Di seguito una guida passo-passo su come usare questo debugger e interpretare i suoi output.
Per attivare il debugger, aggiungi semplicemente il seguente parametro di query all'URL della pagina dove sono integrati i tuoi EzoicAds:
ez_js_debugger=1Per esempio:
https://www.tuosito.com?ez_js_debugger=1Una volta aggiunto il parametro di query e caricata la pagina, apparirà una finestra modale verde al centro in basso dello schermo. Questo è il Debugger di Integrazione JavaScript.
La finestra modale del debugger contiene diversi elementi chiave di informazione che ti aiuteranno a risolvere i problemi della tua 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, vedrai un messaggio di errore. Assicurati che il tag dello script 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 ciascun segnaposto, il debugger indicherà se un annuncio è stato visualizzato con successo. Mostra:
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 esempio, 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 gli annunci assegnati.
Richieste di Annunci Fallite: Se le richieste di annunci 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 dello script sia presente nel tuo codice sorgente e correttamente configurato.
Se hai bisogno di ulteriore assistenza con l'integrazione ibrida, accedi tramite https://support.ezoic.com/ per utilizzare le nostre risorse dedicate al supporto. Siamo qui per aiutarti!