Article Navigation
Introducción
Instrucciones
Solución de problemas
Información de contacto para obtener más ayuda
Knowledgebase
chevron_right
Integration
chevron_right
Cómo integrarse con Ezoic usando JavaScript
How-To/Instructional

Cómo integrarse con Ezoic usando JavaScript

JS Integration
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 sencillo, proporcionando a los editores un control y personalización completos. Este método de integración es compatible con todas las construcciones de sitios e implica 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 de Ezoic. Si no lo has hecho todavía, puedes hacerlo aquí.
  2. Conéctate con tu Especialista de Incorporación de Ezoic si necesitas ayuda para configurar ads.txt o aceptar la invitación de Google MCM.


Configuración de Anuncios

Conectar tu sitio a Ezoic es un proceso simple que implica agregar algunas líneas de código a tu sitio. Mientras esperas la aprobación de Google Ad Manager, te recomendamos configurar un entorno de pruebas 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á a través de los pasos para implementar EzoicAds en tu sitio.

Para implementar EzoicAds, necesitarás crear ubicaciones de anuncios en tu sitio. Estas ubicaciones de anuncios se usará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 Ezoic, o puedes trabajar con tu Especialista de Incorporació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 usas 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 en el encabezado dentro de la etiqueta <head>. Si colocarlos en el encabezado no es factible, la siguiente mejor opción es colocarlos en la parte superior de la etiqueta <body>). Asegúrate de cargar el script de privacidad antes del script de encabezado.

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

Script de Encabezado:
<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 ningún estilo al div del marcador de posición real. Agregar estilos o reservar espacio para el anuncio puede resultar en resultados no deseados (por ejemplo, si un marcador de posición no es elegido por nuestro sistema, puede haber espacio vacío en la página).

Llamar 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 dinámicamente, puede ser necesaria una configuración adicional. Consulta las instrucciones adicionales aquí: 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 nombres o Cloudflare, mientras utiliza el fragmento de código del lado del cliente para llamar a los anuncios. El beneficio de la integración híbrida es que permite a otros productos de Ezoic (p. ej., Velocidad del Sitio, SEO) la posibilidad de cargar anuncios dinámicamente. Consulta las instrucciones adicionales aquí: https://support.ezoic.com/kb/article/hybrid-integration


Videos de Humix

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


Avanzado

EzoicAds ofrece características avanzadas que permiten a los editores ajustar el comportamiento de la librería de anuncios. Estas características pueden usarse para personalizar el comportamiento de la librería de anuncios para que se adapte mejor a las necesidades de tu sitio. Consulta las instrucciones adicionales aquí: https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features

Solución de problemas

```html

Al configurar EzoicAds en su sitio, es importante asegurarse de que todo funcione correctamente. Proporcionamos un Depurador de Integración JavaScript incorporado que le permite diagnosticar rápidamente problemas con la configuración de sus 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ñada el siguiente parámetro de consulta a la URL de la página donde están integrados sus EzoicAds:

ez_js_debugger=1

Por ejemplo:

https://www.yourwebsite.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 modal verde en el centro inferior de la pantalla. Este es el Depurador de Integración JavaScript.

El modal del depurador contiene varias piezas clave de información que le ayudarán a solucionar su configuración. Aquí se desglosa la información proporcionada:

  • Detección de Script: El depurador verificará si el script de Ezoic está correctamente incluido en su página. Si el script no se encuentra, verá un mensaje de error. Asegúrese de que la etiqueta del script de Ezoic esté ubicada en el lugar correcto de su página.

  • Detección de Marcadores de Posición: Se mostrará el número de marcadores de posición definidos en su 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:

    • 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 Solicitud: El depurador también supervisa si la solicitud de anuncio se envió 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, mala configuración).

La información proporcionada en el modal del depurador es invaluable para diagnosticar problemas comunes como:

  • Anuncios que No se Muestran: Verifique la detección de marcadores de posición y el estado del anuncio para asegurarse de que los marcadores de posición estén definidos y los anuncios asignados.

  • Solicitudes de Anuncios Fallidas: 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, verifique que la etiqueta del script esté presente en su código fuente y configurada correctamente.

```

Información de contacto para obtener más ayuda

Si necesita más ayuda con la integración de JavaScript (independiente), por favor inicie sesión a través de https://support.ezoic.com/ para hacer uso de nuestros recursos dedicados para soporte. ¡Estamos aquí para ayudar!

¿Te resultó útil este artículo?

× Enlarged Image

Loading ...