Руководство по развёртыванию унифицированного SDK для мониторинга и верификации цифровой рекламы (iOS)

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

1. Скопируйте файлы MobileTracking.h, libMobileTracking.a и sdkconfig.xml из каталога release в SDK в ваш проект. Файл sdkconfig.xml необходимо загрузить на веб-сервер, чтобы к нему можно было получить доступ через интернет (предположительно по адресу http://xxxxxx.com/sdkconfig.xml, который будет использоваться позже).

2. В разделе Target Build Settings проекта приложения добавьте опции -lxml2 -all_load или -lxml2 -force_load для статической библиотеки в раздел Other Linker Flags.

3. Добавьте необходимые фреймворки в проект:

   CoreLocation.framework
   libxml2.2.tbd
   AdSupport.framework
   CoreTelephony.framework
   SystemConfiguration.framework
   WebKit.framework  
   AppTrackingTransparency.framework

Шаг 2: Использование

В коде, где вы хотите использовать SDK, добавьте следующую строку:

#import "MobileTracking.h"

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

• Инициализация: Перед началом мониторинга необходимо выполнить инициализацию с помощью кода:

  [MobileTracking sharedInstance]

• Конфигурация удалённого конфигурационного файла: SDK автоматически загружает удалённый конфигурационный файл и использует его для настройки параметров. Для этого используется код:

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

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

  • view: адрес для отслеживания от третьей стороны.
  • ad: объект текущего рекламного представления (обязательно для отслеживания видимых рекламных объявлений, опционально для обычных рекламных объявлений).
  • videoPlayType: тип воспроизведения текущего видеообъявления (опционально, 1 — автоматическое воспроизведение, 2 — ручное воспроизведение, 0 — невозможно определить).
  • impressionType: тип видимости (обязательно для обычных рекламных объявлений, 0 — отслеживаемые объявления, 1 — видимость).
  • succeed: блок обратного вызова для успешного мониторинга.
  • failed: блок обратного вызова при неудачном мониторинге.

  Пример кода для мониторинга видимости:

  // impressionType=1 означает, что это мониторинг видимости. Если передано 0, это отслеживание объявлений.
  [[MobileTracking sharedInstance] view:@"http://example.com/xxxxxx” ad:adView impressionType:1 succeed:^(NSString *eventType) {
        // Код мониторинга успешно отправлен
  } failed:^(NSString *errorMessage) {
      // Ошибка отправки кода мониторинга
  }];
  
  Примечание: Интерфейс мониторинга видимости SDK был обновлён до интерфейса видимости/отслеживания объявлений. Он поддерживает мониторинг видимости или отслеживание объявлений.
  
  1. Видимость: только когда рекламный контент уже загружен на клиентское устройство и хотя бы начал рендеринг (BtR), событие считается «видимостью». «Рендеринг» относится к процессу рисования контента или добавления контента в модель документа.
  2. Отслеживание объявлений: когда код мониторинга уже загружен на клиентское устройство (даже если объявление не обязательно рендерится), событие называется «отслеживанием объявлений».
  
  Разработчики должны выбирать вызов видимости или отслеживания объявлений в зависимости от фактического отображения рекламы. Подробные шаги вызова такие же, как в примере выше. При вызове видимости SDK проверит, начал ли переданный объект рекламного представления рендериться. Если да, то SDK отправит отчёт о видимости в систему мониторинга; если нет, то отправит отчёт об отслеживании объявлений.
  

• Отслеживание кликов: Для отслеживания кликов используется следующий код:

  [[MobileTracking sharedInstance] click:@"http://example.com/xxxxxx"];

• Остановка мониторинга видимости: Мониторинг видимости останавливается, когда рекламное воспроизведение заканчивается. Используется следующий код:

  [[MobileTracking sharedInstance] stop:@"http://example.com/xxxxxx”];

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

  1. Проверка полноты параметров и правильности URL-адресов.
  2. Соответствие количества запросов и данных мониторинга третьей стороне.

Рекомендуется связаться с платформой мониторинга третьей стороны для тестирования.

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

  [[MobileTracking sharedInstance] enableLog:YES];