IKuznetsov: Новая страница: «= Первоначальная настройка для iOS-интерфейсов = На этой странице вы узнаете, как выполнить первоначальную настройку интерфейсов '''iOS'''. == Настройте автоматический мониторинг iOS с помощью навыка на основе ИИ == Используйте навык ИИ из SDK Ключ-АСТРОМ '''iOS'''...»

2026-08-19T17:42:43Z

Новая страница: «= Первоначальная настройка для iOS-интерфейсов = На этой странице вы узнаете, как выполнить первоначальную настройку интерфейсов '''iOS'''. == Настройте автоматический мониторинг iOS с помощью навыка на основе ИИ == Используйте навык ИИ из SDK Ключ-АСТРОМ '''iOS'''...»

Новая страница

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

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

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

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

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

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

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

* '''iOS''' 15.0+
* '''tvOS''' 15.0+
* '''Xcode''' 16.0+

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

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

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

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

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

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

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

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

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

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

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

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

'''Info.plist'''
<pre>
<key>DTXApplicationID</key>
<string>ВАШ_ИД_ЗАЯВЛЕНИЯ</string>
<key>DTXBeaconURL</key>
<string>YOUR_BEACON_URL</string>
</pre>

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

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

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

'''Swift'''
<pre>
import Astromkey
</pre>

'''Objective-C'''
<pre>
@import Astromkey;
// или
#import <Astromkey/Astromkey.h>
</pre>

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

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

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

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

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

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

{| class="wikitable"
|-
! Ключ конфигурации !! По умолчанию !! Описание
|-
| <code>DTXApplicationID</code> || – || Уникальный идентификатор вашего приложения (обязательно)
|-
| <code>DTXBeaconURL</code> || – || URL-адрес конечной точки маяка (обязательно)
|-
| <code>DTXStartupWithGrailEnabled</code> || false || Отправляет данные в Хранилище данных с первого запуска приложения.
|}

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

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

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

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

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

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

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

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

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