Puedes invocar comandos gtag() desde cualquier lugar de una página, después del fragmento global.
Hay tres comandos disponibles en gtag(): config y set se usan para definir las propiedades generales, y event se usa para enviar datos.
Inicializar productos con config
Usa el comando config para inicializar y configurar los ajustes de una cuenta de producto concreta. El comando config tiene el siguiente formato:
gtag('config', '<TARGET_ID>', {<additional_config_info>});
En la línea de código anterior, <TARGET_ID> es el ID de la cuenta de producto a la que quieres enviar datos y <additional_config_info> es un objeto opcional con el que se pueden especificar opciones de configuración adicionales.
El comando config te permite especificar qué productos y cuentas debe gestionar gtag.js, así como la configuración asociada. En función del producto que se haya especificado en target_ID, el comando config iniciará un comportamiento específico para ese producto. Por ejemplo, en algunos casos, el comando config indica a gtag.js que inicie un hit de páginas vistas. Para obtener más información sobre el comportamiento del comando config en relación con un producto concreto, consulta la documentación del producto correspondiente:
- Google Ads: conversiones y remarketing
- Campaign Manager y Display & Video 360
- Search Ads 360
- Google Analytics
El ejemplo más básico de este comando solo incluye el comando config y un target_ID:
gtag('config', 'G-XXXXXX');
Para ajustar y ampliar un comando config, especifica parámetros en el objeto opcional <additional_config_info>. Por ejemplo, si añades el siguiente parámetro, impedirás que se envíen automáticamente los hits de páginas vistas de Google Analytics:
gtag('config', 'G-XXXXXX', {'send_page_view': false});
Enviar datos con event
El comando event permite enviar datos de eventos. Por ejemplo, puedes usar el comando event para enviar un evento login con el valor "Google" en method:
gtag('event', 'login', {
'method': 'Google'
});
Hay un conjunto de eventos recomendados y parámetros recomendados que son útiles en contextos específicos. También puedes enviar eventos personalizados que no están incluidos en la lista de eventos recomendados.
Enviar datos para cada evento con set
El comando set te permite establecer los parámetros que se asociarán a eventos concretos cada vez que se activen en la página. Por ejemplo, si se usa la misma moneda en todas las transacciones de tu sitio web, puedes utilizar el comando set para especificar el campo currency:
gtag('set', {'currency': 'USD'});
Puedes definir varios atributos con un único comando set:
gtag('set', {
'country': 'US',
'currency': 'USD'
});