Universal Analytics Tags

To create a screen name variable in GTM:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Variables.
4. Under User-Defined Variables, click New.
5. Click Untitled Variable to enter the variable name screen name.
6. Choose Data Layer Variable as the variable type.
7. Enter screenName as the Data Layer Variable Name and set its default value unknown screen.

   See the screenshot of creating a screen name variable.

   

8. Click Create Variable.

To create a trigger in GTM to fire the Universal Analytics screen view tag:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Triggers.
4. Click New.
5. Click Untitled Trigger to enter the trigger name OpenScreenEvent.
6. Choose Custom event.
7. Under Fire On, enter the following condition:

   

8. Click Create Trigger.

To create a Universal Analytics screen view tag fired by the open screen event:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Tags.
4. Click New.
5. Click Untitled Tag to enter the tag name Open Screen.
6. Choose product Google Analytics.
7. Enter the tracking ID.
8. Select App View as the Track Type.
9. Click More settings.
10. Click Fields to Set.
11. Repeatedly click + Add Field to add the following fields:

    

12. Click Continue.
13. Under Fire On, click Custom.
14. Select the custom trigger OpenScreenEvent.
15. Click Save.
16. Click Create Tag.

Add code to your app to push an openScreen event and a screenName value to the data layer, for example:

//  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

If the event uses data layer variables to represent its category, action, label, or value fields, you must first create those variables. In this example, the video play event tag uses a data layer variable to get the name of the video.

To create a video name variable in GTM:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Variables.
4. Under User-Defined Variables, click New.
5. Click Untitled Variable to enter the variable name video name.
6. Choose Data Layer Variable as the variable type.
7. Enter videoName as the Data Layer Variable Name and set its default value to unknown video.

   See the screenshot of creating a video name variable.

   

8. Click Create Variable.

To create an event trigger in GTM to fire the Universal Analytics event tag:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Triggers.
4. Click New.
5. Click Untitled Trigger to enter the trigger name VideoPlayEvent.
6. Choose Custom event.
7. Under Fire On, enter the following condition:

   

8. Click Create Trigger.

To create a Universal Analytics event tag fired by the video play event:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Tags.
4. Click New.
5. Click Untitled Tag to enter the tag name Video Play Event.
6. Choose product Google Analytics.
7. Enter the tracking ID.
8. Select Event as the Track Type.
9. Enter the following event tracking parameters:

   

10. Click More settings.
11. Click Fields to Set.
12. Repeatedly click + Add Field to add the following fields:

    

13. Click Continue.
14. Under Fire On, click Custom.
15. Select the custom trigger VideoPlayEvent.
16. Click Save.
17. Click Create Tag.

Write code to push a videoPlay event and a videoName value to the data layer, for example:

//  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

To create transaction trigger in GTM to fire the Universal Analytics transaction tag:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Triggers.
4. Click New.
5. Click Untitled Trigger to enter the trigger name TransactionCompleted.
6. Choose Custom event.
7. Under Fire On, enter the following condition:

   

8. Click Create Trigger.

To create a Universal Analytics transaction tag fired by the transaction event:

1. Sign in to your Google Tag Manager account.
2. Select a mobile container.
3. On the left navigation bar, click Tags.
4. Click New.
5. Click Untitled Tag to enter the tag name Transaction Completed.
6. Choose product Google Analytics.
7. Enter the tracking ID.
8. Select Transaction as the Track Type.
9. Click More settings.
10. Click Fields to Set.
11. Repeatedly click + Add Field to add the following fields:

    

12. Click Continue.
13. Under Fire On, click Custom.
14. Select the custom trigger TransactionCompleted.
15. Click Save.
16. Click Create Tag.

Write code to push the transaction event, transaction and the associated items to the data layer. You must use the supported transaction and item variable names to push transaction and item data to the data layer. For example:

// 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]}];
}