我们能为您提供什么帮助?

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

  • 更新

概要:使用OneLink链接的广告主可以为链接打上品牌域名,从而优化投放效果并提升品牌曝光。

Branded_1__3_.jpg

品牌域名

  • 如上图所示,品牌域名的原理就是使用您的品牌名称和域名为归因链接打上品牌标签。
    • OneLink链接:abcdef.onelink.me
    • 品牌:abcdef.com
    • 子域名:如“app”。
    • 写入品牌域名并使用完整域名,这样归因链接就变成了click.abcdef.com
  • 品牌域名的下列优势可以推动投放效果的优化:
    • 提升用户信任度:充分发掘品牌价值,贯彻始终如一的品牌认知,打造无摩擦的用户链路,最终提升转化率。
    • 可以让您在深度链接中使用品牌标签。
    • 简单易用,具有与OneLink相同的功能。
    • 提升品牌知名度: 摈弃泛型链接,用品牌来标记您的广告。
    • 进行邮件营销时无需担心链接与发件人的邮箱不匹配而被标记为垃圾邮件。
    • AppsFlyer付费订阅计划包含品牌域名。

部署原理

品牌域名的作用原理是将您在Domain Name System(域名系统,简称DNS)中定义的完整域名关联到某个OneLink子域名(AppsFlyer CNAME)。您需要在DNS中使用标准设置,并在AppsFlyer后台设置一个品牌域名。此外,您还需要对应用作一些微调,使其支持品牌域名。 

具体的部署工作需要DNS管理员的协助,DNS管理员通常是您的IT团队成员或DNS托管服务商以及应用开发人员。 

一个OneLink子域名可关联多个完整域名。也就是说,同一个OneLink子域名可用于多个品牌。 

品牌域名的设置

下表列出了品牌域名的设置流程。 

  负责人员 操作 说明
1 DNS管理员协助市场人员完成 在AppsFlyer后台设置一条品牌链接 DNS管理员(通常是您的IT团队成员或DNS托管服务商)需要定义完整域名(即host)并按下文流程中所述的方法设置CNAME记录。
2 开发人员 在应用中设置品牌域名 对应用代码进行微调。
3 营销人员 使用并测试品牌域名  
按需 营销人员 修改或删除品牌域名  

设置流程

在AppsFlyer后台设置品牌域名的说明文档。

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

指向AppsFlyer服务器的品牌域名

前期准备:

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

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

  1. 在 AppsFlyer 中,点击“互动” > “品牌域名” 。
  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天的映射期限。

  7. 点击完成。完成以上步骤后,您就可以使用您的品牌域名在该OneLink模板下创建新链接。

     注意

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

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

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

 注意

如果您在7天的期限过期后完成了CNAME记录的映射,仍需刷新7天的映射期限,否则新建的品牌域名无法正常生效。

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

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

 注意

如果您决定不刷新7天的映射期限,可以点击删除图标(delete-subdomain.png)删除该品牌域名。您只能删除尚未映射到AppsFlyer的品牌域名。

自定义 SSL 证书(可选)

AppsFlyer 管理的 SSL 是大多数客户的默认和推荐选项,无需额外操作,因为 AppsFlyer 会自动处理证书颁发和续订。如果您有特定的安全或合规性要求,您可以选择使用您自己的 SSL 证书颁发机构(自定义 SSL 证书)而不是 AppsFlyer 管理的 SSL。如果您选择此选项,您将负责颁发、上传、维护和续订证书。如果证书过期且未及时续期,服务可能会中断。

要使用自定义 SSL 证书: 

  1. 创建品牌域名。 
  2. 在 AppsFlyer 中,从“互动” > “品牌域名”中,将鼠标悬停在相关域名上,然后选择“自定义 SSL 证书”图标。 
    SSL证书图标 最新极简.png

     

  3. 填写证书详情表。 
    填写表格以生成 CSR 文件.png

     

  4. 点击“下载 CSR”下载您刚刚填写的表格副本。
    下载CSR文件
  5. 请将您刚刚下载的 CSR 文件提供给您选择的 SSL 证书颁发机构。 
  6. 一旦他们给你新的 SSL 证书,就把它上传回 AppsFlyer。 
上传新的 SSL 证书到 AF.png

注意

请关注SSL证书的有效期限。您需在当前证书到期前完成续期,并将更新后的证书上传至AppsFlyer

在应用中设置品牌域名

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

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

  • 使用品牌域名的深度链接生效时,AppsFlyer SDK无法获取激活和深度链接的转化数据。
  • 如需克服这个问题,开发人员可以根据相关应用的操作平台分别使用setOneLinkCustomDomain(安卓)和oneLinkCustomDomains(iOS)这两个SDK API。
  • 该API会查询品牌域名,获取品牌域名所映射的OneLink域名,并将品牌域名填入OneLink。
Android iOS

请务必更新manifest的intent-filter,设置android:host,以确保其中包含您的品牌域名。

请在Android global application class中使用该API,并将其设置在SDK初始化之前。

示例

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);

    }
}

如果您有多个品牌域名,请将所有的品牌域名都传递到该API,以确保您总是可以获取相关的转化数据,并深度链接到应用中。

示例

AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com", 
                                                        "click.greatapp.com", 
                                                        "deals.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. 从AppsFlyer后台的左侧的菜单栏中选择互动 > 品牌域名。
  2. 进入您需要编辑的品牌域名。
  3. 点击编辑图标(edit-subdomain.png)。
  4. 选择新建的OneLink子域名。
  5. 点击下一步。无需再设置一个CNAME。
  6. 点击完成。

警告

修改在投广告的品牌域名可能会使链接功能发生变化或失效。

验证品牌域名的映射

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

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

 注意

如果由于CNAME记录尚未映射而导致验证失败,请在验证失败的消息弹窗中指定的日期之前(即7天内)完成映射。
如果相关的CNAME记录在截止日期前未完成映射,您需要刷新7天的映射期限。

域名CNAME记录不再指向AppsFlyer

如果您将CNAME记录修改为不再指向AppsFlyer,您的品牌域名将被AppsFlyer中删除。

删除品牌域名的映射

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

问题排查、特点和局限性

问题排查

问题表现 原因/解决方法
品牌域名无法映射到OneLink模板
  • 域名无效:将品牌域名映射到OneLink模板时,AppsFlyer会验证该品牌链接中的域名是否有效。有效域名的格式应为:click.abdef.com 
  • 该品牌域名已映射:一个完整域名只能映射一次。
品牌域名无法深度链接到应用中
  • 请检查该品牌域名是否在正常使用中
  • 验证CNAME:确保有CNAME记录从您的品牌域名指向AppsFlyer。
  • 验证OneLink模板的深度链接设置:出现该问题可能是因为OneLink的深度链接设置有误。请确保您已使用OneLink设置深度链接。
  • OneLink映射变更:您可以修改品牌域名,将其映射到另一个OneLink。如果新映射的OneLink的深度链接设置不同于之前的OneLink,或没有深度链接设置,则深度链接可能无法生效。
未记录到来自品牌域名的激活
  • 检查OneLink模板的设置:确保映射到品牌域名的OneLink子域名所关联的应用正确无误。
  • OneLink子域名变更:如果您的品牌域名所映射的OneLink模板或OneLink子域名发生变更,可能会影响归因。
  • 确保在应用中写入了setOneLinkCustomDomain API。 
未记录到来自品牌域名的再互动

确保以下各项已配置完毕并已激活: 

在设置品牌域名的过程中界面提示“该域名不存在”。
  1. 联系您的DNS管理员并让他们检查问题所在。
  2. 等待DNS管理员确认该域名已注册完毕。 
  3. 点击重新验证。
在设置品牌域名的过程中界面提示“未找到AppsFlyer CNAME”
  1. 让DNS管理员设置一个CNAME记录,让完整域名(即品牌域名)指向指定链接(即AppsFlyer host)。即如本文开头的图中所示,品牌链接指向AppsFlyer服务器。 
  2. 等待DNS管理员确认该CNAME已激活。
加载带有品牌域名的页面时提示您已被屏蔽

由于品牌域名中不包含相关模板或任何参数,因此在使用品牌域名时,您必须在该品牌域名URL的末尾添加相关模板或参数。

举例来说,假设您的品牌域名为“click.abcdef.com”,当您仅使用“click.abcdef.com”时,就会出现您已被屏蔽的报错。

您必须在其末尾添加参数或模板,如click.abcdef.com/A1bc/dc1234ef

 

加载带有品牌域名的页面时出现err_cert_authority_invalid报错

出现该报错是因为Certificate Authority无法识别,说明您的品牌域名缺少有效的HTTP证书。由于AppsFlyer会使用Let’s Encrypt来为您的品牌域名签发证书,因此出现这类错误很可能是因为Let's Encrypt未能通过您域名的CAA(Certification Authority Authorization,证书颁发机构授权)DNS记录被识别为有效的Certificate Authority(CA)。

解决方案
请完成以下操作:

  1. 通过此类服务平台确认您的域名是否能将Let’s Encrypt识别为有效的CA。
  2. 让您的系统管理员更您的域名CAA记录,在其中添加Let's Encrypt,将其作为授权CA。

特点与局限性

特点 是 ✓ / 否 x 说明 
相关账户下的用户权限 ✓  
渠道权限  x  
代理访问权限 x 代理无法创建品牌域名(或OneLink链接)。
代理数据透明化 x  
应用层级的指定货币  不适用  
应用层级的指定时区 不适用  
品牌域名可用性 不适用 品牌域名仅适用于符合条件的付费套餐。如果您的订阅计划到期或被取消,则对品牌域名的访问权限将被移除,并且使用您的品牌域名的现有链接将无法工作。
字符限制 不适用 输入您的品牌域名时,最后一个字符不能为句点(“.”)。
数据时效性 不适用   
历史数据 ✓  
HTTP x 品牌链接不支持超文本传输协议(HTTP),必须使用超文本传输安全协议(HTTPS)。
非自然量数据 ✓  
自然量数据 ✓  
拉取频次限制 ✓ 品牌域名的SSL/HTTP证书是由AppsFlyer通过Let's Encryp提供的,每个域名每周最多可获取50个新证书。
大小限制 不适用  
SSL/HTTP证书更新 ✓ 由AppsFlyer管理的品牌域名SSL/HTTP证书会自动更新,无需您执行任何操作。