Эта страница переведена с помощью Cloud Translation API.

Теги универсальной аналитики

Чтобы внести изменения во время выполнения вашей реализации Google Analytics, которые не требуют пересборки и повторной отправки двоичного файла вашего приложения на рынки, внедрите Universal Analytics (UA) в свое приложение с помощью Диспетчера тегов Google (GTM).

В этом руководстве показано, как использовать теги Universal Analytics и Google Tag Manager SDK для iOS, чтобы:

Отправка просмотров экрана .
Отправлять события .
Отправляйте транзакции электронной торговли .
Отправляйте расширенные данные электронной торговли .

Отправить просмотры экрана

Чтобы отправлять вид экрана каждый раз, когда в вашем приложении открывается новый экран, в Google Analytics:

Создайте переменную имени экрана .
Создайте триггер события открытого экрана .
Создайте тег просмотра экрана Universal Analytics .
Перенесите событие открытия экрана и имя экрана на уровень данных .

1. Создайте переменную имени экрана.

Чтобы создать переменную имени экрана в GTM:

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Переменные .
В разделе «Пользовательские переменные» нажмите «Создать» .
Нажмите «Переменная без названия» , чтобы ввести экранное имя имени переменной.
Выберите «Переменная уровня данных» в качестве типа переменной.
Введите screenName в качестве имени переменной уровня данных и установите значение по умолчанию неизвестного экрана .
См. снимок экрана с созданием переменной имени экрана.
Нажмите Создать переменную .

2. Создайте триггер события открытого экрана.

Чтобы создать в GTM триггер для активации тега просмотра экрана Universal Analytics :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Триггеры .
Нажмите Создать.
Нажмите Триггер без названия , чтобы ввести имя триггера OpenScreenEvent .
Выберите Пользовательское событие.
В разделе «Пожар включен» введите следующее условие:
Нажмите «Создать триггер» .

3. Создайте тег просмотра экрана Universal Analytics.

Чтобы создать тег просмотра экрана Universal Analytics, активируемый событием открытия экрана :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Теги .
Нажмите Создать.
Нажмите «Тег без названия» , чтобы ввести имя тега «Открыть экран» .
Выберите продукт Google Analytics .
Введите идентификатор отслеживания.
Выберите «Просмотр приложения» в качестве типа отслеживания .
Нажмите Дополнительные настройки .
Нажмите «Поля для установки» .
Несколько раз нажмите + Добавить поле , чтобы добавить следующие поля:
Нажмите Продолжить .
В разделе «Включить огонь» нажмите «Пользовательский» .
Выберите пользовательский триггер OpenScreenEvent .
Нажмите Сохранить .
Нажмите «Создать тег» .

4. Перенесите событие открытия экрана и имя экрана на уровень данных.

Добавьте в свое приложение код, чтобы передать событие openScreen и значение screenName на уровень данных, например:

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

Отправить события

Чтобы отправить событие в Google Analytics, когда пользователь взаимодействует с элементами управления пользовательского интерфейса или контентом в вашем приложении:

(Необязательно) Создайте переменные событий .
Создайте триггер события .
Создайте тег события Universal Analytics .
Перенесите событие и значение переменной события на уровень данных .

Следующие шаги показывают, как событие отправляется в Google Analytics, когда пользователь начинает воспроизведение видео.

1. (Необязательно) Создайте переменные событий.

Если событие использует переменные уровня данных для представления полей категории, действия, метки или значения, сначала необходимо создать эти переменные. В этом примере тег события воспроизведения видео использует переменную уровня данных для получения названия видео.

Чтобы создать переменную имени видео в GTM:

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Переменные .
В разделе «Пользовательские переменные» нажмите «Создать» .
Нажмите «Переменная без названия» , чтобы ввести имя переменной «имя видео» .
Выберите «Переменная уровня данных» в качестве типа переменной.
Введите videoName в качестве имени переменной уровня данных и установите для нее значение по умолчанию — неизвестное видео .
См. снимок экрана с созданием переменной имени видео.
Нажмите Создать переменную .

2. Создайте триггер события

Чтобы создать триггер события в GTM для активации тега события Universal Analytics :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Триггеры .
Нажмите Создать.
Нажмите «Триггер без названия» , чтобы ввести имя триггера VideoPlayEvent .
Выберите Пользовательское событие.
В разделе «Пожар включен» введите следующее условие:
Нажмите «Создать триггер» .

3. Создайте тег события Universal Analytics.

Чтобы создать тег события Universal Analytics, активируемый событием воспроизведения видео :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Теги .
Нажмите Создать.
Нажмите «Тег без названия» , чтобы ввести имя тега «Событие воспроизведения видео» .
Выберите продукт Google Analytics .
Введите идентификатор отслеживания.
Выберите «Событие» в качестве типа трека .
Введите следующие параметры отслеживания событий:
Нажмите Дополнительные настройки .
Нажмите «Поля для установки» .
Несколько раз нажмите + Добавить поле , чтобы добавить следующие поля:
Нажмите Продолжить .
В разделе «Включить огонь» нажмите «Пользовательский» .
Выберите пользовательский триггер VideoPlayEvent .
Нажмите Сохранить .
Нажмите «Создать тег» .

4. Перенесите событие и значение переменной события на уровень данных.

Напишите код для передачи события videoPlay и значения videoName на уровень данных, например:

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

Отправка транзакций электронной торговли

Когда пользователь совершает покупку в приложении, чтобы отправить транзакцию и связанные с ней элементы в Google Analytics:

Создайте триггер транзакции .
Создайте тег транзакции Universal Analytics .
Отправьте событие транзакции, транзакцию и элементы на уровень данных .

Список поддерживаемых имен переменных транзакций и товаров см. в разделе Поддерживаемые переменные уровня данных электронной торговли .

1. Создайте триггер транзакции

Чтобы создать триггер транзакции в GTM для активации тега транзакции Universal Analytics :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Триггеры .
Нажмите Создать.
Нажмите Триггер без названия , чтобы ввести имя триггера TransactionCompleted .
Выберите Пользовательское событие.
В разделе «Пожар включен» введите следующее условие:
Нажмите «Создать триггер» .

2. Создайте тег транзакции Universal Analytics.

Чтобы создать тег транзакции Universal Analytics, активируемый событием транзакции :

Войдите в свою учетную запись Диспетчера тегов Google .
Выберите мобильный контейнер.
На левой панели навигации нажмите Теги .
Нажмите Создать.
Нажмите «Тег без названия» , чтобы ввести имя тега «Транзакция завершена» .
Выберите продукт Google Analytics .
Введите идентификатор отслеживания.
Выберите «Транзакция» в качестве типа отслеживания .
Нажмите Дополнительные настройки .
Нажмите «Поля для установки» .
Несколько раз нажмите + Добавить поле , чтобы добавить следующие поля:
Нажмите Продолжить .
В разделе «Включить огонь» нажмите «Пользовательский» .
Выберите пользовательский триггер TransactionCompleted .
Нажмите Сохранить .
Нажмите «Создать тег» .

3. Перенесите событие транзакции, транзакцию и элементы на уровень данных.

Напишите код для передачи события транзакции, транзакции и связанных элементов на уровень данных. Вы должны использовать поддерживаемые имена переменных транзакций и элементов для передачи данных транзакций и элементов на уровень данных. Например:

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