Интеграция AppsFlyer SDK — iOS. Информация для разработчиков

AppsFlyer SDK использует следующие структуры из основного набора:

AdSupport.framework

Эта инфраструктура необходима для сбора идентификаторов IDFA на устройствах.
Без IDFA невозможно атрибутировать установки, выполненные в Facebook, Twitter и других сетях.

iAd.framework

Эта инфраструктура необходима для регистрации и измерения эффективности кампаний Apple Search Ads для вашего приложения.

Важно: Начиная с SDK версии 4.8.11, SDK автоматически добавляет AdSupport.framework. iAd.framework добавляется автоматически в SDK версии 4.10.0 и выше.
Если у вас предыдущие версии SDK, смотри инструкции далее.

Если вы хотите убрать эти фреймворки и отключить сбор IDFA:

1. Чтобы отключить сбор IDFA, обратитесь к следующим инструкциям.
2. Чтобы отключить iAd.framework, обратитесь к этим инструкциям.

Чтобы добавить фреймворки поддержки рекламы:

1. В вашем проекте Xcode выберите цель проекта.
2. Выберите вкладку General для вашей цели.
3. Раскройте раздел Linked Frameworks and Libraries (Связанные фреймворки и библиотеки).
4. Нажмите +, чтобы добавить фреймворк.
5. Введите в поле поиска AdSupport.framework
6. Выберите из списка AdSupport.framework.

Повторите те же шаги для iAd.framework.

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

Порядок действий:

1. Перейдите на панель управления приложения. 
2. На панели управления выберите в разделе Configuration (Конфигурация) пункт App Settings (Настройки приложения).
3. Скопируйте свой ключ разработчика
   
   

   

Для поддержки диплинкинга добавьте следующий код в SceneDelegate для каждой сцены, на которую ведут глубинные ссылки вашего приложения.

1. Импортируйте библиотеки

#import <AppsFlyerLib/AppsFlyerTracker.h>

import AppsFlyerLib

2. Добавьте внедрение

#import "SceneDelegate.h"

@interface SceneDelegate ()

@end

@implementation SceneDelegate 

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts API_AVAILABLE(ios(13.0)){
    NSURL* url = [[URLContexts allObjects] objectAtIndex:0].URL;
    if(url){
        [[AppsFlyerTracker sharedTracker] handleOpenUrl:url options:nil];
    }
}

- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity  API_AVAILABLE(ios(13.0)){
    [[AppsFlyerTracker sharedTracker]continueUserActivity:userActivity restorationHandler:nil];
}

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions  API_AVAILABLE(ios(13.0)){
    // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
    // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
    // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
}


- (void)sceneDidDisconnect:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene is being released by the system.
    // This occurs shortly after the scene enters the background, or when its session is discarded.
    // Release any resources associated with this scene that can be re-created the next time the scene connects.
    // The scene may re-connect later, as its session was not neccessarily discarded (see `application:didDiscardSceneSessions` instead).
}


- (void)sceneDidBecomeActive:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called when the scene has moved from an inactive state to an active state.
    // Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.
}


- (void)sceneWillResignActive:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called when the scene will move from an active state to an inactive state.
    // This may occur due to temporary interruptions (ex. an incoming phone call).
}


- (void)sceneWillEnterForeground:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene transitions from the background to the foreground.
    // Use this method to undo the changes made on entering the background.
}


- (void)sceneDidEnterBackground:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene transitions from the foreground to the background.
    // Use this method to save data, release shared resources, and store enough scene-specific state information
    // to restore the scene back to its current state.
}


@end

import UIKit
import AppsFlyerLib

@available(iOS 13.0, *)
class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?
    
    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
        AppsFlyerTracker.shared().continue(userActivity, restorationHandler: nil)
    }
    
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        if let url = URLContexts.first?.url {
            AppsFlyerTracker.shared().handleOpen(url, options: nil) 
        }
    }


    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
        // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
        // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
        guard let _ = (scene as? UIWindowScene) else { return }
    }

    func sceneDidDisconnect(_ scene: UIScene) {
        // Called as the scene is being released by the system.
        // This occurs shortly after the scene enters the background, or when its session is discarded.
        // Release any resources associated with this scene that can be re-created the next time the scene connects.
        // The scene may re-connect later, as its session was not neccessarily discarded (see `application:didDiscardSceneSessions` instead).
    }

    func sceneDidBecomeActive(_ scene: UIScene) {
        // Called when the scene has moved from an inactive state to an active state.
        // Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.
        
    }

    func sceneWillResignActive(_ scene: UIScene) {
        // Called when the scene will move from an active state to an inactive state.
        // This may occur due to temporary interruptions (ex. an incoming phone call).
    }

    func sceneWillEnterForeground(_ scene: UIScene) {
        // Called as the scene transitions from the background to the foreground.
        // Use this method to undo the changes made on entering the background.
    }

    func sceneDidEnterBackground(_ scene: UIScene) {
        // Called as the scene transitions from the foreground to the background.
        // Use this method to save data, release shared resources, and store enough scene-specific state information
        // to restore the scene back to its current state.
    }
}

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

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

