品牌域名

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

指向AppsFlyer服务器的品牌域名

前期准备：

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

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

1. 进入用户体验与深度链接 > 品牌域名。
2. 点击+添加品牌域名。
3. 在品牌域名字段中输入您在DNS中设定的完整域名，比如click.abcdef.com
   切勿在域名后加句点（.）。
4. 在界面所示的列表中选择相关的OneLink子域名。若界面中未显示列表，则表示您需要创建一个OneLink模板，创建完毕后就会呈现一个默认子域名。
5. 点击下一步。
6. 设置一个CNAME记录：
   • 如果您的域名成功指向了AppsFlyer CNAME，界面会显示“找到了AppsFlyer CNAME“的消息。
   • 如果未找到CNAME，请复制相关的AppsFlyer CNAME并将其发送给您的DNS管理员，让他们确保您的完整域名指向这个CNAME。您必须将您的完整域名指向一个AppsFlyer CNAME，否则您创建的品牌域名将无法生效。
     
     如果您在ESP场景中使用品牌域名，请选择使用品牌域名配置ESP，然后再复制CNAME。
7. 点击完成。
   完成以上步骤后，您就可以使用您的品牌域名在该OneLink模板下创建新链接。

注意：

• 如果您已经基于OneLink模板创建了不含品牌域名的链接，这些链接仍然有效。
• 品牌域名从创建到生效最长需要24小时。
• 若您未在7天内设置CNAME记录，您的品牌域名就会失效。发生这种情况时，您需要先刷新您的品牌域名，然后才能使用该域名。刷新品牌域名的方式如下：
  1. 进入用户体验与深度链接 > 品牌域名。
  2. 进入您需要刷新的品牌域名。
  3. 点击刷新。
  4. 设置一个CNAME记录。

• 请使用以下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. 进入用户体验与深度链接 > 品牌域名。
2. 进入您需要编辑的品牌域名。
3. 点击编辑。

请按以下步骤删除品牌域名映射：

• 请联系您的CSM或发邮件至hello@appsflyer.com。