Si te preocupa usar Ezoic con sitios más complejos que tienen una combinación de contenido estático y dinámico, ¡no te preocupes! Este artículo proporcionará orientación sobre cómo integrar eficazmente con Ezoic a través de la Integración Híbrida, permitiendo que tu sitio se beneficie de todas las potentes funciones 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 utilizar todas las funciones de Ezoic (por ejemplo, Velocidad del Sitio, SEO), mientras usan el fragmento de código del lado del cliente para llamar a los anuncios.
Todos los modelos 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 hacer cambios en su DNS tienen la opción de usar la Integración de JavaScript (Independiente) https://support.ezoic.com/kb/article/javascript-standalone-integration en su lugar. Los sitios que sí utilizan contenido dinámico y no desean hacer cambios en su DNS también pueden integrarse con Ezoic a través de este método, sin embargo, puede ser necesaria una configuración adicional. Consulte https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic para obtener más instrucciones.
Asegúrese de que los marcadores de posición se creen a través del panel de control. Consulte este artículo para saber más sobre los marcadores de posición y cómo crearlos.
Cargue la biblioteca de código añadiendo este script al <head> de la página. Algunas funciones de Ezoic requieren que el HTML exista de forma estática en lugar de cargarse a través de JavaScript.
<script async src="https://www.ezojs.com/ezoic/sa.min.js"></script>
Para añadir un marcador de posición a la página, cree un elemento div donde debería ir el anuncio. El atributo id del elemento debe ser el ID del marcador de posición con el prefijo ezoic-pub-ad-placeholder-.
Por ejemplo, para añadir marcadores de posición con los 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 añadido al HTML, llame al código de anuncios de 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>
Para sitios integrados sin marcadores de posición estáticos que desean cargar todos los marcadores de posición dinámicamente usando nuestra configuración de anuncios del lado del cliente, por favor use la siguiente guía: Comenzando con EzoicAds.
Marcadores de posición estáticos son los marcadores de posición que se añaden al html al pasar por nuestro proxy, en lugar de ser añadidos vía JavaScript.Similar a la división de tráfico en un sitio usando la opción de fragmento de código del lado del cliente, puede añadir 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 ofrece funciones avanzadas que permiten a los editores afinar el comportamiento de la biblioteca de anuncios. Estas características pueden ser usadas para personalizar el comportamiento de la biblioteca de anuncios para adaptarse mejor a las necesidades de su sitio. Consulte aquí para más instrucciones: https://docs.ezoic.com/docs/ezoicads/advanced/
Cuando configures EzoicAds en tu sitio, es importante asegurarse de que todo funcione correctamente. Proporcionamos un Depurador de Integración de JavaScript integrado que te permite diagnosticar rápidamente problemas con la configuración de tus anuncios. A continuación, se presenta 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 tus EzoicAds están integrados:
ez_js_debugger=1Por ejemplo:
https://www.tusitio.com?ez_js_debugger=1Una vez que se añade el parámetro de consulta y la página se carga, aparecerá un diálogo modal verde en la parte inferior central de la pantalla. Este es el Depurador de Integración de JavaScript.
El modal del depurador contiene varias piezas clave de información que te ayudarán a solucionar problemas de tu configuración. Aquí tienes 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 el lugar correcto 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 exitosamente por el sistema de Ezoic.
Estado del Anuncio: Para cada marcador de posición, el depurador indicará si un anuncio se ha renderizado exitosamente. Muestra:
Éxito de la Solicitud: El depurador también monitorea si la solicitud de anuncio se envió correctamente. Si hay un problema, el modal mostrará detalles del error para ayudar a identificar la causa principal (por ejemplo, problemas de red, configuraciones incorrectas).
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 del anuncio para asegurarte de que los marcadores de posición están definidos y los anuncios asignados.
Solicitud de Anuncios Fallida: Si las solicitudes de anuncios no se envían o fallan, el depurador proporcionará mensajes de error que apuntan a posibles configuraciones incorrectas.
Problemas de Carga de 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 ayudarte!