Conectarse a Ezoic a través de JavaScript (a veces llamado integración "independiente") es rápido y sencillo, proporcionando a los editores control y personalización completos. Las funciones avanzadas te permiten ajustar los detalles de tu configuración. Estas funciones se pueden utilizar para personalizar el comportamiento de la biblioteca de anuncios para adaptarse mejor a las necesidades de tu sitio.

Anuncios de Anclas

Por defecto, Ezoic mostrará anuncios de anclas si están habilitados en el panel de control bajo la pestaña EzoicAds.

Apagar Anuncios de Anclas

Para desactivar el Anuncio de Ancla en una página específica, se puede usar la función ezstandalone.setEzoicAnchorAd.

<script >
    window.ezstandalone = window.ezstandalone || {};
    ezstandalone.cmd = ezstandalone.cmd || [];
    ezstandalone.cmd.push(function() {
        ezstandalone.setEzoicAnchorAd(false);
        ezstandalone.showAds(101, 102, 103);
    });
</script>

Verificación de Cierre del Anuncio de Ancla

Para verificar si el Anuncio de Ancla se ha cerrado en la sesión de un usuario, use la función hasAnchorAdBeenClosed.

A continuación, se presenta un ejemplo de cómo usar la función para determinar si se debe seguir mostrando el Anuncio de Ancla

<script >
    window.ezstandalone = window.ezstandalone || {};
    ezstandalone.cmd = ezstandalone.cmd || [];
    ezstandalone.cmd.push(function() {
        let anchorHasBeenClosed = ezstandalone.hasAnchorAdBeenClosed();
        ezstandalone.setEzoicAnchorAd(anchorHasBeenClosed);
        ezstandalone.showAds(101, 102, 103);
    });
</script>

ezstandalone.cmd.push(function() {
    ezstandalone.config({
        // Las opciones de configuración van aquí
    });
});

ezstandalone.cmd.push(function() {
    ezstandalone.config({ limitCookies: true });
});

Posición del Anuncio de Ancla

Le permite cambiar la posición del Anuncio de Ancla para que esté en la parte superior o inferior de la página. Los valores aceptables son 'top' o 'bottom'. El Anuncio de Ancla se ubicará en la parte inferior de la página por defecto.

Por ejemplo, para establecer la posición del anuncio de ancla en la parte superior de la página:

ezstandalone.cmd.push(function() {
    ezstandalone.config({ anchorAdPosition: "top" });
});

Se añadirán más opciones en el futuro. Por favor, consulte para actualizaciones.

Datos de Seguimiento

Si desea rastrear datos incluso en páginas que no están mostrando anuncios, puede incluir el siguiente script. Esto es especialmente útil en las etapas iniciales de prueba cuando aun no está listo para mostrar anuncios.

<script src="//ezoicanalytics.com/analytics.js"></script>

Nuevas Funcionalidades (Beta)

Estas son nuevas funcionalidades que están disponibles para ser implementadas pero aún están en Beta y pueden cambiar antes de ser completamente lanzadas.

Uso Avanzado de ShowAds

La implementación avanzada proporciona funcionalidades adicionales al aceptar una matriz de objetos. Cada objeto puede incluir los siguientes atributos:

• id (obligatorio): El identificador único del marcador de posición en el que se debe mostrar el anuncio.
• required (opcional, booleano): Una bandera que indica si el anuncio debe ser mostrado. Si está establecido en `true`, el sistema forzará la visualización de un anuncio en el marcador de posición especificado, incluso si normalmente no se mostraría.
• sizes (opcional, cadena o matriz de cadenas): Especifica los tamaños permitidos para el anuncio en el formato `'{width}x{height}'`. Puede proporcionar un tamaño único como cadena o varios tamaños como una matriz de cadenas. Esto le permite controlar las dimensiones del anuncio que se mostrará.

Implementación de Ejemplo

<script>
var placeholders = [
    { id: 103, required: true, sizes: ['336x280', '126x126'] },
    { id: 104, sizes: '1000x450' },  
    { id: 105, required: true },
];

ezstandalone.showAds(placeholders);
</script>

En este ejemplo:

1. Marcador de posición 103:

   • Siempre se mostrará un anuncio en el marcador de posición `103`.
   • Los tamaños permitidos para el anuncio son `336x280` y `126x126`.

2. Marcador de posición 104:

   • Se mostrará un anuncio en el marcador de posición `104` si Ezoic decide que este anuncio debe ser mostrado.
   • El tamaño permitido para el anuncio es `1000x450`.

3. Marcador de posición 105:

   • Siempre se mostrará un anuncio en el marcador de posición `105`.
   • No se proporcionan tamaños específicos, por lo que Ezoic decidirá el mejor tamaño para este marcador.

Notas

• Especificidad de los Tamaños de Anuncio: Los tamaños de anuncio especificados en el atributo `sizes` se tratan como solicitudes específicas. Ezoic intentará encontrar el mejor anuncio posible que se ajuste al tamaño dado. Si no hay una coincidencia exacta disponible, el sistema elegirá el tamaño disponible más cercano que pueda ajustarse mejor dentro de las dimensiones especificadas.
• Si el atributo `required` está configurado en `true`, Ezoic priorizará mostrar el anuncio en ese marcador de posición, asegurando que se muestre incluso si otras condiciones normalmente lo impedirían.
• Si se especifican `sizes`, el anuncio solo se mostrará si hay un anuncio de los tamaños especificados disponible. Si el atributo `sizes` se omite o se deja vacío, Ezoic usará su comportamiento predeterminado para determinar el tamaño del anuncio.

Casos de Uso

• Colocación Garantizada de Anuncios: Use el atributo `required` para asegurar que los anuncios se muestren en marcadores de posición críticos, independientemente de otras condiciones.
• Anuncios con Tamaño Específico: Use el atributo `sizes` para controlar las dimensiones de los anuncios que se están mostrando. Esto es particularmente útil para diseños responsivos o requisitos específicos de diseño donde ciertos tamaños son más efectivos.

Este método avanzado ofrece flexibilidad y control sobre la colocación de anuncios, haciéndolo adecuado para escenarios donde se necesita algo más que solo el ID del marcador de posición para dictar el comportamiento del anuncio.

RefreshAds

refreshAds es una nueva función en ezstandalone que permite actualizar el anuncio para marcadores de posición específicos. Esto se puede usar si desea refrescar un anuncio para un espectador en un momento específico. A continuación se muestra un ejemplo del uso de la función.

<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.refreshAds(101, 102)
    });
</script>

Si necesitas más ayuda con alguna de las funciones avanzadas de la Integración JavaScript, por favor inicie sesión en https://support.ezoic.com/ para hacer uso de nuestros recursos dedicados para soporte. ¡Estamos aquí para ayudar!