OSCHINA-MIRROR/AdMaster-MMA_iOS

Интеграция MMA iOS SDK

Шаг 1: Добавление MMA iOS SDK в проект

Скопируйте файлы MobileTracking.h, libMobileTracking.a и sdkconfig.xml из каталога OutputRelease в проект.
Загрузите файл sdkconfig.xml на веб-сервер, чтобы он был доступен через URL, например, http://xxxxxx.com/sdkconfig.xml.
В настройках сборки проекта (Target Build Settings) добавьте абсолютный путь к статической библиотеке в поле Other Linker Flags.

Шаг 2: Использование файла sdkconfig.xml

В коде, где используется SDK, импортируйте файл MobileTracking.h с помощью директивы #import "MobileTracking.h".

Шаг 3: Тестирование и отладка

Тестирование SDK включает два аспекта:

Проверка полноты параметров и правильности URL-сцепления.
Соответствие количества запросов и данных, полученных от третьей стороны.

Для проверки первого аспекта используйте тестовую платформу Admaster SDK по адресу http://developer.admaster.com.cn/. После входа (для регистрации свяжитесь с wuhao@admaster.com.cn) следуйте инструкциям на странице для вызова функций. Через 5 минут страница автоматически отобразит информацию, полученную сервером. Если данные совпадают с информацией на вашем устройстве, тест пройден успешно.
Второй аспект тестирования предполагает использование официальной среды мониторинга третьей стороны для сравнения данных о рекламе, собранных вашей системой, с данными, полученными от третьей стороны.

Использование

1. Инициализация

[MobileTracking sharedInstance]

Перед началом мониторинга необходимо выполнить инициализацию. Рекомендуется выполнить эту операцию в методе didFinishLaunchingWithOptions класса AppDelegate.

2. Конфигурация удаленного файла конфигурации

[[MobileTracking sharedInstance] configFromUrl:@“http://xxxxxx.com/sdkconfig.xml”];

SDK автоматически загружает удаленный файл конфигурации. При следующем запуске приложения будет использоваться обновленный файл конфигурации для настройки параметров.

3. Мониторинг кликов и просмотров

Для мониторинга просмотров вызовите следующий код, указав адрес мониторинга третьей стороны в качестве параметра:

[[MobileTracking sharedInstance] view:@"http://vxyz.admaster.com.cn/v/a17298,b81949763,c3194,i0,m201”];

Для мониторинга кликов вызовите следующий код, также указав адрес мониторинга третьей стороны:

[[MobileTracking sharedInstance] click:@"http://vxyz.admaster.com.cn/v/a17298,b81949763,c3194,i0,m201"];

4. Вызов при переходе в фоновый режим

[[MobileTracking sharedInstance] didEnterBackground];

Рекомендуется вызывать этот метод в методе applicationDidEnterBackground класса AppDelegate.

5. Вызов при возвращении на передний план

[[MobileTracking sharedInstance] didEnterForeground];

Этот метод рекомендуется вызывать в методе applicationWillEnterForeground класса AppDelegate.

6. Вызов перед завершением работы приложения

[[MobileTracking sharedInstance] willTerminate];

7. Включение журнала отладки

[[MobileTracking sharedInstance] enableLog:YES];

Рекомендуется включать журнал отладки во время тестирования.