Для имитации органической установки выполните следующие действия:

1. Убедитесь, что к вашему компьютеру подключено мобильное устройство.
2. Откройте терминал отладки в Xcode.
3. Используя Xcode Studio, установите приложение на устройство или симулятор.
4. Дождитесь запуска приложения.
5. Найдите в терминале отладки имя пакета своего приложения.

Вы увидите на экране такие строки:

Send Track-App-Launch в журнале говорит о том, что SDK сообщило об установке. Данные были получены из метода onConversionDataSuccess в делегате приложения. Способ получения данных о конверсиях описан далее в этой руководстве.

Примечание: Начиная с SDK V5, имя метода для получения данных о конверсиях — onConversionDataSuccess. Если вы используете версию SDK ниже 5.0.0, имя метода onConversionDataReceived. Мы рекомендуем обновить SDK до версии 5.0.0. Подробнее см. тут.

После этого сведения об органической установке должны появиться на обзорной странице панели управления приложения.

Если на панели управления приложения нет сведений об установке, см. наше руководство по поиску и устранению неисправностей в SDK.

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

Порядок действий:

1. Найдите имя вашего приложения в itunes, например id123456789.
2. В ссылке ниже замените <APP_ID> на itunes-идентификатор вашего приложения:
   

   https://app.appsflyer.com/<APP_ID>?pid=sdk_test&c=sdk_test
   

   Параметр pid — это название медиаисточника. Параметр c — это название кампании.
3. Отправьте этот URL на устройство (например, по электронной почте или WhatsApp).
4. На устройстве нажмите на этот URL-адрес.
   • Если приложение зарегистрировано в магазине приложений, произойдет перенаправление в магазин приложений. Не скачивайте приложение из магазина приложений. Перейдите к пункту 5.
   • Если приложение все еще в разработке и не зарегистрировано в магазине приложений, на экране появится сообщение о том, что этого приложения в магазине приложений нет. Просто перейдите к пункту 5.
5. Откройте терминал отладки в Xcode studio.
6. Подключите устройство к компьютеру с помощью USB-кабеля.
7. Установите приложение на устройство из Xcode Studio.
8. Найдите в терминале отладки itunes идентификатор своего приложения.

Вы увидите на экране такие строки:

После этого сведения о неорганической установке должны появиться на обзорной странице панели управления приложения.

SDK содержит два типа констант, которые представляют информацию, связанную с событиями в приложении.

• Названия событий: эти константы имеют формат AFEventEventName.
  Например, AFEventPurchase, AFEventAddToCart.
• Параметры событий - Эти константы имеют формат AFEventParameterParameterName.
  Например, AFEventParameterRevenue, AFEventParamaterContentId.

Мы настоятельно рекомендуем использовать эти константы по следующим причинам:

• Стандартное именование позволяет AppsFlyer автоматически сопоставлять события с сетями типа SRN, такими как Facebook, Google, Twitter и Snapchat.
• Обратная совместимость — если AppsFlyer решит изменить имя какого-либо события или параметра события, ваши настройки останутся совместимыми.

Чтобы использовать эти два интерфейса, нужно импортировать AppsFlyerTracker.h, если вы используете Objective-C, или AppsFlyerLib, если вы используете Swift:

#import AppsFlyerTracker.h

import AppsFlyerLib

См. список рекомендуемых имен событий и структур.

Данные о доходах можно отправлять с любым внутренним событием приложения. Используйте параметр сообщения af_revenue (AFEventParameterRevenue), чтобы включить доход во внутреннее событие приложения. Этому параметру можно присвоить любое числовое значение — как положительное, так и отрицательное.

af_revenue — это единственный параметр события, который AppsFlyer учитывает как реальный доход и отображает в отчетах по необработанным данным и на панели управления. Подробные сведения см. здесь.

При отправке событий с доходом необходимо учитывать следующее:

• При установке кода местной валюты (см. пример ниже) необходимо использовать код валюты из 3 букв по стандарту ISO 4217 (значение по умолчанию — USD).
• Вы можете настроить код валюты для всех событий, установив следующее свойство:
  • Objective-C: [AppsFlyerTracker sharedTracker].currencyCode = @"ZZZ";,
  • Swift: AppsFlyerTracker.shared().currencyCode = "ZZZ"
  Сведения о настройках валюты, отображении и конвертации валюты см. в нашем справочнике по валюте доходов.
