Guías de uso

Guía de migración de Smart Banner v1 a v2

Sugerir ediciones

⚠️

Aviso importante

As of Nov. 8th, 2023, AppsFlyer Smart Banner web SDK v1, is deprecated. From this date onwards websites using the Smart Banner web SDK v1 can no longer show Smart Banners.
Please upgrade to Smart Banner v2 by following the instructions in this article.

Resumen General

Actualizar tu SDK a una nueva versión puede ser un proceso sencillo, pero es importante entender los cambios que se han realizado. En este tutorial, repasaremos los pasos para actualizar tu SDK actual a la nueva versión, y cómo ajustar tu código para acomodar los cambios.

Requisitos previos

  1. Asegúrate de descargar la última versión del SDK.
    Si ya tienes el SDK web de PBA independiente, elimínalo y reemplázalo por el SDK web tanto para Smart Banners como para la atribución basada en personas; no agregues solo el SDK web independiente para Smart Banners.

Puedes encontrar ambos fragmentos del SDK aquí (por favor elige el que más te convenga):
1. Uso del SDK web para Smart Banners únicamente.
2. Uso del SDK web tanto para Smart Banners como para la Atribución basada en personas.

Instalación

Reemplaza el fragmento de SDK antiguo en tu sitio web por el nuevo.
Simplemente reemplaza el fragmento de código antiguo en la etiqueta <head> de cada página que muestra tus banners móviles con el nuevo fragmento de SDK.

Métodos del SDK

  1. Una vez que el nuevo SDK esté en uso, deberás ajustar tu código para reflejar los cambios.
    En este caso, el SDK antiguo incluía funciones en desuso como:
    disableBanners()
    disableTracking()
    getAdditionalParams()
    setAdditionalParams()

Estas funciones se han eliminado en el nuevo SDK, por lo que deberás eliminar cualquier referencia a ellas en tu código.

showBanner

En el antiguo SDK, la función showBanner se llamaba así:

showBanner({ bannerContainerQuery: "#container-id",
              bannerZIndex: 1000,
              additionalParams: { deep_link_value: "flights", deep_link_sub1: "london"}});

En el nuevo SDK, la función showBanner se llama así:

AF('banners', 'showBanner', { bannerContainerQuery: "#container-id",
              bannerZIndex: 1000,
              additionalParams: { deep_link_value: "flights", deep_link_sub1: "london"}});

hideBanner

The hideBanner también ha cambiado, pasando de:

hideBanner()

a la nueva versión

AF('banners', 'hideBanner')

updateParams

El nuevo SDK te permite agregar programáticamente hasta 10 parámetros a la URL de OneLink asignada al botón de llamada a la acción (CTA), después de que se muestre el banner. Esto es útil para el rastreo u otros fines en los que necesites pasar datos dinámicos a tu OneLink.

Ejemplo:

AF ("banners", "updateParams", {af_ad: "my_new_ad", deep_link_sub8: "promo_summer"})

Es importante tener en cuenta que este método no funciona con el SDK web de Smart Banner en desuso.

Actualizado hace aproximadamente 1 año