带有自定义域名的OneLink品牌链接

设置品牌域名的实质就是将您DNS中的完整域名组关联到AppsFlyer中的某个OneLink子域名，如下图所示。

指向AppsFlyer服务器的品牌域名

前期准备：

• 确定一个完整域名，如app.abcdef.com，
  其中abcdef.com代表您的品牌。您也可以根据实际情况自行配置子域名（如上述示例中的app）。
• 让DNS管理员创建该完整域名（即host）。
• 让DNS管理员设置一个CNAME记录，
  让完整域名（即品牌域名）指向特定的URL（即AppsFlyer服务器）。
  即如上图中所示，品牌域名指向AppsFlyer服务器。

将您的完整域名映射到OneLink子域名：

1. 进入用户体验与深度链接 > 品牌域名。
2. 点击+添加品牌域名。
3. 在品牌域名字段中输入您在DNS中设定的完整域名，比如click.abcdef.com Note:切勿在域名后加句点（.）。
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场景中使用品牌域名，请选择使用品牌域名配置ESP，然后再复制CNAME。
7. 点击完成。完成以上步骤后，您就可以使用您的品牌域名在该OneLink模板下创建新链接。

    注意

   • 如果您已经基于OneLink模板创建了不含品牌域名的链接，这些链接仍然有效。
   • 品牌域名从创建到生效最长需要24小时。

刷新CNAME记录的7天映射期限

如果完整域名的CNAME记录未在品牌域名创建后的7天内映射到AppsFlyer，则新建的品牌域名无法生效。

7天映射期限的刷新方式如下：

1. 从AppsFlyer后台的左侧的菜单栏中选择互动 > 品牌域名。
2. 找到尚未映射到AppsFlyer的品牌域名。您可以通过警示图标（）定位到相关域名。
3. 点击刷新图标（），刷新7天的映射期限。

• 请使用以下SDK版本：
   
  • 安卓：V4.10.1及以上
  • iOS：V4.10.1及以上
  • 如需在用户邀请推荐（邀请好友）场景中使用品牌域名，安卓和iOS都需要使用V5.2.0及以上的SDK 

接入品牌域名SDK时的注意事项

• 使用品牌域名的深度链接生效时，AppsFlyer SDK无法获取激活和深度链接的转化数据。
• 如需克服这个问题，开发人员可以根据相关应用的操作平台分别使用setOneLinkCustomDomain（安卓）和oneLinkCustomDomains（iOS）这两个SDK API。
• 该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 ID和自定义Link ID组成。将OneLink子域名替换为完整域名。请参考下方示例：
    

   自定义归因链接	品牌域名
   abcdef.onelink.me/A1bc/dc1234ef	click.abcdef.com/A1bc/dc1234ef

4. 使用品牌链接测试激活和深度链接。
5. 如果您在测试过程中使用原始数据报告，则会在Original URL字段中看到品牌链接。 

请按以下步骤修改品牌域名的映射：

您可以修改现有完整域名的映射，将其关联到另一个OneLink子域名，无需再设置一个CNAME。

1.  
   1. 从AppsFlyer后台的左侧的菜单栏中选择互动 > 品牌域名。
   2. 进入您需要编辑的品牌域名。
   3. 点击编辑图标（）。
   4. 选择新建的OneLink子域名。
   5. 点击下一步。无需再设置一个CNAME。
   6. 点击完成。

验证品牌域名的映射

如果您更改了映射到您品牌域名的OneLink子域名，请验证该品牌域名的映射可正常生效：

1. 从AppsFlyer后台的左侧的菜单栏中选择互动 > 品牌域名。
2. 进入您想要验证的品牌域名。
3. 点击验证图标（）。

删除品牌域名的映射

如需删除某个品牌域名，请联系您的CSM或发邮件至hello@appsflyer.com。