Se sei preoccupato di utilizzare Ezoic con siti più complessi che hanno un mix di contenuto statico e dinamico, non ti preoccupare! Questo articolo fornirà indicazioni su come integrare efficacemente Ezoic tramite l'Integrazione Ibrida, permettendo al tuo sito di beneficiare di tutte le potenti funzionalità di Ezoic.
L'integrazione ibrida tiene conto dei siti più complessi che hanno un mix di contenuti statici e dinamici, consentendo loro di utilizzare la cache di Ezoic mentre si utilizza il frammento di codice lato client per richiamare gli annunci.
Tutti i siti possono beneficiare di questo metodo di integrazione, tuttavia i siti che non utilizzano contenuti dinamici e/o non desiderano apportare modifiche al proprio DNS hanno l'opzione di utilizzare l'integrazione JavaScript (Standalone) invece. I siti che utilizzano contenuti dinamici e non desiderano apportare modifiche al proprio DNS possono anche integrarsi con Ezoic tramite questo metodo, tuttavia potrebbe essere necessaria una configurazione aggiuntiva. Consulta https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic per ulteriori istruzioni.
I siti devono essere prima integrati tramite l'integrazione cloud o Cloudflare per abilitare la cache di Ezoic.
Assicurati che i segnaposto siano creati tramite il dashboard. Consulta questo articolo per saperne di più sui segnaposto e su come crearli.
Carica la libreria di codice aggiungendo questo script nell'<head> della pagina. Alcune funzionalità di Ezoic richiedono che l'HTML esista staticamente piuttosto che essere 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 dove dovrebbe essere l'annuncio. L'attributo id dell'elemento deve 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 pubblicitario di Ezoic usando ezstandalone.displayMore().
<script type="text/javascript">
window.ezstandalone = window.ezstandalone || {};
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
ezstandalone.showAds(103, 104);
});
</script>
Per siti integrati senza segnaposto statici che desiderano caricare tutti i segnaposto dinamicamente utilizzando il nostro setup pubblicitario lato client, utilizza la seguente guida: Getting Started With EzoicAds.
Segnaposto statici sono segnaposto che vengono aggiunti all'html quando si passa attraverso il nostro proxy, anziché essere aggiunti tramite JavaScript.Simile alla suddivisione del traffico su un sito che utilizza l'opzione del frammento 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 normale del codice pubblicitarioEzoicAds offre funzionalità avanzate che consentono ai publisher di affinare il comportamento della libreria pubblicitaria. Queste funzionalità possono essere utilizzate per personalizzare il comportamento della libreria pubblicitaria per adattarsi meglio alle esigenze del tuo sito. Consulta qui per ulteriori istruzioni: https://docs.ezoic.com/docs/ezoicads/advanced/
Quando imposti EzoicAds sul tuo sito, è importante assicurarsi che tutto funzioni correttamente. Forniamo un Debugger di Integrazione JavaScript integrato che ti permette di diagnosticare rapidamente i problemi con la tua configurazione degli annunci. Di seguito è riportata una guida passo dopo passo su come utilizzare questo debugger e interpretare i suoi output.
Per attivare il debugger, aggiungi semplicemente il seguente parametro di query all'URL della pagina in cui i tuoi EzoicAds sono integrati:
ez_js_debugger=1Ad esempio:
https://www.yoursito.com?ez_js_debugger=1Una 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 problemi nella tua configurazione. Ecco una sintesi 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 script di Ezoic sia posizionato nel luogo giusto nella tua pagina.
Rilevamento Placeholder: Verrà mostrato il numero di placeholder definiti nella 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 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 (es. problemi di rete, configurazione errata).
Le informazioni fornite nella finestra modale del debugger sono inestimabili per diagnosticare problemi comuni quali:
Annunci Non Visualizzati: Verifica il rilevamento dei placeholder e lo stato dell'annuncio per assicurarti che i placeholder siano definiti e che gli annunci siano assegnati.
Richieste di Annunci Fallite: Se le richieste di annuncio non vengono inviate o falliscono, il debugger fornirà messaggi di errore che indicano possibili configurazioni errate.
Problemi di Caricamento dello Script: Se lo script non è caricato correttamente, verifica che il tag dello script sia presente nel tuo codice sorgente e configurato correttamente.
Se hai bisogno di ulteriore assistenza con l'integrazione ibrida, accedi tramite https://support.ezoic.com/ per usufruire delle nostre risorse dedicate al supporto. Siamo qui per aiutarti!