Обзор
Класс верхнего уровня Google Analytics для iOS.
Предоставляет возможности для создания трекеров и установки поведенческих флагов.
Наследует NSObject.
Методы экземпляра | |
| (id <GAITracker> ) | - trackerWithName:trackingId: |
| Создает или получает реализацию GAITracker с указанным именем и идентификатором отслеживания. Более... | |
| (id <GAITracker> ) | - trackerWithTrackingId: |
| Создает или получает реализацию GAITracker с именем, равным указанному идентификатору отслеживания. Более... | |
| (пустота) | - RemoveTrackerByName: |
| Удалить трекер из словаря трекеров. Более... | |
| (пустота) | - отправлять |
| Отправляет любую ожидающую информацию для отслеживания. Более... | |
| (пустота) | - отправкаWithCompletionHandler: |
| Отправляет следующий маяк отслеживания в очереди, вызывая завершениеHandler, когда маяк отслеживания был отправлен (возвращается kGAIDispatchGood) или возникла ошибка (возвращается kGAIDispatchError). Более... | |
Методы класса | |
| ( ГАИ *) | + общий экземпляр |
| Получите общий экземпляр класса Google Analytics для iOS. Более... | |
Характеристики | |
| id <GAITracker> | defaultTracker |
| Для удобства этот класс предоставляет экземпляр трекера по умолчанию. Более... | |
| идентификатор < GAILogger > | лесоруб |
| Используемый GAILogger . Более... | |
| БООЛ | уклоняться |
| Если это так, информация отслеживания собираться не будет; отслеживание звонков фактически станет бесполезным. Более... | |
| НСтимеинтервал | диспетчерский интервал |
| Если это значение положительное, информация отслеживания будет автоматически отправляться каждые секунды диспетчеризации. Более... | |
| БООЛ | trackUncaughtExceptions |
| Если установлено значение true, SDK запишет текущий зарегистрированный обработчик неперехваченных исключений, а затем зарегистрирует обработчик неперехваченных исключений, который отслеживает возникшие исключения с помощью defaultTracker. Более... | |
| БООЛ | пробный прогон |
| Если это «ДА», информация об отслеживании отправляться не будет. Более... | |
Документация метода
| + ( ГАИ *) общий экземпляр |
Получите общий экземпляр класса Google Analytics для iOS.
| - (id <GAITracker> ) trackerWithName: | (НСтрока *) | имя | |
| Идентификатор отслеживания: | (НСтрока *) | Идентификатор отслеживания | |
Создает или получает реализацию GAITracker с указанным именем и идентификатором отслеживания.
Если трекера с указанным именем еще не существует, то он будет создан и возвращен; в противном случае будет возвращен существующий трекер. Если существующий трекер для соответствующего имени имеет другой идентификатор отслеживания, этот идентификатор не изменяется с помощью этого метода. Если defaultTracker не установлен, он будет установлен на возвращаемый здесь экземпляр трекера.
- Параметры
имя Название этого трекера. Не должно быть nilили пустым.Идентификатор отслеживания Идентификатор отслеживания, который будет использоваться для этого трекера. Он должен иметь вид UA-xxxxx-y.
- Возврат
- GAItracker, связанный с указанным именем. Трекер можно использовать для отправки данных отслеживания в Google Analytics. При первом вызове этого метода с определенным именем будет возвращен трекер для этого имени, а последующие вызовы с тем же именем вернут тот же экземпляр. Сохранять трекер не обязательно, поскольку он будет храниться внутри библиотеки.
Если произойдет ошибка или имя недопустимо, этот метод вернет nil .
| - (id <GAITracker> ) trackerWithTrackingId: | (НСтрока *) | Идентификатор отслеживания |
Создает или получает реализацию GAITracker с именем, равным указанному идентификатору отслеживания.
Если средство отслеживания для соответствующего имени еще не существует, оно создается, для его идентификатора отслеживания устанавливается значение |trackingId|, и оно возвращается; в противном случае возвращается существующий трекер. Если существующий трекер для соответствующего имени имеет другой идентификатор отслеживания, этот идентификатор не изменяется с помощью этого метода. Если defaultTracker не установлен, он устанавливается на возвращаемый здесь экземпляр трекера.
- Параметры
Идентификатор отслеживания Идентификатор отслеживания, который будет использоваться для этого трекера. Он должен иметь вид UA-xxxxx-y. Имя трекера будет таким же, как и TrackID.
- Возврат
- GAItracker, связанный с указанным идентификатором отслеживания. Трекер можно использовать для отправки данных отслеживания в Google Analytics. При первом вызове этого метода с определенным идентификатором отслеживания будет возвращен трекер для соответствующего имени, а последующие вызовы с тем же идентификатором отслеживания вернут тот же экземпляр. Сохранять трекер не обязательно, поскольку он будет храниться внутри библиотеки.
Если произойдет ошибка или идентификатор отслеживания недействителен, этот метод вернет nil .
| - (void) RemoveTrackerByName: | (НСтрока *) | имя |
Удалить трекер из словаря трекеров.
Если это трекер по умолчанию, также очищается трекер по умолчанию.
- Параметры
имя Имя трекера.
| - (недействительная) отправка |
Отправляет любую ожидающую информацию для отслеживания.
Обратите внимание, что это не влияет на диспетчерский интервал и может использоваться в сочетании с периодической отправкой.
| - (недействительно) диспетчеризацияWithCompletionHandler: | (void(^)(результат GAIDispatchResult)) | Обработчик завершения |
Отправляет следующий маяк отслеживания в очереди, вызывая завершениеHandler, когда маяк отслеживания был отправлен (возвращается kGAIDispatchGood) или возникла ошибка (возвращается kGAIDispatchError).
Если нет сетевого подключения или нет данных для отправки, возвращается kGAIDispatchNoData.
Обратите внимание, что вызов этого метода с ненулевым завершениемHandler отключает периодическую отправку. Периодическую отправку можно снова включить, установив для параметра sendInterval положительное число, когда приложение возобновляет работу в фоновом режиме.
Вызов этого метода с нулевым завершениемHandler аналогичен вызову диспетчеризации выше.
Этот метод можно использовать для фоновой выборки данных в iOS 7.0 или более поздних версиях. Было бы разумно вызвать это при выходе приложения, чтобы инициировать отправку любой неотправленной информации отслеживания.
- Параметры
Обработчик завершения Блок, запускаемый после одного запроса на отправку. Параметр GAIDispatchResult указывает, была ли отправка успешной, произошла ли ошибка или не было обращений для отправки.
Документация на недвижимость
| (чтение, запись, неатомарность, назначение) |
Для удобства этот класс предоставляет экземпляр трекера по умолчанию.
Он инициализируется равным nil и будет установлен для первого средства отслеживания, экземпляр которого создается в trackerWithTrackingId:. При желании его можно переопределить.
Класс GAITrackedViewController по умолчанию будет использовать этот экземпляр трекера.
| (чтение, запись, неатомарность, назначение) |
Если это так, информация отслеживания собираться не будет; отслеживание звонков фактически станет бесполезным.
Если установлено значение true, вся информация, ожидающая загрузки, будет удалена. Значение этого флага будет автоматически сохранено SDK. Разработчики могут дополнительно использовать этот флаг, чтобы реализовать в приложении настройку отказа, позволяющую пользователям отказаться от отслеживания Google Analytics.
При первом использовании Google Analytics SDK на устройстве для этого параметра устанавливается значение NO , и после этого оно сохраняется.
| (чтение, запись, неатомарность, назначение) |
Если это значение положительное, информация отслеживания будет автоматически отправляться каждые секунды диспетчеризации.
В противном случае информацию об отслеживании необходимо отправить вручную, вызвав диспетчерскую.
По умолчанию для него установлено значение 120 , что означает, что информация отслеживания должна отправляться автоматически каждые 120 секунд.
| (чтение, запись, неатомарность, назначение) |
Если установлено значение true, SDK запишет текущий зарегистрированный обработчик неперехваченных исключений, а затем зарегистрирует обработчик неперехваченных исключений, который отслеживает возникшие исключения с помощью defaultTracker.
Если defaultTracker не nil , эта функция будет отслеживать исключение на трекере и пытаться отправить всю оставшуюся информацию отслеживания в течение 5 секунд. Затем он вызовет ранее зарегистрированный обработчик исключений, если таковой имеется. Если установить обратное значение false, будет восстановлен ранее зарегистрированный обработчик неперехваченных исключений.
| (чтение, запись, неатомарность, назначение) |
Если это «ДА», информация об отслеживании отправляться не будет.
По умолчанию «НЕТ».