Комплект SDK для iOS

Текущая версия iOS SDK 3.5.3.

Комплект MobileAppTracking™ (MAT) SDK для платформы iOS предоставляет функционал регистрации сеансов и событий в приложении. MAT SDK для iOS поставляется в формате фреймворка, который просто включается в ваш проект iOS. Комплект совместим с iPhone, iPad и iPod Touch, а также с проектами с Automatic Reference Counting (ARC) и без ARC на iOS версий 5.0 и выше. Чтобы начать отслеживать сеансы и события, произведите интеграцию MAT SDK для iOS в ваше мобильное приложение. После запуска метода “measureSession" MAT начнет запись событий, (например, покупок, уровней в игре и других показателей вовлечения пользователей). Руководство по быстрому старту позволит вам начать пользоваться MAT SDK в самые короткие сроки. Если вы обновляете ваше приложение с версии MAT SDK 2.x до 3.x, обязательно прочтите статью-руководство. Если вы используете MAT SDK для приложений iOS, написанных на языке Swift с Xcode 6.0, перейдите в раздел Использование SDK MAT iOS Objective-C в проектах на Swift.

Загрузка SDK

Прежде чем загружать MAT SDK, добавьте свое приложение на платформу MAT, следуя инструкциям раздела Как скачать нужный комплект SDK. После этого вам нужно будет либо скачать и установить SDK самостоятельно, либо установитьMobileAppTracker CocoaPod.

Внедрение

  1. Разархивируйте и скопируйте папку MobileAppTracker.framework в дерево исходного кода.
  2. Добавьте MobileAppTracker.framework в ваш проект Xcode®. Для этого нажмите на название проекта в верхней части Project Navigator.
    1. На вкладке General (Базовые настройки) прокрутите экран вниз до пункта Linked Frameworks and Libraries (фреймворки и библиотеки).
    2. Чтобы добавить новый фреймворк, нажмите на значок +, а затем Add Other… (Другое).
    3. Найдите папку MobileAppTracker.framework и нажмите Open (Открыть).

    ios_sdk_russian.png

  3. Добавьте в ваш проект следующие дополнительные фреймворки:
    • AdSupport.framework
    • CoreTelephony.framework
    • iAd.framework
    • MobileCoreServices.framework
    • SystemConfiguration.framework

Добавив свое мобильное приложение на платформу, вы сможете в любой момент скачать SDK через раздел Mobile Apps(Мобильные приложения), нажав на кнопку Download SDK (Скачать SDK) и выбрав свое приложение через раскрывающееся меню.

Внедрение

Импортируйте MobileAppTracker в AppDelegate.m и запустите.

#import &MobileAppTracker/MobileAppTracker.h&
#import &AdSupport/AdSupport.h&
 
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Account Configuration info - must be set
    [MobileAppTracker initializeWithMATAdvertiserId:@"your_advertiser_ID"
                                   MATConversionKey:@"your_conversion_key"];
 
    // Pass the Apple Identifier for Advertisers (IFA) to MAT; enables accurate 1-to-1 attribution.
    // REQUIRED for attribution on iOS devices.
    [MobileAppTracker setAppleAdvertisingIdentifier:[[ASIdentifierManager sharedManager] advertisingIdentifier]
                         advertisingTrackingEnabled:[[ASIdentifierManager sharedManager] isAdvertisingTrackingEnabled]];
 
    // If your app already has a pre-existing user base before you implement the MAT SDK, then
    // identify the pre-existing users with this code snippet.
    // Otherwise, MAT counts your pre-existing users as new installs the first time they run your app.
    // Omit this section if you're upgrading to a newer version of the MAT SDK.
    // This section only applies to NEW implementations of the MAT SDK.
    //BOOL isExistingUser = ...
    //if (isExistingUser) {
    //    [MobileAppTracker setExistingUser:YES];
    //}
 
    return YES;
}
 
- (void)applicationDidBecomeActive:(UIApplication *)application
{
    // MAT will not function without the measureSession call included
    [MobileAppTracker measureSession];
}
 
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    [MobileAppTracker applicationDidOpenURL:[url absoluteString] sourceApplication:sourceApplication];
 
    return YES;
}

Важно!

Значения your_advertiser_ID и your_conversion_key соответствуют параметрам Advertiser ID (идентификатор рекламодателя) и Conversion Key (ключ преобразования), которые предоставляет платформа MAT при создании на платформе записи мобильного приложения. Чтобы получить информацию об этих параметрах, перейдите в раздел Как найти идентификатор рекламодателя и ключ преобразования.

Если у вашего приложения уже есть пользовательская база (то есть его уже устанавливали), а вы решили использовать MAT SDK, то MAT будет принимать существующих пользователей за новые установки, потому что платформа не может определить, какие пользователи новые, а какие нет. Чтобы определить существующих пользователей для MAT, задайте для них параметр setExistingUser:TRUE, прежде чем использовать measureSession. Информацию по переносу существующих пользователей перед внедрением SDK вы найдете в соответствующем разделе.

Для повышения точности и упрощения атрибуции вы можете собирать идентификаторы устройств, как описано в разделе Уникальные идентификаторы для атрибуции.

Проверить работу MAT SDK в вашем мобильном приложении можно сразу через MAT, без создания тестовой среды. См. раздел Тестирование вашего мобильного приложения.

Отслеживание событий

    Внедрив MAT SDK в свое мобильное приложение и начав записывать сеансы, вы можете перейти и к записи других событий в приложении, например регистраций и встроенных покупок. Записывая и анализируя события внутри приложения, вы сможете оптимизировать как функционал самого приложения, так и свою рекламную стратегию. Короче говоря, отслеживать события внутри приложения и понимать принцип взаимодействия с ним пользователя очень важно, чтобы давать эффективную и окупаемую рекламу. Главным образом, за счет вашей возможности сопоставлять полученные ретенцию, вовлечение и «срок жизни» пользователя с потраченными на это средствами. У каждого приложения свои важные события. Вот самые распространенные.
  • Авторизация и создание аккаунта
    • Login (Вход), Registration (Регистрация)
  • Электронные продажи
    • Add to Cart (Добавить в корзину), Add to Wishlist (Добавить в список желаний), Added Payment Info (Добавление платежных данных), Checkout Initiated (Идет завершение заказа), Purchase (Покупка), Reservation (Бронь), Spent Credits (Трата валюты)
  • Игровые
    • Achievement Unlocked (Новое достижение), Level Achieved (Новый уровень), Tutorial Complete (Обучение пройдено)
  • Использование, оценки и публикации
    • Content View (Просмотр материала), Invite (Приглашение), Rated (Оценка), Search (Поиск), Share (Публикация)

Хотите узнать больше? Тогда перейдите в раздел Какие события в приложении стоит отслеживать и почемуУже готовы действовать? Документация SDK по событиям находится здесь

Видеоинструкция по быстрому старту

события внутри приложения