Si te preocupa usar Ezoic con sitios más complejos que tienen una mezcla de contenido estático y dinámico, ¡no te preocupes! Este artículo te brindará orientación sobre cómo integrar efectivamente con Ezoic a través de la Integración Híbrida, permitiendo que tu sitio se beneficie de todas las potentes características de Ezoic.
La integración híbrida es adecuada para sitios más complejos que tienen una mezcla de contenido estático y dinámico, permitiéndoles usar la caché de Ezoic mientras utilizan el fragmento de código del lado del cliente para solicitar anuncios.
Todas las construcciones de sitios pueden beneficiarse de este método de integración, sin embargo, los sitios que no utilizan contenido dinámico y/o no desean realizar cambios en su DNS tienen la opción de usar la Integración con JavaScript (Independiente). Los sitios que sí utilizan contenido dinámico y no desean realizar cambios en su DNS también pueden integrarse con Ezoic a través de ese método, sin embargo, puede requerirse una configuración adicional. Consulte https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic para más instrucciones.
Los sitios deben integrarse primero a través de la nube o de Cloudflare para habilitar la caché de Ezoic.
Asegúrese de que los marcadores de posición se creen a través del panel de control. Vea este artículo para aprender más sobre marcadores de posición y cómo crearlos.
Cargue la biblioteca de código agregando este script en el <head> de la página. Algunas características de Ezoic requieren que el HTML exista estáticamente en lugar de cargarse a través de JavaScript.
<script async src="https://www.ezojs.com/ezoic/sa.min.js"></script>
Para agregar un marcador de posición a la página, cree un elemento div donde debería estar el anuncio. El atributo id del elemento debe ser la ID del marcador de posición con el prefijo ezoic-pub-ad-placeholder-.
Por ejemplo, para agregar marcadores de posición con las id 103 y 104, el HTML se vería similar a esto:
<body>
<div id="ezoic-pub-ad-placeholder-103">
</div>
<!-- Contenido -->
<div id="ezoic-pub-ad-placeholder-104">
</div>
</body>
Una vez que los marcadores de posición se han agregado al HTML, llame al código del anuncio de Ezoic utilizando ezstandalone.displayMore().
<script type="text/javascript">
window.ezstandalone = window.ezstandalone || {};
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
ezstandalone.showAds(103, 104);
});
</script>
Para los sitios integrados sin marcadores de posición estáticos que desean cargar todos los marcadores de posición dinámicamente utilizando nuestra configuración de anuncios del lado del cliente, por favor use la siguiente guía: Comenzar con EzoicAds.
Marcadores de posición estáticos son los que se agregan al HTML al pasar a través de nuestro proxy, en lugar de ser agregados a través de JavaScript.Similar a dividir el tráfico en un sitio usando la opción de fragmento de código del lado del cliente, puede agregar la misma función sin pasar ningún parámetro:
<script type="text/javascript">
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
if(ezstandalone.isEzoicUser()) {
ezstandalone.showAds(100,101);
} else {
// Ejecución normal del código de anunciosEzoicAds proporciona características avanzadas que permiten a los editores ajustar finamente el comportamiento de la biblioteca de anuncios. Estas características se pueden utilizar para personalizar el comportamiento de la biblioteca de anuncios para satisfacer mejor las necesidades de su sitio. Vea aquí para más instrucciones: https://docs.ezoic.com/docs/ezoicads/advanced/
Al configurar EzoicAds en tu sitio, es importante asegurarse de que todo funcione correctamente. Proporcionamos un Depurador de Integración JavaScript incorporado que te permite diagnosticar rápidamente problemas con la configuración de tus anuncios. A continuación, encontrarás una guía paso a paso sobre cómo usar este depurador e interpretar sus resultados.
Para activar el depurador, simplemente añade el siguiente parámetro de consulta a la URL de la página donde se integran tus EzoicAds:
ez_js_debugger=1Por ejemplo:
https://www.tusitio.com?ez_js_debugger=1Una vez que el parámetro de consulta ha sido añadido y la página carga, aparecerá un cuadro de diálogo modal verde en la parte inferior central de la pantalla. Este es el Depurador de Integración JavaScript.
El modal del depurador contiene varias piezas clave de información que te ayudarán a solucionar problemas con tu configuración. Aquí hay un desglose de la información proporcionada:
Detección de Script: El depurador verificará si el script de Ezoic está correctamente incluido en tu página. Si el script no se encuentra, verás un mensaje de error. Asegúrate de que la etiqueta del script de Ezoic esté colocada en la ubicación correcta de tu página.
Detección de Marcadores de Posición: Se mostrará el número de marcadores de posición definidos en tu página. Esto ayuda a verificar si los marcadores de posición han sido reconocidos con éxito por el sistema de Ezoic.
Estado de los Anuncios: Para cada marcador de posición, el depurador indicará si un anuncio ha sido renderizado con éxito. Muestra:
Éxito de la Solicitud: El depurador también monitorea si la solicitud de anuncio fue enviada con éxito. Si hay un problema, el modal mostrará detalles de error para ayudar a identificar la causa raíz (por ejemplo, problemas de red, configuración incorrecta).
La información proporcionada en el modal del depurador es invaluable para diagnosticar problemas comunes como:
Anuncios No Mostrados: Verifica la detección de marcadores de posición y el estado de los anuncios para asegurar que los marcadores de posición estén definidos y los anuncios asignados.
Fallo en las Solicitudes de Anuncios: Si las solicitudes de anuncios no se están enviando o están fallando, el depurador proporcionará mensajes de error que apuntan a posibles configuraciones incorrectas.
Problemas de Carga del Script: Si el script no se carga correctamente, verifica que la etiqueta del script esté presente en tu código fuente y configurada correctamente.
Si necesitas más ayuda con la Integración Híbrida, por favor inicia sesión a través de https://support.ezoic.com/ para hacer uso de nuestros recursos dedicados para soporte. ¡Estamos aquí para ayudar!