How can we help?

Добавление приложения в AppsFlyer

  • Обновлено

Вкратце: Узнайте, как добавить ваше приложение в AppsFlyer, чтобы получать данные атрибуции по установкам и событиям в приложении, а также анализировать эти данные с помощью различных инструментов AppsFlyer.

Обзор

Если вы ещё не добавили приложение в свой дэшборд, при входе в AppsFlyer отобразится страница ознакомления с приложением. Процесс ознакомления с приложением проведет вас через все этапы добавления вашего приложения и подготовки его к атрибуции. 

Вход в мастер добавления приложения

Вы можете воспользоваться мастером добавления приложений с платформы или через страницу ознакомления с приложением (только для приложений Android и iOS).

Для входа в мастер через страницу ознакомления с приложением:

  • На этапе Добавьте ваше приложение нажмите Добавить приложение и следуйте инструкциям.

 Примечание:

Если страница ознакомления ещё не открыта, в верхней панели выберите из раскрывающегося списка адресов электронная почта, электронное сообщение пункт Ознакомление с приложением.

onboarding page.png

Для входа в мастер добавления приложения с платформы:

  • В верхней строке меню > Мои приложения, нажмите + Добавить приложение.
  • На главной странице AppsFlyer нажмите + Добавить приложение.
  • На верхней панели откройте меню учетной записи (раскрывающийся список адресов электронная почта, электронное сообщение) > Ознакомление с приложением, нажмите + Ознакомить с другим приложением.

add an app (1).png

Добавление приложения

После того как вы войдете в мастер добавления приложения, выполните следующие действия:

  1. Введите информацию о приложении.
  2. Введите дополнительную информацию.
  3. Нажмите Добавить мое приложение.
  4. Скопируйте ключ разработчика, который будет использоваться в интеграции SDK (пакет средств разработки ПО) (позже его можно будет получить на странице Настройки приложения).
  5. Нажмите Готово или + Добавить другое приложение, чтобы добавить больше приложений. Повторите процесс для добавления дополнительных приложений.

 Примечание

После регистрации Приложение появится на дэшборде. Чтобы установки и события в приложении регистрировались и приписывались правильным медиа источникам, необходимо:

  • Интегрировать SDK (пакет средств разработки ПО)
  • Подключите Приложение к Партнёрам в Marketplace партнёров

Ознакомьтесь со всеми шагами для завершения процесса ознакомления.

Ввод данных Приложение

Выберите платформу Приложение и введите необходимые данные, как указано ниже:

Android, AndroidTV, Fire

Использовать эту опцию для следующих платформ:

  • Android (мобильный)
  • AndroidTV
  • Amazon Fire
  • Amazon Fire ТВ
  • Kindle
Статус Google Play Когда использовать Необходимые данные
В магазине Ваше Приложение в настоящее время доступно в магазине Google Play.

URL-адрес Google Play (скопировано из Google Play)

  • Пример: https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest&hl=en&gl=GB
  • Важно!
    • Если ваше Приложение не в магазине Google Play в США,
      • URL-адрес должен включать код страны любого магазина, в котором оно указано, как показано в примере выше). &gl={код_страны}. Если вы не включите код страны, вы получите ошибку при попытке добавить Приложение.
      • Код языка необязателен: &hl={language_code}
    • Если ваш магазин перечислен в магазине Google Play в США, оба кода: и страны и языка, являются необязательными.
Ожидает одобрения/не опубликовано Ваше приложение еще не опубликовано или ожидает одобрения из Google Play

Имя пакета Android

  • Пример: com.appsflyer.adNetworkTest
  • Примечание: В названии пакета учитывается различие строчных и прописных букв ( чувствительный
  • Формат:
    • Не менее двух сегментов (одна или несколько точек)
    • Каждый сегмент должен начинаться с буквы.
    • Все символы должны быть буквенно-цифровыми. или подчеркиванием (a-z, A-Z, 0-9, или _)
    • максимальная длина 100 символов.

Для получения более подробной информации см. Документация для разработчиков Android

Сторонний магазин/вне магазина Ваше приложение находится в магазине приложений Android, отличном от Google Play и/или может быть загружено из место, отличное от магазина приложений
  • Имя пакета Android: Подробные требования см. в предыдущей строке.
  • URL-адрес приложения (скопированный из магазина приложений или внемагазинного местоположения) в магазине приложений или вне магазина)
  • Название канала: уникальное название вы задаете в AndroidManifest.xml для отдельного APK, подготовленного для этого магазина/местоположения. Имя должно быть: 
