Руководство по интеграции плагина для Unity V6: интеграция дополнительных средств SDK

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

Чтобы настроить измерение количества удалений, обратитесь к инструкциям для соответствующей операционной системы.

using AppsFlyerSDK;

public class AppsFlyerObjectScript : MonoBehaviour, IAppsFlyerConversionData
{
    private bool tokenSent;

    void Start()
    {
        AppsFlyer.initSDK("devKey", "appID", this);
        AppsFlyer.startSDK();

#if UNITY_IOS
        UnityEngine.iOS.NotificationServices.RegisterForNotifications(UnityEngine.iOS.NotificationType.Alert | UnityEngine.iOS.NotificationType.Badge | UnityEngine.iOS.NotificationType.Sound);
#endif

    }

    void Update()
    {
#if UNITY_IOS
        if (!tokenSent)
        { 
            byte[] token = UnityEngine.iOS.NotificationServices.deviceToken;
            if (token != null)
            {
                AppsFlyeriOS.registerUninstall(token);
                tokenSent = true;
            }
        }
#endif
    }
}

Для интеграции на уровне плагина с несколькими внешними партнерскими платформами (включая Segment, Adobe и Urban Airship), необходимо использовать API setAdditionalData.

Используйте этот API, только если в руководстве по интеграции партнера явно указано, что требуется API setAdditionalData.

Пример: код для setAdditionalData

Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("custom_param_1", "value_of_param_1");
AppsFlyer.setAdditionalData(CustomDataMap);

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

AppsFlyer.setMinTimeBetweenSessions(custom_time_ins_seconds);

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

См. дополнительную информацию о подсчете сеансов.

Недоступно в Unity.

Некоторые сторонние службы (например, поставщики услуг электронной почты):

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

Упаковка ссылки OneLink в такие домены может привести к ограничению ее функциональных возможностей. Чтобы обойти это:

• Вызовите API setResolveDeepLinkURLs перед инициализацией SDK.
• API получает ссылки OneLink от доменов кликов, которые запускают приложение. 

Сценарий: домены регистрации кликов выполняют перенаправление на ссылку OneLink по адресу https://mysubdomain.onelink.me/abCD.

Решение:

• Используйте API setResolveDeepLinkURLs для получения ссылки OneLink, на которую домены регистрации кликов перенаправляют пользователя приложения.
• Этот метод API получает список доменов, разрешение которых выполняет плагин.
• Следующий код позволит вам использовать домен регистрации кликов, сохраняя при этом функциональные возможности OneLink:

   Пример

  AppsFlyer.setResolveDeepLinkURLs("example.com", "click.example.com");

Теперь используйте данные из ссылки OneLink для диплинкинга и персонализации пользовательского контента.

Регистрируйте push-уведомления при проведении кампаний по ретаргетингу.

Для регистрации push-уведомлений:

• Вызовите метод sendPushNotificationData.
• Этот метод содержится в методе onCreate для каждой активности, которая запускается после клика на уведомлении:

#if UNITY_ANDROID && !UNITY_EDITOR
 AppsFlyerAndroid.handlePushNotifications();
#endif

Более подробные сведения об измерении push-уведомлений см. здесь.

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

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

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

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

Идентификатор AppsFlyer ID создается для каждой новой установки приложения. Используйте AppsFlyer ID, чтобы:

• Отправляйте внутренние события приложения от сервера к серверу.
• Сопоставлять его с данными пользователей в ваших back-end системах.
• Сопоставляйте записи при объединении данных из Pull API и Push API.

 Чтобы получить уникальный AppsFlyer ID:

string AppsFlyerUID = AppsFlyer.getAppsFlyerId();

Установите свой уникальный ID пользователя (CUID) и свяжите его с уникальным AppsFlyer ID.

Уникальный CUID: 

• Его можно посмотреть в CSV-отчетах AppsFlyer по необработанным данным.
• Он может использоваться в API постбэков для связывания внутренних идентификаторов.

Чтобы настроить CUID, используйте:

AppsFlyer.setCustomerUserId("someId");

Рекомендуется! Установите CUID на раннем этапе продвижения приложения — он будет связываться с включаемыми в отчеты событиями только с момента его настройки.

Вызовите setCustomerUserId до вызова startSDK

• Зарегистрированные события будут связаны с CUID.
• Связанные данные появятся в отчетах необработанных данных по установкам и событиям.

AppsFlyer.setCustomerUserId("someId");

Получить идентификатор пользователя

Дополнительная информация: см. CUID.

Задержка инициализации плагина для идентификатора customerUserID

Установите идентификатор пользователя (CUID) и только после этого инициализируйте плагин. Это полезно, если вы хотите, чтобы идентификатор пользователя содержался в ваших данных об установках и событиях.

Воспользуйтесь следующими инструкциями операционной системы:

1. Android;
2. iOS.

OAID — один из уникальных идентификаторов устройства, позволяющий проводить атрибуцию.

Для сбора OAID:

    <androidPackage spec="com.appsflyer:oaid:5.2.0">
    </androidPackage>

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

Практические рекомендации! Следуйте в точности инструкциям для сценария, применимого для вашего приложения.

Чтобы прекратить отслеживание:

• Вызовите stopSDK и установите значение true.
  

  AppsFlyer.stopSDK(true);

• Плагин прекратит работу и обмен данными с серверами AppsFlyer.

Чтобы возобновить отслеживание: вызовите stopSDK и установите значение "false".

Чтобы анонимизировать пользователя приложения:

1. Установите API в течение установки SDK
2. Вызовите anonymizeUserи установите значение true.
   

   AppsFlyer.anonymizeUser(true);

3. Установки, события и сессии анонимизированы.

Чтобы возобновить отслеживание: вызовите anonymizeUser и установите значение false.

В некоторых случаях рекламодатели должны прекратить передачу рекламным сетям / партнерам данных по определенным пользователям. Причины могут быть следующие:

• Политики конфиденциальности, такие как CCPA или GDPR.
• Отказ пользователей от предоставления данных
• Конкуренция с некоторыми партнерами (рекламными сетями, третьими сторонами)

AppsFlyer предоставляет два метода API для прекращения обмена данными с некоторыми или всеми партнерами:

• setSharingFilter. Используется рекламодателями, чтобы задать несколько сетей/интегрированных партнеров, которым нужно прекратить предоставлять данные.
• setSharingFilterForAllPartners. Используется рекламодателями, чтобы прекратить предоставлять данные всем сетям/интегрированным партнерам.

Эти методы фильтрации поддерживаются в SDK начиная с версии V5.4.1.

Метод фильтрации должен вызываться при каждой инициализации SDK, он влияет на всю сессию. Если требуется время, чтобы определить, нужно ли устанавливать фильтры общего доступа, то отложите инициализацию SDK. 

Если метод активирован до первого вызова startSDK:

• Пользователи из SRN атрибутируются как органические, и их данные не передаются интегрированным партнерам.
• Пользователи по кликам из рекламных сетей (не SRN) правильно атрибутируются в AppsFlyer, но их данные не передаются в рекламные сети через постбэки, API, отчеты по сырым данным или каким-либо другим способом.

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