• В значениях дохода нельзя использовать запятые-разделители, знаки валюты или текст. Событие дохода должно иметь, например, такой формат: 1234.56.

Пример: событие покупки в приложении с доходом

[[AppsFlyerTracker sharedTracker] trackEvent: @"cancel_purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @-200,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerTracker.shared().trackEvent("cancel_purchase", 
withValues: [
	AFEventParamContentId:"1234567",
	AFEventParamContentType : "category_a",
	AFEventParamRevenue: -200,
	AFEventParamCurrency:"USD"
]);

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

Регистрация отрицательного дохода

Возможны ситуации, в которых нужно зарегистрировать отрицательный доход.

Пример: пользователь приложения получает возмещение или отменяет подписку.

[[AppsFlyerTracker sharedTracker] trackEvent: @"cancel_purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @-1.99,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerTracker.shared().trackEvent("cancel_purchase", 
withValues: [
	AFEventParamContentId:"1234567",
	AFEventParamContentType : "category_a",
	AFEventParamRevenue: -1.99,
	AFEventParamCurrency:"USD"
]);

При покупках в приложении SDK AppsFlyer выполняет проверку на сервере. Чтобы проверить покупку, вызовите метод validateAndTrackInAppPurchase.

Если покупка проверена, этот запрос автоматически создает внутреннее событие приложения af_purchase.

Этот вызов содержит два блока обратного вызова — один для варианта «Успешно», а второй для варианта «Ошибочно» (по любой причине, включая сбой проверки). В случае сценария «успешно» словарь получит в ответ подтверждение контрольных данных, предоставляемых серверами Apple.  

Пример применения проверки покупки

- (void) validateAndTrackInAppPurchase:(NSString *) productIdentifier
price:(NSString *) price
currency:(NSString *) currency
transactionId:(NSString *) tranactionId
additionalParameters:(NSDictionary *) params
success:(void (^)(NSDictionary *response)) successBlock
failure:(void (^)(NSError *error, id reponse)) failedBlock;

[[AppsFlyerTracker sharedTracker] validateAndTrackInAppPurchase:@"ProductIdentifier" price:@"price"
    currency:@"USD"
    transactionId:@"transactionID"
    additionalParameters:@{@"test": @"val" , @"test1" : @"val 1"}
    success:^(NSDictionary *result){
      NSLog(@"Purchase succeeded And verified!!! response: %@", result[@"receipt"]);
    } failure:^(NSError *error, id response) {
      NSLog(@"response = %@", response);
      if([response isKindOfClass:[NSDictionary class]]) {
        if([response[@"status"] isEqualToString:@"in_app_arr_empty"]){
          // retry with 'SKReceiptRefreshRequest' because
          // Apple has returned an empty response
          // <YOUR CODE HERE>
        }

      } else {
        //handle other errors
        return;
      }
  }];

AppsFlyerTracker
      .shared()?
      .validateAndTrack(inAppPurchase: "productIdentifier",
                   price: "price",
                  currency: "currency",
               transactionId: "transactionId",
            additionalParameters: [:],
                  success: {
      guard let dictionary = $0 as? [String:Any] else { return }
      dump(dictionary)
    }, failure: { error, result in
      guard let emptyInApp = result as? [String:Any],
           let status = emptyInApp["status"] as? String,
             status == "in_app_arr_empty" else {
                // Try to handle other errors
                 return
               }
         
      // retry with 'SKReceiptRefreshRequest' because
      // Apple has returned an empty response
      // <YOUR CODE HERE>
    })

[AppsFlyerTracker sharedTracker].useReceiptValidationSandbox = YES;

AppsFlyerTracker.shared().useReceiptValidationSandbox = true

При проверке покупки в AppsFlyer автоматически отправляется событие покупки в приложении. Далее приведены примеры данных, которые передаются в параметре event_value:

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• Название события: до 45 символов
• Значение события: не более 1000 символов, более длинные сообщения могут быть урезаны
• В значениях цены и дохода можно использовать только цифры и десятичную точку, например 5 или 5.2.
• Значения цены и дохода могут иметь не более 5 знаков после десятичной точки, например 5.12345
• Неанглийские символы поддерживаются во внутренних события приложения и других SDK API, начиная с SDK для Android версии 4.8.1.

Для регистрации внутренних событий приложения используется вызов функции trackRichEvent с именем события и значениями параметров. Подробные сведения см. в статье о внутренних событиях приложения.

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

