Расширение для SDK Adobe Launch

1. На дэшборде вашего приложения нажмите Настройки приложения в разделе Конфигурация в левом меню.
2. В разделе Установка SDKскопируйте Ключ разработчика.

• Для Android ID приложения — это имя пакета, например example.com.app.
• Для iOS ID приложения — это ID приложения в iTunes без префикса id, например 123456748.

1. Войдите в Adobe Experience Cloud.
2. Выберите Launch (Запуск).
3. Нажмите Go to Launch (Перейти к запуску).
4. Нажмите New Property (Новое свойство).
5. Дайте свойству имя и выберите Mobile (Мобильный).
6. Нажмите кнопку Save (Сохранить)

Установите следующие расширения в Adobe Launch:

• Adobe Analytics соединяет записанные данные из SDK с модулем Adobe Analytics.
• AppsFlyer SDK Extension отправляет данные и события в Adobe и AppsFlyer с помощью Adobe Launch SDK.
• Adobe Profile позволяет SDK сохранять данные в профиле на стороне клиента.
• Adobe Mobile Core позволяет настраивать мобильный SDK и предоставляет доступ к событиям и условиям жизненного цикла по умолчанию.

Установка расширения Adobe Analytics

1. Войдите в Adobe Analytics.
2. Создайте набор отчетов.
3. Снова войдите в Adobe Launch.
4. В списке свойств нажмите на свойство, которое вы создали ранее.
5. Нажмите Extensions (Расширения).
6. Найдите и установите Adobe Analytics.
7. Под Наборами отчетовукажите набор отчетов, который вы создали в шаге 2.
8. Нажмите кнопку Save (Сохранить)

Установка расширения AppsFlyer SDK

1. Выберите Расширения снова.
2. Найдите и установите AppsFlyer SDK Extension.
3. В разделе AppsFlyer iOS App ID укажите идентификатор приложения для iOS, который вы получили на этапе предварительных условий.
4. В разделе AppsFlyer Dev Key укажите ключ разработчика, полученный на этапе предварительных условий.
5. Включите Отправка данных об атрибуции в Adobe Analytics. Обратите внимание, что существуют некоторые ограничения на передачу данных на уровне пользователя сторонним аналитическим платформам.
6. Нажмите кнопку Save (Сохранить)

Установите расширение Profile и Mobile Core

1. Выберите Расширения снова.
2. Найдите и установите Профиль.
3. Найдите и установите Mobile Core.
   • При установке Mobile Core просто сохраните расширение как есть. Нет необходимости указывать Experience Cloud Server (Сервер Experience Cloud).

1. Внутри свойств Adobe выберите Environments (Среды).
2. Выберите среду, для которой вы хотите развернуть SDK.
3. С правой стороны нажмите на значок коробки.
4. Скопируйте фрагменты кода из открывшегося окна и следуйте инструкциям. Если вы маркетолог, настраивающий Adobe, отправьте эти фрагменты кода своему разработчику приложений.

Чтобы завершить реализацию SDK, необходимо опубликовать среду в библиотеке.

1. Внутри свойств Adobe выберите Publishing (Публикация).
2. Нажмите Add New Library (Добавить новую библиотеку).
3. Дайте ей имя и в разделе "Environment" выберите Development (Разработка).
4. Нажмите Save & Build for Development (Сохранить и собрать для разработки). 
5. После завершения сборки в разделе Developmentнажмите на три точки рядом с библиотекой и выберите Submit for Approval (Отправить на утверждение).
6. В разделе Submitted (Отправленные) нажмите на три точки рядом с библиотекой и выберите Build for Staging (Собрать для стейджинга).
7. Когда сборка завершится, нажмите на три точки рядом с библиотекой и выберите Approve for Publishing (Утвердить для публикации).
8. Под кнопкой Утвердитьнажмите на три точки рядом с библиотекой и выберите Build & Publish to Production (Собрать и опубликовать в продакшн).

Инициатор установки для Android повышает точность атрибуции, защищает от мошеннических установок, а также выполняет другие функции. Его поддержка в SDK AppsFlyer для Android предусмотрена начиная с версии 4.8.6.

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

• С помощью системы Gradle (рекомендуется)
• Добавление инициатора установки вручную

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

Добавление необходимых разрешений

1. Добавьте в файл AndroidManifest.xml эти разрешения:
   

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <!-- Optional : -->
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   

Отслеживая события внутри приложения, можно понять, что в нем происходит. Рекомендуется заранее определить, какие события нужно регистрировать. Регистрация внутренних событий приложения позволит измерять такие KPI, как ROI (окупаемость инвестиций) и LTV (суммарная прибыль от пользователя).

Расширение Adobe Launch SDK позволяет отправлять данные о событиях в приложении как в Adobe, так и в AppsFlyer. Затем вы можете использовать Adobe Analytics для анализа поведения пользователей и AppsFlyer для анализа ROI и LTV.

final Map<String,String> eventMap = new HashMap<>();  
eventMap.put("currency", "USD");  
eventMap.put("revenue", "200");  
eventMap.put("freehand", "param");

MobileCore.trackAction("af_purchase", eventMap);

[ACPCore trackAction:@"af_purchase data:@{@"revenue":@"200",@"currency":@"USD"];

Отправка событий, как указано в приведенном выше коде, создает на дэшборде AppsFlyer событие af_purchase с доходом в 200 долларов. Это событие также отправляется и отображается в Adobe Analytics.

Все данные о конверсиях, отправляемые вместе с событиями, имеют префикс appsflyer. Подробнее см. в таблице ниже.

Данные о конверсиях используются в приложении, которое вы создаете в Adobe Mobile Services. Существуют и другие параметры, которые могут появляться в данных о конверсиях. Подробнее см. тут.

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

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

AppsFlyerAdobeExtension.registerAppsFlyerExtensionCallbacks(new AppsFlyerExtensionCallbacksListener() {
		@Override
		public void onCallbackReceived(Map<String, String> callback) {
			Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			if(callback.get("callback_type").equals("onConversionDataReceived")){
				// conversion data returned 
				if(callback.get("is_first_launch").equals("true")){
					String af_status = callback.get("af_status");
					if(af_status.equals("Non-organic")){
						Log.d(AppsFlyerLibCore.LOG_TAG, "this is first launch and a non organic install!");
					}
				}
			} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
				// direct deeplink - redirect user
				Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			}
		}
		@Override
		public void onCallbackError(String errorMessage) {
			Log.d("TAG", errorMessage);
		}
	});

[AppsFlyerAdobeExtension registerCallbacks:^(NSDictionary *dictionary) {
        NSLog(@"[AppsFlyerAdobeExtension] Received callback: %@", dictionary);
        if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onConversionDataReceived"]){
            if([[dictionary objectForKey:@"is_first_launch"] boolValue] == YES){
                NSString* af_status = [dictionary objectForKey:@"af_status"];
                if([af_status isEqualToString:@"Non-organic"]){
                    NSLog(@"this is first launch and a non organic install!");
                }
            }
        } else if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onAppOpenAttribution"]) {
            NSLog(@"onAppOpenAttribution Received");
        }
     }];
    [AppsFlyerAdobeExtension callbacksErrorHandler:^(NSError *error) {
          NSLog(@"[AppsFlyerAdobeExtension] Error recieving callback: %@" , error);
    }];