chevron_right
chevron_right
Integración de JavaScript (Independiente)
How-To/Instructional

Integración de JavaScript (Independiente)

Last Updated over a month ago
Article Navigation
Introducción
Instrucciones
Solución de problemas
Información de contacto para obtener más ayuda

Introducción

Conectarse a Ezoic a través de JavaScript (a veces llamado integración "independiente") es rápido y simple, proporcionando a los editores un control y personalización completos. Este método de integración es compatible con todas las estructuras de sitios y consiste en insertar un pequeño fragmento de código JavaScript en el HTML de su sitio web, lo que permite a Ezoic gestionar y optimizar la colocación de anuncios en su sitio. En este artículo, proporcionaremos una guía paso a paso sobre cómo integrar Ezoic utilizando el método JavaScript.

Instrucciones

  1. Asegúrate de haber creado una cuenta en Ezoic. Si aún no lo has hecho, puedes hacerlo aquí.
  2. Conéctate con tu Especialista de Integración de Ezoic si necesitas ayuda para configurar el archivo ads.txt o aceptar la invitación de Google MCM.


Configuración de Anuncios

Conectar tu sitio a Ezoic es un proceso sencillo que implica agregar unas pocas líneas de código a tu sitio. Mientras esperas la aprobación de Google Ad Manager, recomendamos realizar la configuración en un entorno de staging o desarrollo para asegurarte de que tus ubicaciones de anuncios estén configuradas correctamente y la carga de anuncios esté confirmada.

Esta guía te llevará paso a paso a través del proceso para implementar EzoicAds en tu sitio.

Para implementar EzoicAds, necesitarás crear ubicaciones de anuncios en tu sitio. Estas ubicaciones de anuncios se utilizarán para definir los lugares en tu sitio donde se mostrarán los anuncios de Ezoic.

Puedes crear ubicaciones de anuncios en tu Panel de Control de Ezoic, o puedes trabajar con tu Especialista de Integración de Ezoic para crear las ubicaciones de anuncios ideales para tu sitio.

Agrega el Script de Privacidad de Ezoic (esto supone que estás usando el Modal de Consentimiento de Ezoic. Si estás usando un modal de terceros, sigue los pasos descritos aquí) y el Script de Encabezado en la parte superior de la etiqueta <head> (para una configuración y entrega de anuncios más rápida, recomendamos insertar estos scripts de encabezado dentro de la etiqueta <head>. Si no es posible colocarlos en el encabezado, la mejor opción siguiente es posicionarlos en la parte superior de la etiqueta <body>). Por favor, asegúrate de cargar el script de privacidad antes que el script de encabezado.

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script async src="//www.ezojs.com/ezoic/sa.min.js"></script>
<script>
  window.ezstandalone = window.ezstandalone || {};
  ezstandalone.cmd = ezstandalone.cmd || [];
</script>

Este código se llamará para cada ubicación de anuncio. Es importante notar que el ID de 3 dígitos 101 representa una ubicación de anuncio específica, y cada ubicación de anuncio tendrá un ID de 3 dígitos diferente. Los códigos de anuncios se generarán en tu Panel de EzoicAds.

Cada ubicación de anuncio tendrá la siguiente estructura:

<div id="ezoic-pub-ad-placeholder-101"></div>
<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.showAds(101)
    });
</script>

Inserta este código para cada ubicación de anuncio en tu sitio.

NO agregues estilos al marcador de posición div. Agregar estilos o reservar espacio para el anuncio puede terminar con resultados no deseados (por ejemplo, si un marcador de posición no es elegido por nuestro sistema, puede haber un espacio vacío en la página).

Llamar a ezstandalone.showAds() sin definir un valor de marcador de posición llamará a la función para cada marcador de posición que exista en esa página.


Contenido Dinámico

Si el contenido de tu sitio web se carga o cambia de manera dinámica, puede ser necesaria una configuración adicional. Consulta aquí para más instrucciones: https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic

La Integración Híbrida es cuando un sitio se integra a través de servidores de nombre o Cloudflare, mientras utiliza el fragmento de código del lado del cliente para solicitar anuncios. El beneficio de la integración híbrida es que habilita otros productos de Ezoic (por ejemplo, Velocidad del SitioSEO) con la capacidad de cargar anuncios dinámicamente. Consulta aquí para más instrucciones: https://support.ezoic.com/kb/article/hybrid-integration


Videos Humix

El Generador de Códigos para Insertar desde tu Panel de Humix se puede usar para agregar nuestro Reproductor de Video a tu sitio web.


Avanzado

EzoicAds ofrece funciones avanzadas que permiten a los editores ajustar el comportamiento de la biblioteca de anuncios. Estas funciones se pueden utilizar para personalizar el comportamiento de la biblioteca de anuncios para adaptarse mejor a las necesidades de tu sitio. Consulta aquí para más instrucciones: https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features

Solución de problemas

Al configurar EzoicAds en tu sitio, es importante asegurarse de que todo funcione correctamente. Proporcionamos un Depurador de Integración de JavaScript incorporado 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 salidas.

Para activar el depurador, simplemente agrega el siguiente parámetro de consulta a la URL de la página donde tus EzoicAds están integrados:

ez_js_debugger=1

Por ejemplo:

https://www.tusitio.com?ez_js_debugger=1

Una vez que se añade el parámetro de consulta y la página se carga, aparecerá un cuadro de diálogo verde en el centro inferior de la pantalla. Este es el Depurador de Integración de JavaScript.

El cuadro de diálogo del depurador contiene varias piezas clave de información que te ayudarán a solucionar problemas de tu configuración. Aquí hay un desglose de la información proporcionada:

  • Detección de Scripts: El depurador comprobará 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 en 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 Ezoic.

  • Estado del Anuncio: Para cada marcador de posición, el depurador indicará si un anuncio ha sido renderizado con éxito. Muestra:

    • Si un anuncio está asignado a un marcador de posición específico.
    • Si se envió una solicitud a Ezoic para obtener un anuncio para ese marcador de posición.
  • Éxito de la Solicitud: El depurador también monitorea si la solicitud de anuncio se envió con éxito. Si hay un problema, el cuadro de diálogo mostrará detalles del error para ayudar a identificar la causa raíz (por ejemplo, problemas de red, mala configuración).

La información proporcionada en el cuadro de diálogo del depurador es invaluable para diagnosticar problemas comunes como:

  • Anuncios que No se Muestran: 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.

  • Fallos 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 señalan posibles malas configuraciones.

  • 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.

Información de contacto para obtener más ayuda

Si necesitas más ayuda con la Integración de JavaScript (Independiente), por favor inicia sesión a través de https://support.ezoic.com/ para utilizar nuestros recursos dedicados para soporte. ¡Estamos aquí para ayudar!

× Enlarged Image

Loading ...