Пример: событие покупки в приложении

[[AppsFlyerTracker sharedTracker] trackEvent:AFEventPurchase
   withValues: @{
    AFEventParamRevenue: @200,
    AFEventParamCurrency: @"USD",
    AFEventParamQuantity: @2,
    AFEventParamContentId: @"092",
    AFEventParamReceiptId: @"9277"
  }];

AppsFlyerTracker.shared().trackEvent(AFEventPurchase,
  withValues: [
     AFEventParamRevenue: "200",
     AFEventParamCurrency: "USD",
     AFEventParamQuantity: @2,
     AFEventParamContent: "shoes",
     AFEventParamContentId: @"092",
     AFEventParamReceiptId: @"9277"]);

Если пользователь инициирует событие, когда подключение к Интернету недоступно, Appsflyer все же сможет записать это событие. Вот как это происходит:

1. SDK отправляет события на серверы AppsFlyer и ждет ответа.
2. Если SDK не получит ответа «200», событие будет помещено в кэш.
3. Если затем будет получен ответ «200», сохраненное событие отправляется на сервер повторно.
4. Если в кэше хранится несколько событий, они отправляются на сервер одно за другим без перерывов.

• Внутреннее событие приложения зарегистрировано успешно.
• При регистрации внутреннего события произошла ошибка.

 [[AppsFlyerTracker sharedTracker] trackEventWithEventName:AFEventPurchase
        eventValues: @{
          AFEventParamRevenue: @200,
          AFEventParamCurrency: @"USD",
          AFEventParamQuantity: @2,
          AFEventParamContentId: @"092",
          AFEventParamReceiptId: @"9277"
        }
        completionHandler:^(NSDictionary<NSString *,id> * _Nullable dictionary, NSError * _Nullable error){
            if(dictionary != nil) {
                NSLog(@"In app callback success:");
                for(id key in dictionary){
                    NSLog(@"Callback response: key=%@ value=%@", key, [dictionary objectForKey:key]);
                }
            }
            if(error != nil) {
                NSLog(@"In app callback error:", error);
            }
    }];
    

AppsFlyerTracker.shared().trackEvent(name: "In app event name", values: ["id": 12345, "name": "John doe"], completionHandler: { (response: [String : Any]?, error: Error?) in
             if let response = response {
               print("In app event callback Success: ", response)
             }
             if let error = error {
               print("In app event callback ERROR:", error)
             }
           })
        }
            

При нажатии на ссылку OneLink определяется тип устройства и пользователь перенаправляется в соответствующий пункт назначения, например на портал Google Play, в магазин приложений для iOS, на независимую торговую площадку или веб-страницу.

В руководстве по настройке OneLink рассматривается атрибуция с использованием многоплатформенных ссылок (программирование SDK не требуется). Эти ссылки можно также использовать для диплинкинга.

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

Настройку диплинкинга при помощи Onelink должны совместно выполнять маркетолог с доступом к панели управления AppsFlyer и разработчик с доступом к приложению.

См. наше руководство по настройке диплинкинга при помощи OneLink.

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

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

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

Дополнительные сведения см. в руководстве по отложенному диплинкингу.

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

Чтобы получать данные по диплинкингу, внедрите метод onAppOpenAttribution.

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

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

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

Пример использования

[[AppsFlyerTracker sharedTracker] trackAppLaunchWithCompletionHandler:^(NSDictionary<NSString *,id> *dictionary, NSError *error) {
        if (error) {
            NSLog(@"%@", error);
            return;
        }
        if (dictionary) {
            NSLog(@"%@", dictionary);
            return;
        }
    }];

 AppsFlyerTracker.shared()?.trackAppLaunch(completionHandler: { (dictionnary, error) in
            if (error != nil){
                print(error ?? "")
                return
            } else {
                print(dictionnary ?? "")
                return
            }
        })

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

Пример кода setAdditionalData:

NSDictionary* CustomDataMap = [[NSDictionary alloc] initWithObjectsAndKeys:@"value_of_param_1", @"custom_param_1", nil];
    
[[AppsFlyerTracker sharedTracker] setAdditionalData:CustomDataMap];

let CustomDataMap: [AnyHashable: Any] = [
   "custom_param_1" : "value_of_param_1"
]
        
AppsFlyerTracker.shared().customData = CustomDataMap

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

Чтобы установить минимальный интервал между сеансами, используйте этот API:

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <ваш_временной_интервал_в_секундах>;

AppsFlyerTracker.shared().minTimeBetweenSessions = <ваш_временной_интервал_в_секундах>

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

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

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

