Conectar VTEX con ActiveCampaign

Marketing_Plus_Professional_Enterprise

Usa la integración de ActiveCampaign VTEX para sincronizar contactos, visitas al sitio web y datos de compra de la tienda VTEX con ActiveCampaign.

Toma nota

  • Necesitas una cuenta ActiveCampaign y una cuenta VTEX que utilice VTEX IO para utilizar esta integración
  • Asegúrate de que el entorno VTEX en el que deseas instalar la app esté configurado con un host de sitio web de "Tienda" en https://{AccountName}.myvtex.com/admin/license-manager/#/account-details NOTA: Si visitas esta página y ves una pantalla en blanco, deberás solicitar acceso de propietario (Admin Super) a la cuenta de VTEX o acceso a las pantallas de "Administrador de licencias" en VTEX para verificar que el host esté configurado
  • Asegúrate de tener acceso a "Datos maestros" en el administrador de VTEX
  • Los contactos sincronizados con ActiveCampaign desde VTEX reciben la siguiente etiqueta: VTEX-customer
  • Para sincronizar la información de marketing de opt-in con ActiveCampaign, debes crear un campo de contacto personalizado en ActiveCampaign llamado "Acepta marketing". Puedes usar este campo para sincronizar los datos de la casilla de verificación "Quiero recibir el boletín informativo" desde la instancia de pago de VTEX. Lee la sección "Crear un campo de contacto personalizado desde la página Administrar campos" del artículo Información general sobre campos de contacto personalizados para saber cómo crear este campo
  • Cuentas de ActiveCampaign creadas a partir del 8 de enero de 2024: los contactos sincronizados desde la integración VETEX que hayan marcado la casilla "Deseo recibir el boletín informativo" se añadirán a la Lista maestra de contactos de forma predeterminada. Si elimina o cambia el nombre de la lista maestra de contactos creada por ActiveCampaign, los contactos no se añadirán a ninguna lista. Para añadir contactos a una lista, deberá crear una automatización
  • Parte de esta configuración requiere la implementación de código. Nuestro equipo de experiencia del cliente no puede ayudarle a crear o solucionar problemas de código

Acerca de la integración de ActiveCampaign VTEX

Los pasos de configuración de la integración de ActiveCampaign VTEX se realizan desde la cuenta de VTEX. Una vez que se completen todos los pasos de cada sección a continuación, los siguientes datos se sincronizarán con tu cuenta de ActiveCampaign:

  • Visitas al sitio web (utiliza el seguimiento de sitio de ActiveCampaign)
  • Datos de compra
  • Datos de carrito abandonado
  • Datos del cliente
  • Datos del pedido
  • Datos de formulario (utilizando una barra flotante, una casilla flotante o un formulario modal creado en ActiveCampaign)
  • Datos de la casilla de verificación "Quiero recibir el boletín informativo" de la instancia de pago de VTEX para facilitar el cumplimiento de RGDP (requiere la configuración de un campo de contacto personalizado en ActiveCampaign)

Todos los datos de compra y carrito abandonado aparecerán en un cuadro de ecommerce en el registro del contacto.

Una vez que tengas estos datos en tu cuenta, podrás usar ActiveCampaign para hacer lo siguiente:

  • Crear automatizaciones de carritos abandonados con el desencadenante de automatización de carritos abandonados y el bloque de contenido de correo electrónico sobre carritos abandonados. Para obtener más información, lee el artículo "Información general sobre Deep Data de carritos abandonados"
  • Personalizar de forma directa y automatizada con información de contacto y pedido
  • Segmentar los contactos por visitas al sitio web, datos de compra, datos de carritos abandonados y más

Conectar VTEX con ActiveCampaign

