US English (US)
ES Spanish

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
Spanish
US English (US)
ES Spanish
  • Docs home
  • Instalación y desarrolladores
  • Instalación Appcues en la Web

Instalación con Google Tag Manager (desarrollador)

Aprenda a utilizar Google Tag Manager para instalar Appcues rápidamente y sin ningún código nuevo.

Updated at August 1st, 2025

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Home

  • Instalación y desarrolladores

    • Experiencias web

      • Experiencias móviles

        • Flujos de trabajo

          • Análisis y datos

            • Gestión de cuentas

              • Mejores prácticas

                • Integraciones

                  Usar Google Tag Manager para instalar Appcues puede ser una forma rápida y sencilla de empezar a usar Appcues sin tener que enviar código nuevo. Empezar es bastante sencillo. Hay dos o tres cosas que debemos hacer:

                  1. Cargue el SDK de Javascript Appcues en la página.
                  2. Asegúrese de que se llame Appcues () .
                  3. Para aplicaciones de una sola página , asegúrese de que los cambios de página se rastrean adecuadamente a través de Appcues .page() o detección automática.
                  4. Opcionalmente, agregue una etiqueta para Appcues .group().

                  Cargando recursos Appcues en la página

                  Estos dos primeros pasos son bastante sencillos. Se debe cargar el script Appcues y llamar a `.identify()` Appcues cada vez que se cargue la página. Insertaremos la siguiente línea en una etiqueta (sustituyendo el ID de tu cuenta por `<YOUR_ACCOUNT_ID>`):

                  <script src="//fast.appcues.com/YOUR_ACCOUNT_ID.js"></script>

                  Identificación de sus usuarios

                  Appcues depende de la llamada Appcues ()` para pasar un ID de usuario y otras propiedades al comprobar si se muestra contenido en una página. Puedes añadir esta llamada a otra etiqueta. Si solo estás probando Appcues , puedes codificar estos valores, por ejemplo, añadiendo lo siguiente al Administrador de etiquetas:

                  <script>   
                      Appcues.identify('testUserId', {userName: 'Test Testerson', email: 'test@test.com'});
                  </script>

                  Esto significa que todos los usuarios tendrán el mismo ID de usuario y no habrá forma de diferenciarlos, por lo que, para una implementación completa, deberá enviar un ID de usuario real. Aunque el ID de usuario es la única información de usuario necesaria para que Appcues funcione, también es recomendable enviar algunas propiedades de usuario adicionales. Para ello a través de Tag Manager, deberá aprovechar las variables de Tag Manager (consulte aquí ) y pasarlas a la llamada de identificación:

                  <script>   
                      Appcues.identify(<USER_ID_VARIABLE>, {<USER_PROPERTY_VARIABLES>});
                  </script>

                  Seguimiento de cambios en la página

                  Para aplicaciones de página única, deberá detectar automáticamente los cambios de página o realizar una llamada Appcues .page() para cualquier cambio de URL.

                  Esto significa que cuando la URL cambia sin provocar una carga completa de la página, Appcues aún sabrá que el usuario está en una página nueva y deberá buscar contenido nuevo para mostrar.

                  Ejemplo de uso de Appcues .page():

                  Ejemplo de uso de detección automática:

                  <script type="text/javascript">
                    window.AppcuesSettings = {
                      enableURLDetection: true
                    };
                  </script>
                  <script src="//fast.appcues.com/YOUR_ACCOUNT_ID.js"></script>

                  Agregar una etiqueta para Appcues .group()

                  Las propiedades del grupo describen la cuenta en la que el usuario está activo actualmente; datos como el nombre de la empresa, el administrador de la cuenta, el nivel del plan, el MRR, las opciones de funciones, el sector y muchos más. Esta información se puede enviar mediante Appcues .group() . Un usuario puede pertenecer a varios grupos, pero solo se puede identificar uno a la vez. Solo se considerará para la segmentación el grupo asociado más recientemente con el usuario.

                  Similar a Appcues .identify(), se requiere un ID de grupo único y se aplican las mismas restricciones de formato.

                  Ejemplo:

                  <script>
                      Appcues.group("6789", {company_name: "Lendi Global",plan: "enterprise",employee_count: 12000,trial: false});
                  </script>

                  ¡Y eso debería bastar! Para probar la instalación después de publicarla, inicia sesión en tu sitio, abre la consola del navegador e introduce

                  Appcues.debug()

                  Esto le proporcionará información de diagnóstico sobre la configuración de Appcues y los datos que se envían. Consulte nuestra documentación de depuración para obtener más detalles sobre esta función. Para obtener más información sobre la instalación estándar de Appcues , consulte nuestra descripción general de la instalación.

                  Instalación asincrónica Appcues

                  Una forma de instalar Appcues de forma asíncrona mediante GTM es con dos etiquetas independientes. La primera debe configurarse para que se active mediante uno de los activadores estándar de GTM, como Vista de página o Ventana cargada. La segunda debe configurarse para que se active con el evento personalizado añadido a la capa de datos de GTM en la Etiqueta 1.

                  Etiqueta 1:

                  <script>
                  function loadScript( url, callback ) {
                    var script = document.createElement( "script" )
                    script.type = "text/javascript";
                    if(script.readyState) {
                      script.onreadystatechange = function() {
                        if ( script.readyState === "loaded" || script.readyState === "complete" ) {
                          script.onreadystatechange = null;
                          callback();
                        }
                      };
                    } else {  //Others
                      script.onload = function() {
                        callback();
                      };
                    }
                  
                    script.src = url;
                    document.getElementsByTagName( "head" )[0].appendChild( script );
                  }
                  
                  loadScript('//fast.appcues.com/YOUR_ACCOUNT_ID.js', function() {
                    dataLayer.push({'event': 'AppcuesLoaded'});
                  });
                  </script>

                  Etiqueta 2:

                  <script type='text/javascript'>
                    Appcues.identify('some_test_user'); 
                  </script>

                  Nota : Aunque las etiquetas GTM se activan en secuencia, su código se ejecuta de forma asíncrona. Esto significa que deberá asegurarse de que la etiqueta del fragmento de script del SDK esté completamente cargada antes de realizar cualquier llamada a la API de Appcues , como Appcues (). Esto generalmente se puede lograr configurando la etiqueta del script del SDK para que se active al ver la página y la etiqueta de identificación para que se active al cargar la ventana. Si desea usar el mismo activador GTM para ambas etiquetas, le recomendamos instalar Appcues de forma asíncrona.

                  Was this article helpful?

                  Yes
                  No
                  Give feedback about this article

                  Related Articles

                  • Guía de instalación para desarrolladores
                  • Instalación con Segment
                  • Guía de aplicaciones de una sola página ( SPA ) (para desarrolladores)
                  • Instalación asincrónica Appcues (desarrollador)
                  • Aloje el SDK Appcues en su propio dominio
                  Appcues logo

                  Product

                  Why Appcues How it works Integrations Security Pricing What's new

                  Use cases

                  Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

                  Company

                  About
                  Careers

                  Support

                  Developer Docs Contact

                  Resources

                  The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues Appcues University

                  Follow us

                  Facebook icon Twitter icon grey Linkedin icon Instagram icon
                  © 2022 Appcues. All rights reserved.
                  Security Terms of Service Privacy Policy

                  Knowledge Base Software powered by Helpjuice

                  Expand