Чтобы преодолеть эту проблему, можно использовать API setResolveDeepLinkURLs. Этот API позволяет получать ссылки OneLink от доменов кликов, которые запускают приложение.  Этот API нужно обязательно вызвать перед инициализацией SDK.

Например, у вас есть три домена регистрации кликов, которые выполняют перенаправление на вашу ссылку OneLink по адресу https://mysubdomain.onelink.me/abCD. Используйте этот API для получения ссылки OneLink, на которую перенаправляют домены регистрации кликов. Этот метод API получает список доменов, разрешение которых выполняет SDK.

[AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]

Приведенный выше код позволяет использовать домен регистрации кликов, сохраняя при этом функциональные возможности OneLink. Домены регистрации кликов выполняют запуск приложения. API, в свою очередь, получает от этих доменов ссылку OneLink, после чего данные этой ссылки OneLink можно использовать для диплинкинга и персонализации пользовательского контента.

С помощью AppsFlyer можно выполнять измерения push-уведомлений при проведении кампаний по ретаргетингу.

Чтобы включить эту функцию, вызовите метод handlePushNotificationData внутри AppDelegate.m.

-(void) application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
	[[AppsFlyerTracker sharedTracker] handlePushNotification:userInfo];
  }

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
	AppsFlyerTracker.shared().handlePushNotification(userInfo)
}

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

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

Подробные сведения см. в статье Атрибуция приглашений пользователей.

Для каждой новой установки приложения AppsFlyer создает уникальный ID устройства. Вы можете использовать этот ID для различных целей:

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

Для получения уникального ID из AppsFlyer используйте следующий API:

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

let appsflyerId = AppsFlyerTracker.shared().getAppsFlyerUID()

Для установки собственного Customer User ID используйте такой код:

[AppsFlyerTracker sharedTracker].customerUserID = @"my user id";

AppsFlyerTracker.shared().customerUserID = "my user id"

В iOS идентификатор пользователя необходимо устанавливать с каждым запуском приложения. Рекомендуется установить свой ID клиента на раннем этапе продвижения приложения, так как после установки этого идентификатора только он привязывается к событиям, включаемым в отчеты:

• Если вызов setCustomerUserId выполняется перед вызовом trackAppLaunch, идентификатор клиента будет отображаться в отчетах по необработанным данным и для установок, и для событий.
• Если установить ID клиента позже, он будет привязан только к событиям, зарегистрированным после установки этого идентификатора.

Получение Customer User ID:

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

NSString *customerUserID = [AppsFlyerTracker sharedTracker].customerUserID;

let customerUserID = AppsFlyerTracker.shared().customerUserID

Для получения дополнительных сведений о Customer User ID щелкните здесь.

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

Можно отложить инициализацию SDK до настройки идентификатора customerUserID. Это полезно, если вы хотите, чтобы в ваших данных об установках и событиях содержался идентификатор пользователя.

Добавьте следующий код:

- (void)applicationDidBecomeActive:(UIApplication *)application {
    NSString *customUserId = [[NSUserDefaults standardUserDefaults] stringForKey:@"customerUserId"]; // Your custom logic of retrieving CUID
    if (customUserId != nil && ![customUserId  isEqual: @""]) {
        [AppsFlyerTracker sharedTracker].customerUserID = customUserId; // Set CUID in AppsFlyer SDK for this session
        [[AppsFlyerTracker sharedTracker] trackAppLaunch]; // Track App Launch
    }
}

func applicationDidBecomeActive(_ application: UIApplication) {
        let customUserId = UserDefaults.standard.string(forKey: "customUserId")  //  your logic to retrieve CUID
        if(customUserId != nil && customUserId != ""){
            AppsFlyerTracker.shared().customerUserID = customUserId // Set CUID in AppsFlyer SDK for this session
            AppsFlyerTracker.shared().trackAppLaunch() // Track App Launch
        }
    }

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

В исключительных случаях может потребоваться полное отключение отслеживания средствами SDK для соблюдения норм законодательства и правил конфиденциальности. Это может быть реализовано с помощью параметраisStopTracking . Когда для параметра установлено значение true, SDK прекратит работу и обмен данных с серверами AppsFlyer.

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

[AppsFlyerTracker sharedTracker].isStopTracking = true;

AppsFlyerTracker.shared().isStopTracking = true

В любом случае SDK можно активировать повторно путем вызова того же API с передачей значения "false".

Для реализации явной анонимизации установок, событий и сеансов пользователя используйте этот API во время инициализации SDK:

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

AppsFlyerTracker.shared().deviceTrackingDisabled = true

Если вам нужно запустить отслеживание снова, то вызовите еще раз deviceTrackingDisabled со значением false.