chevron_right
chevron_right
Einführung
How-To/Instructional

Einführung

Last Updated today
Article Navigation
Introduction
Instrucciones
Risoluzione dei problemi
JavaScript (Standalone) Integration für Nicht-WordPress-Seiten

Introduction

Collegarsi a Ezoic tramite JavaScript (a volte chiamata integrazione "standalone") è rapido e semplice, fornendo agli editori il completo controllo e personalizzazione. Questo metodo di integrazione è compatibile con tutte le configurazioni del sito e prevede l'inserimento di un piccolo pezzo di codice JavaScript nell'HTML del tuo sito web, che consente a Ezoic di gestire e ottimizzare le posizioni pubblicitarie sul tuo sito. In questo articolo, forniremo una guida passo passo su come integrare Ezoic utilizzando il metodo JavaScript.

Instrucciones

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


Configurazione degli annunci

Collegare il tuo sito a Ezoic è un processo semplice che comporta l'aggiunta di poche righe di codice al tuo sito. Mentre aspetti l'approvazione di Google Ad Manager, ti consigliamo di configurare in un ambiente di staging o di sviluppo per garantire che le tue posizioni pubblicitarie 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 posizioni pubblicitarie sul tuo sito. Queste posizioni pubblicitarie saranno utilizzate per definire le posizioni degli annunci sul tuo sito dove verranno mostrati gli annunci Ezoic.

Puoi creare posizioni pubblicitarie nel tuo Pannello di Controllo Ezoic, oppure puoi collaborare con il tuo Specialista dell'Onboarding Ezoic per creare le migliori posizioni pubblicitarie per il tuo sito.

Aggiungi lo Script Privacy Ezoic (presume che tu stia usando il Modulo di Consenso di Ezoic. Se si utilizza un modulo di terze parti, vedere https://support.ezoic.com/kb/article/javascript-standalone-integration) e lo Script Intestazione nella parte superiore del tag <head> (per una configurazione e consegna degli annunci più rapida, si consiglia di inserire questi script intestazione all'interno del tag <head>. Se inserirli nell'intestazione non è fattibile, la prossima opzione migliore è posizionarli nella parte superiore del tag <body>). Si prega di assicurarsi di caricare lo script di privacy prima dello script intestazione.

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script src="https://cmp.gatekeeperconsent.com/min.js" data-cfasync="false"></script>

Il CMP Ezoic può essere personalizzato visitando la sezione privacy all'interno del Pannello di Controllo Ezoic.

Ezoic rileverà automaticamente il consenso da parte dei CMP di terze parti conformi alla TCF 2.2: https://iabeurope.eu/cmp-list/.

<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 ciascuna posizione pubblicitaria. È importante notare che l'ID a 3 cifre 101 rappresenta una posizione pubblicitaria specifica e ogni posizione pubblicitaria avrà un ID diverso a 3 cifre. I codici degli annunci verranno generati nel tuo Pannello di Controllo EzoicAds.

Ogni posizione pubblicitaria 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 ciascuna posizione pubblicitaria sul tuo sito.

NON aggiungere alcun stile al placeholder effettivo div. L'aggiunta di stili o la riserva di spazio per l'annuncio può portare a risultati indesiderati (es. se un placeholder non viene scelto dal nostro sistema, potrebbe esserci dello spazio vuoto sulla pagina).

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


Contenuto Dinamico

Se il contenuto del tuo sito web 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 avviene quando un sito si integra tramite server dei nomi o Cloudflare, utilizzando il frammento di codice client-side per richiedere annunci. Il vantaggio dell'integrazione ibrida è che consente agli altri prodotti Ezoic (es. Velocità del Sito, SEO) di caricare 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 Pannello di Controllo Humix può essere utilizzato per aggiungere il nostro Video Player al tuo sito web.


Avanzato

EzoicAds fornisce funzionalità avanzate che consentono ai publisher di perfezionare il comportamento della libreria di annunci. Queste funzionalità possono essere utilizzate per personalizzare il comportamento della libreria di 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-for-non-wordpress-sites

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 tua configurazione degli annunci. Di seguito è riportata una guida passo passo su come utilizzare questo debugger e interpretarne i risultati.

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

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 di dialogo modale verde al centro in basso dello schermo. Questo è il Debugger di Integrazione JavaScript.

Il modale del debugger contiene diverse informazioni chiave che ti aiuteranno a risolvere i problemi con la tua configurazione. Ecco una panoramica delle informazioni fornite:

  • Rilevamento Script: Il debugger controllerà se lo script 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 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 Annunci: Per ogni placeholder, il debugger indicherà se un annuncio è stato visualizzato con successo. Mostra:

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

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

  • Annunci Non Visualizzati: Controlla il rilevamento dei placeholder e lo stato degli annunci per assicurarti che i placeholder siano definiti e gli annunci assegnati.

  • Richieste Annunci Fallite: Se le richieste di annunci non vengono inviate o falliscono, il debugger fornirà messaggi di errore che indicano potenziali configurazioni errate.

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

JavaScript (Standalone) Integration für Nicht-WordPress-Seiten

Se hai bisogno di ulteriore assistenza con l'integrazione JavaScript (Standalone), effettua l'accesso su https://support.ezoic.com/ per usufruire delle nostre risorse dedicate al supporto. Siamo qui per aiutarti!

× Enlarged Image

Loading ...