Etiquetas de Universal Analytics

Para permitir que se hagan cambios durante el tiempo en ejecución de tu implementación de Google Analytics sin necesidad de volver a compilar y enviar el código binario de tu aplicación a los mercados, implementa Universal Analytics (UA) en tu aplicación con Google Tag Manager.

En esta guía se explica cómo usar etiquetas de Universal Analytics y el SDK de Tag Manager en iOS para:

Enviar visitas a una pantalla

Para enviar a Google Analytics una visita a una pantalla cada vez que se abre una nueva pantalla en tu aplicación, haz lo siguiente:

  1. Crea una variable de nombre de pantalla.
  2. Crea un activador de evento de pantalla abierta.
  3. Crea una etiqueta de Universal Analytics de visita a una pantalla.
  4. Envía el evento de pantalla abierta y el nombre de la pantalla a la capa de datos.

1. Crea una variable de nombre de pantalla

Para crear una variable de nombre de pantalla en GTM:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de la izquierda, haz clic en Variables.
  4. En Variables definidas por el usuario, haz clic en Nueva.
  5. Haz clic en Variable sin título para introducir el nombre de variable screen name.
  6. Selecciona el tipo de variable Variable de capa de datos.
  7. Introduce screenName como Nombre de variable de capa de datos y asígnale el valor predeterminado unknown screen.
  8. Haz clic en Crear variable.

2. Crea un activador de evento de pantalla abierta

Para crear un activador en GTM que active la etiqueta de visita a una pantalla de Universal Analytics:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Activadores.
  4. Haz clic en Nuevo.
  5. Haz clic en Activador sin título e introduce el nombre OpenScreenEvent.
  6. Elige el evento Personalizado.
  7. En Activar, introduce la siguiente condición:

    Un activador que se iniciará cuando el evento sea openScreen

  8. Haz clic en Crear activador.

3. Crea una etiqueta de Universal Analytics de visita a una pantalla

Para crear una etiqueta de Universal Analytics de visita a una pantalla que se active con el evento de pantalla abierta:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Etiquetas.
  4. Haz clic en Nueva.
  5. Haz clic en Etiqueta sin título para introducir el nombre de etiqueta Open Screen.
  6. Elige el producto Google Analytics.
  7. Introduce el ID de seguimiento.
  8. Selecciona Vista de aplicación como Tipo de seguimiento.
  9. Haz clic en Más opciones.
  10. Haz clic en Campos para configurar.
  11. Haz clic en + Añadir campo para añadir cada uno de estos campos:

    Añade estos campos: nombre de la aplicación, versión de la aplicación y nombre de pantalla.

  12. Haz clic en Continuar.
  13. En Activar, haz clic en Personalizado.
  14. Selecciona el activador personalizado OpenScreenEvent.
  15. Haz clic en Guardar.
  16. Haz clic en Crear etiqueta.

4. Envía el evento de pantalla abierta y el nombre de la pantalla a la capa de datos

Añade código a tu aplicación para enviar un evento openScreen y un valor screenName a la capa de datos. Por ejemplo:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

Enviar eventos

Para enviar eventos a Google Analytics cuando los usuarios interactúen con los controles de IU o el contenido de tu aplicación, haz lo siguiente:

  1. Crea variables de evento (opcional).
  2. Crea un activador de evento.
  3. Crea una etiqueta de evento de Universal Analytics.
  4. Envía el evento y el valor de la variable de evento a la capa de datos.

Sigue los pasos que se indican a continuación para enviar un evento a Google Analytics cuando un usuario empiece a reproducir un vídeo.

1. Crea variables de evento (opcional)

Si el evento utiliza variables de la capa de datos para representar su categoría, su acción, su etiqueta o sus campos de valores, primero debes crear esas variables. En este ejemplo, la etiqueta de evento de reproducción de vídeo usa una variable de la capa de datos para obtener el nombre del vídeo.

Para crear una variable de nombre de vídeo en GTM:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de la izquierda, haz clic en Variables.
  4. En Variables definidas por el usuario, haz clic en Nueva.
  5. Haz clic en Variable sin título para introducir el nombre video name.
  6. Selecciona el tipo de variable Variable de capa de datos.
  7. Introduce videoName como Nombre de variable de capa de datos y asígnale el valor predeterminado unknown video.
  8. Haz clic en Crear variable.

2. Crea un activador de evento

Para crear un activador de evento en GTM que active la etiqueta de evento de Universal Analytics:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Activadores.
  4. Haz clic en Nuevo.
  5. Haz clic en Activador sin título e introduce el nombre VideoPlayEvent.
  6. Elige el evento Personalizado.
  7. En Activar, introduce la siguiente condición:

    Un activador que se iniciará cuando el evento sea videoPlay

  8. Haz clic en Crear activador.

3. Crea una etiqueta de evento de Universal Analytics

