Первоначальная настройка для iOS-интерфейсов

Материал из Документация Ключ-АСТРОМ
Версия от 17:42, 19 августа 2026; IKuznetsov (обсуждение | вклад) (Новая страница: «= Первоначальная настройка для iOS-интерфейсов = На этой странице вы узнаете, как выполнить первоначальную настройку интерфейсов '''iOS'''. == Настройте автоматический мониторинг iOS с помощью навыка на основе ИИ == Используйте навык ИИ из SDK Ключ-АСТРОМ '''iOS'''...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Первоначальная настройка для iOS-интерфейсов

На этой странице вы узнаете, как выполнить первоначальную настройку интерфейсов iOS.

Настройте автоматический мониторинг iOS с помощью навыка на основе ИИ

Используйте навык ИИ из SDK Ключ-АСТРОМ iOS в своем помощнике по программированию с использованием ИИ, чтобы автоматически интегрировать ЕдиныйАгент в ваше приложение — с нуля до первого события — без каких-либо ручных действий.

Освойте навыки ИИ.

Предварительные требования

Прежде чем начать, убедитесь, что ваша среда соответствует следующим требованиям:

  • iOS 15.0+
  • tvOS 15.0+
  • Xcode 16.0+

Активируйте RUM для мобильного интерфейса

  1. Перейдите в раздел Ключевые показатели опыта > Обзор.
  2. Выберите Мобильные устройства, чтобы просмотреть все мобильные версии сайта.
  3. Выберите интерфейс, который хотите настроить.
  4. Перейдите во вкладку Настройки.
  5. В разделе Включение и контроль затрат активируйте функцию Новый опыт мониторинга реальных пользователей.

Активировать RUM на уровне среды

Для включения RUM для мобильных интерфейсов на уровне среды:

  1. Перейдите в Настройки > Сбор и регистрация > Мониторинг реальных пользователей > Включение и контроль затрат > Мобильные устройства.
  2. Включите функцию Enable RUM.

Выполните первоначальную настройку

1. Создайте мобильное приложение Ключ-АСТРОМ

  1. Перейдите в раздел Ключевые показатели опыта.
  2. Выберите Добавить интерфейс в правом верхнем углу.
  3. Следуйте инструкциям мастера создания интерфейса.
  4. Выберите iOS в качестве платформы.
    • Мастер предоставит идентификационные ключи вашего приложения, которые понадобятся вам на следующих шагах.
  5. (Необязательно) Чтобы настроить оповещения о состоянии системы для этого интерфейса, в разделе Оповещения выберите субъект (рекомендуется пользователь сервиса) и метрики для мониторинга. Оповещения активируются с параметрами обнаружения по умолчанию, которые вы можете настроить в параметрах интерфейса после завершения настройки. Подробнее см. раздел «Оповещения о состоянии системы для интерфейсов».

2. Добавьте ЕдиныйАгент в свой проект

Чтобы добавить агента в вашу систему, воспользуйтесь мастером настройки в приложении Ключевые показатели опыта.

3. Настройте файл Info.plist

Добавьте идентификационные ключи вашего приложения в файл приложения Info.plist. Эти значения можно найти в мастере инструментирования.

Info.plist

<key>DTXApplicationID</key>
<string>ВАШ_ИД_ЗАЯВЛЕНИЯ</string>
<key>DTXBeaconURL</key>
<string>YOUR_BEACON_URL</string>

Замените значения YOUR_APPLICATION_ID и YOUR_BEACON_URL фактическими значениями, полученными в мастере настройки приборов в Ключ-АСТРОМ.

4. Импорт и проверка

Импортируйте модуль Ключ-АСТРОМ в свое приложение, чтобы проверить интеграцию.

Swift

import Astromkey

Objective-C

@import Astromkey;
// или
#import <Astromkey/Astromkey.h>

Перед использованием любых методов SDK ЕдиногоАгента или объявлений импорта запустите сборку проекта один раз.

5. Собрать и запустить

Соберите и запустите приложение, чтобы проверить установку.

  • Соберите свой проект в Xcode (Product > Build).
  • Запустите приложение на устройстве или симуляторе.
  • Выполните ряд действий для привлечения трафика.
  • Проверьте свою среду Ключ-АСТРОМ — данные должны появиться в течение нескольких минут.

Параметры конфигурации

После завершения базовой настройки вы можете настроить поведение ЕдиногоАгента с помощью ключей конфигурации в вашем файле Info.plist. Подробные параметры конфигурации, включая ручной запуск, отладочное логирование и все доступные ключи, см. в разделе «Конфигурация».

Ключ конфигурации По умолчанию Описание
DTXApplicationID Уникальный идентификатор вашего приложения (обязательно)
DTXBeaconURL URL-адрес конечной точки маяка (обязательно)
DTXStartupWithGrailEnabled false Отправляет данные в Хранилище данных с первого запуска приложения.

Полный список параметров конфигурации см. в разделе «Ключи конфигурации».

Проверьте установку

После установки и настройки ЕдиногоАгента убедитесь, что данные собираются:

  • Откройте приложение и выполните несколько действий (перемещайтесь между экранами, нажимайте кнопки и отправляйте сетевые запросы).
  • Перейдите в мобильную версию вашего приложения в Ключ-АСТРОМ:
  1. Перейдите в раздел Ключевые показатели опыта > Обзор.
  2. Выберите Мобильные устройства, чтобы просмотреть все мобильные версии сайта.
  3. Выберите интерфейс, который хотите настроить.
  • Убедитесь, что сессии и действия пользователей отображаются в данных.

Эти данные также можно анализировать непосредственно в Хранилище данных с помощью DQL.

После первого запуска приложения Ключ-АСТРОМ для отображения данных может потребоваться несколько минут.

Известные ограничения

Информацию о поддерживаемых версиях, известных ограничениях и совместимости с другими инструментами мониторинга см. в разделе «Поддержка и ограничения».