Реализация брендированных доменов

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

Брендированный домен, указывающий на серверы AppsFlyer

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

• Выберите полное доменное имя, например, click.abcdef.com, где abcdef.com — это название бренда.
  • Поддомен (например, click) также можно настроить.
• Попросите администратора DNS создать полный домен (хост). 
• Попросите администратора DNS настроить запись CNAME, чтобы полный домен (домен бренда) указывал на заданный URL-адрес (хост AppsFlyer). Это показано на схеме (выше): брендированная ссылка указывает на серверы AppsFlyer. 

Чтобы сопоставить ваш полный домен с поддоменом OneLink:

1. Перейдите в раздел Engagement & Deep Linking (Вовлечение и диплинкинг) > Branded Domains (Брендированные домены).
2. Нажмите Add Branded Domain (Добавить брендированный домен).
3. В поле Brand Domain (Домен бренда) введите полный домен, как в записи DNS. Например, click.abcdef.com
   Не ставьте точку после домена. 
4. Выберите поддомен OneLink из открывшегося списка. 
5. Нажмите Verify (Проверить).
   Отобразится статус настроек DNS. Если возникнет ошибка, см. раздел Поиск и устранение неполадок.
   

Чтобы проверить работоспособность брендированного домена: 

1. Перейдите в раздел Engagement & Deep Linking (Вовлечение и диплинкинг) > Branded Domains (Брендированные домены).
2. Выберите брендированную ссылку.
   Откроется окно редактирования.
3. Нажмите Verify (Проверить).
   Отобразится статус настроек DNS. У обеих должна быть зеленая галочка, подтверждающая, что они корректно заданы в записи DNS. Если отметка имеет не зеленый, а красный цвет, обратитесь к администратору DNS.
   Примечание. Чтобы создать для вашего домена сертификат (CAA), в записях DNS должно быть разрешено имя letsencrypt.org. 

• Используйте следующие версии SDK:
  
  • Android: 4.10.1 и выше
  • iOS: 4.10.1 и выше
  • Чтобы отслеживать приглашения пользователей по рекомендациям («Пригласите друга»), требуется SDK версии 5.2.0 и выше (как для iOS, так и для Android) 

Примечания по реализации поддержки брендированных доменов в SDK

• Если диплинкинг выполняется с использованием брендированных доменов, SDK AppsFlyer не может получить данные о конверсиях по установкам и диплинкингу.
• Чтобы решить эту проблему, разработчик использует API SDK setOneLinkCustomDomain and oneLinkCustomDomains для Android и iOS, соответственно.
• Этот API отправляет запрос по брендированной ссылке, получает ссылку OneLink, которой она сопоставлена, после чего направляет запрос OneLink для получения данных о конверсиях. Пример настройки. 

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();

      AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {

        // implement AppsFlyerConversionListener callbacks 
        // see https://support.appsflyer.com/hc/en-us/articles/207032126#integration-32-initializing-the-sdk

      }
      
      // set branded link domain
      AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com");
      AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
      AppsFlyerLib.getInstance().start(this, AF_DEV_KEY);

    }
}

AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com", 
                                                        "click.greatapp.com", 
                                                        "deals.greatapp.com");

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    /** APPSFLYER INIT **/
    [AppsFlyerLib shared].appsFlyerDevKey = @"SED_DEV_KEY";
    [AppsFlyerLib shared].appleAppID = @"123456789";
    [AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com"];
    //...
    //...
  }

[AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com", @"click.greatapp.com"];

   func application(_ application: UIApplication, didFinishLaunchingWithOptions 
        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
          AppsFlyerLib.shared().appsFlyerDevKey = "6CQi4Be6Zs9oNLsCusPbUL"
          AppsFlyerLib.shared().appleAppID = "340954504"
          AppsFlyerLib.shared().oneLinkCustomDomains = ["example.com"]
          //...
          //...
   }

AppsFlyerLib.shared().oneLinkCustomDomains = ["promotion.greatapp.com", "click.greatapp.com"]

Необходимые условия:

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

Чтобы создать и протестировать брендированные домены:

1. Создайте настраиваемую ссылку атрибуции с помощью шаблона OneLink, сопоставленного брендированному домену.
2. Скопируйте настраиваемую ссылку атрибуции в текстовый редактор.
3. Настраиваемая ссылка атрибуции состоит из поддомена OneLink, идентификатора OneLink и идентификатора настраиваемой ссылки. Замените поддомен OneLink полным доменом брендированного домена. Пример:
   

   Настраиваемая ссылка атрибуции	Брендированный домен
   abcdef.onelink.me/A1bc/dc1234ef	click.abcdef.com/A1bc/dc1234ef

4. Используйте брендированную ссылку для тестирования установок и диплинкинга.
5. Если в рамках тестирования вы используете отчеты с сырыми данными, в поле Original URL (Исходный URL-адрес) будут указаны брендированные ссылки. 

При редактировании вы можете сопоставить существующему полному домену другой поддомен OneLink. Задавать CNAME не требуется. 

Чтобы изменить сопоставление брендированного домена:

1. Перейдите в раздел Experiences & Deep Linking (Интерфейсы и диплинкинг) > Branded Domain (Брендированный домен).
2. Нажмите кнопку Action (Действие).
3. Нажмите Редактировать.

Чтобы удалить сопоставление брендированного домена: 

• Перейдите в раздел Experiences & Deep Linking (Интерфейсы и диплинкинг) > Branded Domain (Брендированный домен).
• Нажмите кнопку Action (Действие).
• Нажмите Удалить.