Para crear una etiqueta de evento de Universal Analytics que se active con evento de reproducción de vídeo:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Etiquetas.
  4. Haz clic en Nueva.
  5. Haz clic en Etiqueta sin título e introduce el nombre Video Play Event.
  6. Elige el producto Google Analytics.
  7. Introduce el ID de seguimiento.
  8. Selecciona Evento como Tipo de seguimiento.
  9. Introduce los siguientes parámetros de seguimiento de eventos:

    Introduce estos parámetros de seguimiento: Video en Categoría, Play en Acción y Video name en Etiqueta.

  10. Haz clic en Más opciones.
  11. Haz clic en Campos para configurar.
  12. Haz clic en + Añadir campo para añadir cada uno de estos campos:

    Añade estos campos: nombre de la aplicación, versión de la aplicación y nombre de pantalla.

  13. Haz clic en Continuar.
  14. En Activar, haz clic en Personalizado.
  15. Selecciona el activador personalizado VideoPlayEvent.
  16. Haz clic en Guardar.
  17. Haz clic en Crear etiqueta.

4. Envía el evento y el valor de la variable de evento a la capa de datos

Escribe código para enviar un evento videoPlay y un valor videoName a la capa de datos. Por ejemplo:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end


Enviar transacciones de comercio electrónico

Para enviar la transacción y los artículos asociados a Google Analytics cuando un usuario complete una compra en la aplicación:

  1. Crea un activador de transacción.
  2. Crea una etiqueta de transacción de Universal Analytics.
  3. Envía el evento de transacción, la transacción y los artículos a la capa de datos.

Consulta los nombres de variable de artículos y transacción que puedes usar en las variables de capa de datos de comercio electrónico admitidas.

1. Crea un activador de transacción

Para crear un activador de transacción en GTM que active la etiqueta de transacción de Universal Analytics:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Activadores.
  4. Haz clic en Nuevo.
  5. Haz clic en Activador sin título e introduce el nombre de activador TransactionCompleted.
  6. Elige el evento Personalizado.
  7. En Activar, introduce la siguiente condición:

    Un activador que se iniciará cuando el evento sea transaction

  8. Haz clic en Crear activador.

2. Crea una etiqueta de transacción de Universal Analytics

Para crear una etiqueta de transacción de Universal Analytics que se active con el evento de transacción:

  1. Inicia sesión en tu cuenta de Google Tag Manager.
  2. Selecciona un contenedor móvil.
  3. En la barra de navegación de la izquierda, haz clic en Etiquetas.
  4. Haz clic en Nueva.
  5. Haz clic en Etiqueta sin título e introduce el nombre Transaction Completed.
  6. Elige el producto Google Analytics.
  7. Introduce el ID de seguimiento.
  8. Selecciona Transacción como Tipo de seguimiento.
  9. Haz clic en Más opciones.
  10. Haz clic en Campos para configurar.
  11. Haz clic en + Añadir campo para añadir cada uno de estos campos:

    Añade estos campos: nombre de la aplicación, versión de la aplicación y nombre de pantalla.

  12. Haz clic en Continuar.
  13. En Activar, haz clic en Personalizado.
  14. Selecciona el activador personalizado TransactionCompleted.
  15. Haz clic en Guardar.
  16. Haz clic en Crear etiqueta.

3. Envía el evento de transacción, la transacción y los artículos a la capa de datos

Escribe código para enviar el evento de transacción, la transacción y los artículos asociados a la capa de datos. Debes usar los nombres de variables de artículo y transacción admitidos para enviar los datos de la transacción y los artículos a la capa de datos. Por ejemplo:

// Called when a user completes a transaction.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}

Para obtener más información sobre cómo usar el SDK de Google Tag Manager en Android para implementar las funciones de comercio electrónico mejorado de Universal Analytics, consulta esta página sobre comercio electrónico mejorado.

Variables de capa de datos de comercio electrónico admitidas

Las etiquetas de transacción universales admiten los siguientes nombres de variable de transacción y artículo.

Variables de transacción

Nombre de la variable Descripción Tipo Obligatorio
transactionId Identificador de transacción único cadena
transactionAffiliation Partner o tienda cadena No
transactionTotal Valor total de la transacción cadena No
transactionTax Impuestos correspondientes a la transacción cadena No
transactionShipping Gastos de envío de la transacción cadena No
transactionCurrency Moneda de la transacción cadena No
transactionProducts Lista de artículos comprados en la transacción matriz de variables de artículo No

Variables de artículo

Nombre de la variable Descripción Tipo Obligatorio
name Nombre del producto cadena
sku Código SKU de producto cadena No
category Categoría de producto cadena No
price Precio del producto cadena No
currency Tipo de moneda de price cadena No
quantity Cantidad de artículos cadena No

Enviar datos de comercio electrónico mejorado

Para obtener información sobre cómo enviar datos de comercio electrónico mejorado, consulta la guía de comercio electrónico mejorado para desarrolladores.