<application>
     ...
     <meta-data android:name="CHANNEL" android:value="Amazon"/>
     ...
</application>

 Примечание:

Не рекомендуется использовать параметр канала для атрибуции в нескольких магазинах. Для более простой и стандартизированной реализации используйте вместо этого параметр af_store.

 Важно!

Если ваше приложение доступно из более чем одного источника (то есть любая комбинация из следующих вариантов: Google Play, сторонние магазины или внемагазинные местоположения), крайне важно рассмотреть варианты для настройки много-магазинной атрибуции для Android.  

iOS, tvOS, MacOS

Использовать эту опцию для следующих платформ:

  • https://support.appsflyer.com/hc/article_attachments/360016192917
  • tvOS
  • MacOS
Статус в магазине приложений Когда использовать Необходимые данные
В магазине Ваше приложение в настоящее время доступно в магазине приложений

Ваше приложение в настоящее время доступно в магазине приложений URL-адрес магазина приложений (скопированный из

  • Пример: https://apps.apple.com/us/app/partner-integrations/id1543229303
  • Примечание
    • Убедитесь, что URL-адрес включает двухбуквенный код страны магазина (например, us в URL-адресе выше)
    • Приложение, добавленное в магазин приложений до 14 июня 2019 г., может содержать itunes.apple.com в своем URL-адресе (вместо apps.apple.com).
Ожидает одобрения/не опубликовано

Ваше приложение еще не опубликовано или ожидает одобрения из магазина приложений

 

Страна магазина приложений, в котором было размещено приложение

 

Идентификатор приложения, назначенный магазином приложений, без префикса id

  • Пример: 1543229303
  • Формат: 9 или 10 числовых символов, от 0 до 9

Windows

Использовать эту опцию для следующих платформ:

  • Windows Phone
  • Windows (настольный)
Статус в Microsoft Store Когда использовать Необходимые данные
В магазине Ваше приложение в настоящее время доступно в Microsoft Store

URL-адрес Microsoft Store (скопированный из Microsoft Store)

  • Пример: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • Примечание: Указанный выше URL-адрес является примером для приложения Windows Phone. Формат URL- адреса: отличается для настольных приложений Windows.

Идентификатор приложения: Максимальная длина — 150 символов.

Ожидает одобрения/не опубликовано

Ваше приложение еще не опубликовано или ожидает одобрения из магазина

 

идентификатор приложения, назначенный Microsoft Магазин

  • Максимальная длина: 150 символов.
  • Пример: 9wzdncrfhwfg
  • Примечание: Идентификатор приложения учитывает различие строчных и прописных букв ( чувствительный

Веб (PBA)

 Примечание

Веб-приложение — это место, где вы определяете веб-сайт для включения в бренд пакет для нашей функции Атрибуция на основе людей (PBA).

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

 

Полный URL-адрес: Полный URL-адрес веб-сайта, для которого вы хотите измерить трафик. Это веб-сайт, на котором вы внедрили (или будете внедрять) PBA Web SDK (пакет средств разработки ПО).

URL_диаграмма

Включить

  • схему
  • поддомен [опционально]
  • доменное имя
  • домен верхнего уровня
  • путь [опционально] адрес конкретного каталога или страницы на вашем сайте

Название приложения: Название, которое вы выбрали для своего приложения 

  • Максимальная длина: 100 символов
  • Теги XSS не допускаются

 Важно!

После создания веб-приложения его свойства не могут быть отредактированы (URL-адрес и название приложения) без его удаления и повторного создания, что означает, что вам также следует удалить бренд-пакет, частью которого оно является.

Следующие шаги:

  • Добавьте ваше новое веб-приложение в бренд-пакет PBA , чтобы увидеть его в дэшборде PBA.
    • Убедитесь, что все мобильные приложения, которые вы хотите включить в бренд-пакет, были добавлены в ваш аккаунт перед созданием пакета.
  • Интегрируйте PBA Web SDK на указанный в веб-приложении сайт, чтобы поток данных начал поступать.

Веб

Используйте платформу Web, чтобы создать новое веб-приложение и измерять посещения сайта и конверсии с помощью Web Performance Measurement.

Прежде чем начать

  • Устаревшие веб-приложения Legacy People-Based Attribution (PBA) отображаются в разделе “Web (PBA)” с пометкой Legacy.
  • Если вы переходите с устаревшего веб-приложения PBA Web, вы можете использовать существующий ключ разработчика PBA Web.

Примечание

  1. Перейдите в раздел My Apps > Add app.
  2. Выберите Website.
  3. Введите следующее:

 

Название приложения: Название, которое вы выбрали для своего веб-приложения.

  • Примечания:
  • Допустимые символы: Буквы (любого языка), цифры, пробелы (не в начале и не в конце) и специальные символы: . - _ :
  • Недопустимые символы: ; { } $ < > ` \

Пример: My Online Store, Corporate Website 2024, E-Commerce_Production

 

Основной домен (полный URL-адрес): Основной домен вашего сайта. Он задается при создании веб-приложения и не может быть изменен позже.

  • Формат: Только допустимое доменное имя (без протокола, пути или порта)
  • Подробные требования см. в предыдущей строке Ожидает подтверждения / не опубликовано
  • Обработка: AppsFlyer автоматически
    • Удаляет http:// или https://
    • Удаляет завершающие косые черты
    • преобразует домен в нижний регистр
  • Неизменяемость: После создания приложения редактирование недоступно

Важно: Чтобы изменить основной домен, необходимо удалить и заново создать веб-приложение, что приведет к потере непрерывности исторических данных.

Пример:

  • https://shop.example.com/checkout → Сохраняется как shop.example.com → ID приложения: website-shop.example.com
  • example.com/ → Сохраняется как example.com → ID приложения: website-example.com

 

ID приложения: Уникальный ID, который AppsFlyer создает для веб-приложения на основе основного домена.

  • Автоматически создается в формате: website-<primary_domain>
  • Пример: website-shop.example.com

 

Web SDK ID: Идентификатор ID, который Web SDK использует для атрибуции (ранее назывался web_dev_key).

Два варианта при создании приложения:

Вариант 1: Создать новый (по умолчанию)

  • Автоматически создает новый Web SDK ID
  • Формат: website-{yourdomain.com}
  • Пример: website-shop.example.com
  • Сценарий использования: Новые реализации веб-атрибуции

Вариант 2: Повторно использовать существующий ключ разработки PBA

  • Выберите в выпадающем списке существующие ключи разработки PBA (People-Based Attribution) для веб-приложений
  • Обеспечивает бесшовную миграцию без изменения кода сайта
  • Сценарий использования: Миграция с устаревшего PBA на новое решение для веб-атрибуции

Примечание: Повторное использование ключа разработки PBA позволяет выполнить миграцию с PBA на новое веб-приложение без внесения каких-либо изменений в реализацию вашего сайта

Каждый ключ разработки PBA можно назначить только ОДНОМУ веб-приложению. После использования ключа разработки PBA для веб-приложения он больше недоступен для других веб-приложений.

  • Длина: 1–550 символов
  • Неизменяемость: Нельзя изменить после создания Приложения
  • Миграция PBA: В выпадающем списке отображаются только ключи разработки из PBA веб-Приложений вашей учетной записи

 

Валюта: Валюта, используемая в отчетности приложения.

  • Стандартный код валюты ISO 4217 (например, USD, EUR, GBP, ILS)
  • Выбирается из выпадающего списка
  • Обязательное поле

 

Часовой пояс: часовой пояс, используемый для отчетности приложения.

  • Формат часового пояса IANA (например, America/New_York, Europe/London, Asia/Tokyo)
  • Выбирается из раскрывающегося списка
  • Обязательное поле

 

  1. Нажмите Create app.

 

Характеристики и ограничения

  • После создания приложения основной домен нельзя изменить.
  • Основной домен автоматически добавляется в Excluded Domains с типом PRIMARY.

Каждый устаревший Web Dev Key можно повторно использовать только для одного нового веб-приложения.

 

Примечание

Полную информацию о настройках веб-атрибуции см. здесь.

 

Roku

Название приложения: Название канала, скопированное из Панели разработчика Roku.

  • Пример: Мой канал Roku
  • Формат:
    • максимальная длина 100 символов.
    • Теги XSS не допускаются

Идентификатор канала: Числовой идентификатор, назначенный каналу компанией Roku.

  • Формат:
    • Цифры (0-9)
    • Максимальная длина: 50 символов
  • Как мне его найти?
    • В дэшборде разработчика Roku, кликните на название канала, который вы добавляете в AppsFlyer. Это откроет страницу предварительного просмотра и публикации Roku для канала.
    • Число в конце URL-адреса страницы — это идентификатор канала: идентификатор:

Amazon Vega OS

Название приложения: Имя, которое вы выбрали для вашего приложения.

Идентификатор приложения: Идентификатор приложения. Определяется с использованием обратной DNS-нотации:  <tld>.<company_name>.<app_name>
Должен содержать не менее 2 сегментов. Каждый сегмент должен начинаться с буквы, за которой следуют символы из набора: A-Z a-z 0-9. _ -.


Для получения более подробной информации см. поле “id” в документации Amazon Vega OS.

Vizio SmartCast

Название приложения: Имя, которое вы выбрали для вашего приложения.

Идентификатор приложения: Идентификатор приложения, распознаваемый компанией Vizio. Начинается с букв vz, за которыми следуют 2-10 символов из: .- 0-9. -. Если вам необходимо подтвердить идентификатор приложения, уточните у представителя Vizio. 

Samsung Tizen

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор пакета, назначенный вашему приложению компанией Samsung. Начинается с буквы G, за которой следует 8-15 цифр. Вы можете найти его в конце URL-адреса магазина приложений вашего приложения: 

  1. Войдите в Samsung TV Seller Office по этой ссылке.
    1. Введите URL-адрес разработчика
  2. Ваш Bundle ID автоматически генерируется и отображается. Его можно использовать для доступа к URL-адресу магазина приложений.
  3. При возникновении проблем создайте тикет в issue board в Seller Office.
Примечание. Чтобы получить доступ к уникальной веб-странице вашего приложения в магазине приложений, добавьте идентификатор пакета к URL-адресу "https://www.samsung.com/us/appstore/app/". 
Например, если ваш идентификатор пакета — "G15147002586", URL-адрес вашей страницы будет таким: "https://www.samsung.com/us/appstore/app/G15147002586/ ". URL-адрес разработчика, идентификатор пакета и идентификатор магазина приложений затем отображаются в метаданных на этой странице.

LG WebOS

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения LG WebOS.

  • Формат:
    • Максимальная длина — 50 символов.
    • Символы A-Z a-z. _ в формате, схожем с пакетом ( формат. Должно начинаться с букв.
  • Пример: com.my-company.app 

Если вам необходимо подтвердить идентификатор приложения, обратитесь к представителю LG WebOS.  

PlayStation

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Концептуальный идентификатор PlayStation, уникальный идентификатор, назначенный игре или другим концепциям контента. Он отображается как 5-9-значное число в URL-адресе магазина PlayStation. Вы можете найти его в конце URL-адреса вашего приложения в магазине приложений:

playstation_app_id_url.png

RIDA

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Vidaa. Максимальная длина — 50 символов.

Steam

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Steam. Это 5-8-значное число номер, отображаемый в URL-адресе магазина Steam:

steam_store_app_url.png

Meta Quest (Oculus)

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Epic Games, как он отображается в магазине, из которого загружено приложение. Содержит от 3 до 50 следующих символов: A-Z a-z0-9. 

Nintendo Switch

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Nintendo Switch, как он отображается в конце URL-адреса магазина, из которого загружено приложение. Состоит из 14 цифр.

  • Пример: 70010000012345

Xbox

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Xbox, как он отображается в конце URL-адреса магазина Xbox, из которого загружается приложение. Содержит только 12 букв и цифр (0-9 0-90-9). 

Примечание: Идентификатор приложения чувствителен к регистру.

Эпические игры

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения для нативного ПК. Содержит от 3 до 50 следующих символов: A-Z a-z0-9. 

Нативный ПК

Название приложения: Название, которое вы выбрали для своего приложения.

Идентификатор приложения: Идентификатор приложения Meta Quest, как он отображается в конце URL-адреса магазина приложений, из которого загружается приложение. Содержит только 12 букв и цифр (A-Z a-z0-9). 

Введите дополнительную информацию (не относится к веб-приложениям):

Выберите валюту

Выберите валюту, в которой данные этого приложения будут отображаться на дэшборде. События выручки и расходования конвертируются в эту валюту с использованием обменного курса, действительного на момент события. Узнать больше о настройке валюты приложения и ее воздействии.

 Важно!

Будьте внимательны при выборе валюты, которую вы хотите использовать в приложении. Изменение будет невозможно после того, как стоимость и выручка будут зафиксированы.

Выберите часовой пояс

Синхронизируйте выбранный здесь часовой пояс с часовым поясом, который вы установили у других партнеров по атрибуции (таких как реклама Meta и Google Ads). Это обеспечивает максимальное сходство данных, представленных на дэшборде AppsFlyer, с данными, которые вы получаете от этих партнеров.

 Примечание:

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

Определите аудиторию приложения

Выберите Да или Нет, чтобы указать, предназначено ли ваше приложение для детей или для смешанной аудитории (и детей, и взрослых).
Если вы выбрали Да:

  1. Откройте и прочитайте руководство по соблюдению правовых норм в приложениях, ориентированных на детей.
  2. Установите флажок, чтобы подтвердить, что вы прочитали руководство и будете применять указанные в нём элементы управления.

 Примечание:

  • Две недели спустя после добавления приложения вы получите уведомление с просьбой подтвердить, что реализовали элементы управления конфиденциальностью для приложений, ориентированных на детей. После подтверждения вы получите сообщение о подтверждении. Вы всегда можете получить доступ к сообщению о подтверждении из Центра уведомлений или просмотреть детали подтверждения в журнале аудита.
  • Смотрите часто задаваемые вопросы о приложениях, ориентированных на детей.

Управляйте своими приложениями массово через API

Администраторы учётных записей могут управлять несколькими приложениями одновременно с помощью специального API, который поддерживает основные функции интерфейса. Это включает добавление и удаление приложений, а также обновление настроек приложений. API также включает те же механизмы проверки ошибок.

 Примечание:

На данном этапе добавление приложений и обновление настроек через API возможно только для мобильных приложений. Удаление приложений возможно для всех платформ.

Добавьте отладочное или тестовое приложение

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

Примечание

Для приложений iOS, которые еще не опубликованы в App Store и пока не имеют действительного App Store ID, вы все равно можете продолжить тестирование SDK, добавив приложение с помощью фиктивного iOS App Store ID. Это позволяет выполнять интеграцию и тестирование SDK без необходимости в реальном листинге в App Store.

Инструкции для разработчиков по созданию отладочного приложения и его добавлению на дэшборд см. здесь:

Об ожидающих приложениях

Работа с приложением в статусе ожидания полезна при его отладке для тестирования SDK (пакет средств разработки ПО) AppsFlyer.

Статус приложения как ожидающего на дэшборде не влияет на сбор и измерение данных. Независимо от того, находится ли приложение в состоянии ожидания или уже доступно в магазине приложений, если пользователи устанавливают и взаимодействуют с ним, данные об установке и внутренние события приложения регистрируются на дэшборде.

Когда ваше ожидающее приложение будет опубликовано, AppsFlyer определит и автоматически обновит его статус, так что вам не нужно будет добавлять его снова. Узнать больше об ожидающих приложениях и о возможности ручного обновления статуса.

Устранение неполадок

Найдите решения для некоторых распространённых проблем:

Приложение не было добавлено

Если возникла эта ошибка, свяжитесь с вашим менеджером по клиентам или отправьте электронную почту, электронное сообщение по адресу hello@appsflyer.com.

Приложение отсутствует в магазине

Убедитесь, что вы правильно скопировали URL-адрес магазина, используя соответствующее имя/идентификатор приложения.

Нет доступа к маркетплейсу

Эта ошибка иногда возникает при добавлении приложения Android из магазина, не принадлежащего США. Чтобы устранить эту ошибку, выполните следующие шаги:

  1. Добавьте приложение с статусом Ожидает одобрения/не опубликовано, как указано выше.
  2. Перейдите на страницу Настроек приложения в AppsFlyer.
  3. Измените страну магазина приложений на правильную (например, Япония).

Что-то пошло не так. Пожалуйста, попробуйте снова.

Одной из возможных причин этой ошибки может быть попытка добавить Android-приложение без кода страны (для приложений, не указанных в магазине Google Play США). Полную информацию о решении этой проблемы смотрите выше.

Мое iOS-приложение было удалено из App Store. Почему я до сих пор вижу установки?

Это происходит потому, что пользователи могут повторно установить приложение через операционную систему, если оно было установлено на их устройстве ранее. Даже если приложение больше не доступно в App Store, пользователи все равно могут установить его, и эти установки будут учитываться в AppsFlyer.

Дополнительная информация

WI-FI

Вы можете добавлять приложения в линейку продуктов и удалять их из нее. Подробнее о линейках продуктов и их возможностях см. здесь.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: