Базовое руководство по интеграции SDK (пакет средств разработки ПО)

Идентификатор AppsFlyer создается автоматически при каждой новой установке приложения. Маркетологу не требуется выполнять никаких действий.

Вы можете использовать этот идентификатор для выполнения следующих действий:

• Отправлять внутренние события от сервера к серверу.
• Свяжите идентификатор AppsFlyer с пользовательскими записями в ваших бэкенд-системах.
• Загружайте отчет о необработанных данных о событиях в приложении и используйте appsflyer_id для анализа поведения и путей пользователей.

Установите собственный идентификатор пользователя клиента (CUID) в SDK (пакет средств разработки ПО) AppsFlyer, чтобы соотносить уникальный идентификатор из вашей системы бизнес-аналитики с идентификатором AppsFlyer и другими идентификаторами. CUID доступен в отчётах о необработанных данных AppsFlyer. Вы также можете использовать его в постбэк API для связи с вашими внутренними идентификаторами.

Чтобы узнать больше о CUID, смотрите эту статью.

Реферал установки в GOOGLE PLAY

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

Рекомендуется предоставить разработчику указания по добавлению API Google Play Install Referrer.

ГАИД

Начиная с версии SDK (пакет средств разработки ПО) 4.8.0, AppsFlyer автоматически собирает этот идентификатор устройства.

С помощью AppsFlyer вы можете атрибутировать установки, поступающие из сторонних магазинов приложений, таких как Amazon, Opera, GetJar, Baidu и Huawei. Это позволяет вам продвигать приложения и охватывать большие аудитории на рынках, где Google Play недоступен.

AppsFlyer поддерживает атрибуцию в контексте сторонних магазинов приложений следующим образом:

• IMEI или идентификатор Android: SDK (пакет средств разработки ПО) не осуществляет автоматический сбор IMEI или идентификатора Android. Однако, если необходимо собирать эти идентификаторы (например, для приложений на внутреннем рынке Китая), разработчик может реализовать один из следующих способов сбора:
  • Ручной сбор данных: Приложение передает IMEI или идентификатор Android в SDK (пакет средств разработки ПО) с использованием API setImeiData или setAndroidIdData (см. раздел о функции на вкладках ниже). SDK (пакет средств разработки ПО) отправляет данные на серверы AppsFlyer.
    Android nativeUnity

    См. справочник по Android SDK для:

    •  
    •   

    См. справочник по Unity SDK для:

    • setImeiData
    • setAndroidIdData
  • Дайте согласие на сбор идентификатора устройства: Принудительно осуществляет сбор IMEI или идентификатора Android с использованием setCollectIMEI и setCollectAndroidID (см. раздел о функции на вкладках ниже).
    Android nativeUnityReact Native

    См. справочник по Android SDK для:

    • setCollectIMEI
    • setCollectAndroidID

    См. справочник по Unity SDK для:

    • setCollectIMEI
    • setCollectAndroidID

    См. справочник по React Native для:

    • setCollectIMEI
    • setCollectAndroidID

• OAID: Атрибуция установок из сторонних магазинов приложений Android. Для получения дополнительной информации см. руководство по внедрению OAID.
• Рефереры установки: SDK (пакет средств разработки ПО) поддерживает получение реферальных данных из Samsung Gallery и Huawei AppGallery.

ФОН

Начиная с iOS 14.5, для сбора IDFA требуется согласие пользователя. На практике это означает, что доступ к IDFA регулируется фреймворком App Tracking Transparency (ATT). На Устройствах iOS 14+ SDK (пакет средств разработки ПО) использует фреймворк ATT для получения доступа к идентификатору устройства IDFA. Для введения в ATT см. принципы ATT.

Когда Атрибуция осуществляется с использованием IDFA, важно, чтобы IDFA был отправлен при первом запуске. waitForATTUserAuthorizationПо этой причине SDK (пакет средств разработки ПО) предоставляет метод waitForATTUserAuthorization.

Обзор waitForATTUserAuthorization

waitForATTUserAuthorization позволяет вам настроить, как долго SDK (пакет средств разработки ПО) должен ожидать статус ATT перед передачей данных на серверы AppsFlyer.

Когда пользователь запускает Приложение, статус ATT — не определен. В течение тайм-аута SDK (пакет средств разработки ПО) временно сохраняет событие запуска и последующие события в Приложении в памяти, аналогично тому, как записываются офлайн-события:

• Если пользователь дает согласие на запрос ATT (сбор IDFA):
  • SDK добавляет IDFA к закэшированным событиям.
  • SDK запускается и отправляет события с IDFA без ожидания окончания тайм-аута.

• Если пользователь отклоняет запрос ATT: SDK запускается и отправляет события без IDFA без ожидания окончания тайм-аута.
• Если тайм-аут заканчивается, а статус ATT остается не определен: SDK запускается и отправляет закэшированные события без IDFA.

Факторы для учета

• Вызов без предварительной настройки приведет к отправке запусков и событий без IDFA для Устройств на iOS 14 и выше.
• Если пользователь переводит Приложение в фоновый режим в течение тайм-аута:
  • Таймер приостанавливается, пока Приложение не вернется на передний план.
  • События временно сохраняются в памяти.

• Если пользователь закрывает Приложение и оно завершает работу в течение тайм-аута:
  • Таймер перезапустится при следующем запуске Приложения.
  • Закэшированные события теряются.

Вы можете настроить запрос ATT. Сообщение, четко объясняющее цель запроса, может помогать увеличить процент согласий пользователей.

При создании сообщения учтите следующее:

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

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