Esta configuración se realiza en la cuenta de VTEX.

  1. Instala la app activecampaignpartnerus.activecampaign en el entorno VTEX deseado. Para hacerlo, ve a Apps > App Store en el administrador de VTEX. Selecciona la app de ActiveCampaign y, a continuación, haz clic en Instalar.
  2. En la cuenta de administrador de VTEX, ve a Apps > Mis Apps y selecciona la casilla de ActiveCampaign.
  3. Una vez en la página de configuración de la app, define lo siguiente:
    • Nombre de la cuenta de ActiveCampaign. El nombre de la cuenta se encuentra en la página Configuración > Cuenta en tu cuenta de ActiveCampaign. Por ejemplo, si tu cuenta es xyz123.activehosted.com, solo debes escribir xyz123 como nombre de la cuenta en VTEX
    • Clave ActiveCampaign. Para más información, consulte la URL y la clave de la API
    • Tracking setAccount ID - Deje este campo en blanco por ahora
    • ConnectionID. Deja este campo en blanco
  4. Haz clic en "Guardar".
  5. A continuación, busca el menú de ActiveCampaign.
    • En el administrador de VTEX "anterior", se encuentra en la barra lateral de administración de VTEX en Productos
    • En el administrador de VTEX "más reciente", se encuentra en el menú deslizable de apps en Apps instaladas
  6. Haz clic en ActiveCampaign > Configuración de ID de conexión
    • Haz clic en Configurar
    • Espera que se rellenen los campos
    • Haz clic en el menú desplegable ID externo y, a continuación, selecciona el ID de tu tienda
    • Haz clic en el menú desplegable URL del enlace y, luego, selecciona la URL de la tienda 
    • Haz clic en Continuar configuración. Verás el mensaje "La cuenta se ha actualizado". La página se actualizará y mostrará la página Configuración de la app. Tu ConnectionID ahora está completado
  7. Haz clic en "Guardar".
  8. Haz clic en ActiveCampaign > Configuración de datos de compra
    • Divisa - Introduzca el código de divisa ISO de 3 letras para su tienda (como USD para dólares estadounidenses)
    • Enviar datos de compra (opcional)- Haga clic en la casilla de verificación situada junto a "¿Enviar datos de compra?" si desea sincronizar los pedidos con ActiveCampaign
      • Esta opción envía los datos del cliente, incluido el campo "accepts_marketing" y los datos del pedido, a ActiveCampaign cuando el cliente llega a la página de confirmación del pedido y si se ha recibido el pago. Si ActiveCampaign no recibe los datos del pedido, el pedido se enviará a ActiveCampaign cuando se facture en VTEX
    • Los pedidos de preparación logística no se sincronizan con ActiveCampaign
  9. Haz clic en "Guardar". Verás un mensaje de confirmación.
  10. Haz clic en ActiveCampaign > Conexiones.
    • Esta información debe coincidir con las integraciones conectadas en tu cuenta de ActiveCampaign
    • Para confirmar esto, inicia sesión en tu cuenta de ActiveCampaign, luego ve a Configuración > Integraciones. Debería ver el logotipo VTEX y el estado "Conectado" en esta página

Activa el seguimiento de sitio y coloca en la lista blanca tu(s) dominio(s) (opcional)

Esta integración utiliza la función de seguimiento de sitio de ActiveCampaign. No es necesario agregar un código de seguimiento de sitio en tu sitio web.

Sin embargo, debes agregar el ID de seguimiento en la configuración de la app VTEX en "Seguimiento de setAccount ID". La integración agrega el código de seguimiento de sitio automáticamente. Aún debes desencadenar la función de seguimiento de sitio y poner en la lista blanca tu(s) dominio(s) en la página Sitio web > Seguimiento de sitio en tu cuenta de ActiveCampaign. Para ello:

  1. Haz clic en Sitio web en tu cuenta de ActiveCampaign.
  2. Haz clic en Seguimiento de sitio.
  3. Haz clic en el botón de alternancia de Seguimiento de sitio para establecerlo en la posición "Activado".
  4. Escriba o pegue su dominio web en el campo URL del sitio web, luego haga clic en el botón Añadir.
  5. Copie el número setTrackAccount ID del fragmento de código de seguimiento y péguelo en la configuración de la aplicación VTEX.

Configuración de sincronización de carrito abandonado (opcional)

  Algunos de los términos incluidos en esta sección están en portugués. Esto se debe a que, dentro de la app VTEX, se utiliza dicho idioma. En este artículo, se refleja la terminología de la app. En las áreas en las que VTEX a veces traduce al inglés, hemos añadido los términos equivalentes a continuación entre paréntesis [ ] como referencia.

Esta integración sincroniza la información del cliente y los datos de su carrito abandonado con ActiveCampaign. Puedes utilizar esta información para enviar correos electrónicos a tus clientes para recordarles sobre sus carritos abandonados. Para permitir esto, debes configurar un desencadenante de carrito abandonado en VTEX.

  1. En el administrador de VTEX, accede a Datos maestros. Después de iniciar sesión en Datos maestros:
    • Haz clic en Configuración avanzada
    • Haz clic en Estructura de datos
    • Haz clic en Desencadenar
    • Haz clic en Agregar nuevo
  2. Completa la información de la siguiente manera:
    • Nombre: Desencadenante de ActiveCampaign
    • Entidad de datos - Cliente [Client]
    • En la pestaña Reglas:
      • Trigger Rule - O valor de um atributo for alterado [Se cambia el valor de un atributo]
      • Campo - Última sesión
      • Haz clic en "Añadir filtro" y, a continuación, selecciona o introduce lo siguiente:
        • Instancia de pago
        • Diferente [Different from]
        • Finalizado
      • Haz clic en "Añadir filtro" y, a continuación, selecciona o introduce lo siguiente:
        • Instancia de pago
        • Não está nulo [no es nulo]
      • Haz clic en "Añadir filtro" y, a continuación, selecciona o introduce lo siguiente:
        • Carrinho [Carrito]
        • Não está nulo [no es nulo]
      • Haz clic en "Añadir filtro" y, a continuación, selecciona o introduce lo siguiente:
        • Último Carrinho
        • Não está nulo [no es nulo]
    • Haz clic en la pestaña Programar y elige cuándo VTEX enviará los datos de carrito abandonado a ActiveCampaign. Las opciones son las siguientes:
      • Ejecutar lo antes posible: esto envía los datos a ActiveCampaign en aproximadamente 45 minutos (lee la nota a continuación) después de que el cliente abandona su carrito. Si utilizas esta opción, dependiendo de tu configuración en ActiveCampaign, el cliente puede recibir un correo electrónico de carrito abandonado incluso si ha efectuado una compra
      • Programar en fecha específica: esta configuración permite ingresar una fecha particular para enviar los datos a ActiveCampaign. Esto no se recomienda para correos electrónicos sobre carritos abandonados
      • Programar en fecha dinámica: esta configuración permite establecer un plazo que transcurrirá antes de que VTEX envíe los datos a ActiveCampaign (esto se basa en la última sesión del cliente (Data de Última sessão). NOTA: La mayoría de los clientes eligen esta opción y la establecen en 2 horas después de la última sesión.

        Ejemplo:
        VTEX_Example.png
        Según la documentación de VTEX: "La sesión de una página caduca en 30 minutos. Solo después de ese tiempo, el sistema programa el desencadenante de carrito abandonado. Es decir, el tiempo a considerar es el tiempo de la sesión + la programación del desencadenante".

      • Después de realizar la selección de programación, haz clic en la pestaña Si es positivo. Luego, selecciona o introduce lo siguiente solo en estos campos: 
        • Acción: Enviar una solicitud HTTP
        • En Solicitar datos:
          • URL - (introduzca la URL a continuación, sustituyendo www.yourwebsiteurl.com por la URL de su sitio web - NO incluya espacios en este campo) https://www.yourwebsiteurl.com/api/io/activeCampaign/abandonedCart
          • Método: POST
          • Encabezados: Nombre - Content-Type
          • Encabezados: Valor - application/json
          • Contenido como JSON: (reemplaza el contenido que está allí por el siguiente):
            {

            "rclastcart": "{!rclastcart}",

            "rclastcartvalue": "{!rclastcartvalue}",

            "rclastsession": "{!rclastsession}",

            "rclastsessiondate": "{!rclastsessiondate}",

            "correo electrónico": "{!correo electrónico}",

            "userId": "{!userId}",

            "firstName": "{!firstName}",

            "lastName": "{!lastName}",

            "localeDefault": "{!localeDefault}",

            "id": "{!id}",

            "accountId": "{!accountId}",

            "accountName": "{!accountName}",

            "dataEntityId": "{!dataEntityId}",

            "createdBy": "{!createdBy}",

            "createdIn": "{!createdIn}",

            "updatedBy": "{!updatedBy}",

            "updatedIn": "{!updatedIn}",

            "lastInteractionBy": "{!lastInteractionBy}",

            "lastInteractionIn": "{!lastInteractionIn}"

            }
        • En Acción de respuesta:
          • Entidad de datos - Cliente [Customer]
          • Parámetros: Nombre - Anexo [Attachment]
      • Haz clic en la pestaña Si es negativo
        • No se necesitan cambios aquí
        • Haz clic en Guardar

Sincronización del cliente (opcional)

Esta integración sincroniza todos los datos de clientes existentes de VTEX con ActiveCampaign, incluido el campo "accepts_marketing".

Antes de continuar con esta sincronización, asegúrate de que las automatizaciones, como los correos electrónicos de la serie de bienvenida, estén desactivadas en ActiveCampaign. Para obtener información sobre cómo desactivar las automatizaciones, consulta el artículo "Cómo configurar las automatizaciones como 'inactivas' en ActiveCampaign".

Esta configuración se realiza en la cuenta de VTEX.

  1. Haz clic en ActiveCampaign > Sincronización de clientes.
  2. Después de cargar la página, haz clic en Sincronizar clientes.
  3. Luego de confirmar que las automatizaciones están deshabilitadas en ActiveCampaign, haz clic en Continuar sincronización.

Aparecerá el mensaje "La sincronización de clientes ha comenzado" en la página.

Sincronización de pedidos (opcional)

Esto sincroniza todos los datos históricos de pedidos de VTEX con ActiveCampaign. Antes de continuar con esta sincronización, asegúrate de que las automatizaciones estén desactivadas en ActiveCampaign.

Esta configuración se realiza en la cuenta de VTEX.

  1. Haz clic en ActiveCampaign > Sincronización de pedidos.
  2. Después de confirmar que las automatizaciones están deshabilitadas en ActiveCampaign, haz clic en Sincronizar todos los pedidos.
  3. Aparecerá un cuadro de diálogo donde puedes seleccionar la fecha en el calendario que deseas usar como fecha de inicio de sincronización. Por ejemplo, quizás solo quieres sincronizar los últimos seis meses de datos en lugar de todos los pedidos históricos realizados.
    VTEX_dialogue_box.jpeg
  4. Haz clic en Continuar sincronización.
  5. Aparecerá el mensaje "La sincronización de pedidos ha comenzado" en la página.
    • Se sincronizarán los pedidos realizados a partir de la fecha de inicio hasta la fecha actual.
    • Se sincronizarán aproximadamente 1000 a 1500 datos de pedidos por hora en ActiveCampaign

Además de sincronizar todos los pedidos, puedes elegir sincronizar pedidos individuales de forma manual. Para ello:

  1. Introduce el ID del pedido que quieres sincronizar en el cuadro de búsqueda situado en la parte superior de la página y, a continuación , haz clic en Intro.
  2. Haz clic en la casilla de verificación junto al pedido que deseas sincronizar.
  3. Después de confirmar que las automatizaciones están deshabilitadas en ActiveCampaign, haz clic en Sincronizar pedidos seleccionados.

Aparecerá el mensaje "La sincronización de pedidos ha comenzado".

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 2 de 2

¿Tienes más preguntas? Envía una solicitud

Start free trial