Брендирование ссылок OneLink с помощью собственного домена

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

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

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

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

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

1. Перейдите в раздел Experiences & Deep Linking (Интерфейсы и диплинкинг) > Branded Domains (Брендированные домены).
2. Нажмите + New Branded Domain (Новый брендированный домен).
3. В поле Brand Domain (Домен бренда) введите полный домен, как в записи DNS. Например, click.abcdef.com Не ставьте точку после домена. 
4. Выберите поддомен OneLink из открывшегося списка. Если список не
   отображения, вам нужно создать шаблон OneLink, который обеспечит
   поддомен по умолчанию.
5. Нажмите Далее.
6. Задайте запись CNAME:
   • Если ваш домен правильно указан на AppsFlyer CNAME,
     в месте назначения появится сообщение "AppsFlyer CNAME was found" (запись AppsFlyer CNAME найдена).
   • Если запись CNAME не найдена, скопируйте пункт назначения AppsFlyer CNAME ниже и отправьте вашему админу DNS. Попросите его проверить, что полный домен указывает на пункт назначения CNAME. Администратор DNS должен привязать ваш полный домен к месту назначения AppsFlyer CNAME. Иначе брендированный домен будет создан, но он не будет работать.

      Примечание:

     Запись CNAME должна быть сопоставлена в течение 7 дней, начиная с даты создания брендового домена и заканчивая датой, указанной в подтверждении.
     Если запись CNAME не будет сопоставлена к указанной дате, вы должны
     продлить 7-дневный период.

   • Если вы используете брендированный домен для ESP, перед копированием пункта назначения CNAME выберите Использовать брендированный домен для конфигурации ESP.
7. Нажмите Готово. Теперь вы можете создавать новые ссылки на основе шаблона OneLink с брендированным доменом.

    Примечание:

   • Если вы уже создали ссылки на основе шаблона OneLink без брендированного домена, они все равно будут работать.
   • Новый брендированный домен начинает работать в течение 24 часов.

Продление 7-дневного периода для сопоставления записи CNAME

Новый брендированный домен не будет работать, если запись CNAME вашего полного домена не будет сопоставлена с AppsFlyer в течение 7 дней после создания брендированного домена.

Чтобы продлить 7-дневный период:

1. В AppsFlyer в боковом меню выберите Engage > Branded Domains.
2. Перейдите на брендовый домен, который еще не сопоставлен с AppsFlyer, на что указывает значок предупреждения ().
3. Нажмите на значок обновления (), чтобы продлить 7-дневный период.

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

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

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

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();
      
      // Set branded link domain. Don't include https:// as part of the 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 с помощью шаблона OneLink, сопоставленного брендированному домену.
2. Скопируйте настраиваемую ссылку атрибуции в текстовый редактор.
3. Настраиваемая ссылка атрибуции состоит из поддомена OneLink, идентификатора OneLink и идентификатора настраиваемой ссылки. Замените поддомен OneLink полным доменом брендированного домена. Пример:
    

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

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

Редактирование сопоставления брендированных доменов

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

1.  
   1. В AppsFlyer в боковом меню выберите Engage > Branded Domains.
   2. Перейдите к брендированному домену, который вы хотите изменить.
   3. Щелкните значок Edit ().
   4. Выберите новый поддомен OneLink.
   5. Нажмите Далее. Задавать CNAME не требуется. 
   6. Нажмите Готово.

Проверка сопоставления брендированных доменов

После изменения поддомена OneLink, сопоставленного с вашим брендированным доменом, проверьте, правильно ли сопоставлен брендированный домен:

1. В AppsFlyer в боковом меню выберите Engage > Branded Domains.
2. Перейдите к брендированному домену, который вы хотите проверить.
3. Щелкните значок Verify ().

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

Для удаления брендированного домена обратитесь к своему CSM AppsFlyer или напишите на электронный адрес hello@appsflyer.com.