Branch.io深度链接从Facebook广告跳转App无法传递数据的技术问询

先回顾你已完成的操作流程 #

Branch控制台配置

• 进入「广告」→「合作伙伴管理」→「Facebook」，创建了Facebook专属深度链接
• 在「Deep Linking」板块的键值对中配置了需要传递给App的自定义数据
• 为Android/iOS分别设置了应用商店URL，或在「Redirects」板块配置了默认重定向规则

Facebook广告管理工具配置

• 创建应用安装广告系列时，在应用板块选择了对应平台的应用商店
• 完成了广告系列的基础设置（受众、预算等）

针对性排查步骤 #

下面是几个常见的故障点，你可以逐一验证：

1. 确认Branch链接的自定义数据是否生效

   • 打开Branch控制台，找到你创建的Facebook链接，进入「Deep Linking」板块检查键值对：确保键名拼写、大小写和App内接收逻辑完全一致，且数据已正确保存
   • 使用Branch内置的「Link Debugger」工具测试该链接，查看返回的payload中是否包含你配置的自定义字段。如果这里没有，说明链接本身配置有问题，需要重新保存配置

2. 检查Facebook广告的链接配置

   • 登录Facebook广告管理工具，找到对应的广告系列，确认广告中使用的跳转链接完全是Branch生成的Facebook专属链接，没有误填成普通链接或其他Branch链接
   • 验证广告目标是否为「应用安装」，且关联的App和Branch控制台中配置的App完全一致，避免因应用不匹配导致链接解析异常

3. 验证App内Branch SDK的参数接收逻辑

   • 确认Branch SDK已正确初始化：Android端需在onStart()方法中完成初始化，iOS端要在application(_:continue:restorationHandler:)中处理链接回调
   • 检查参数读取代码：比如Android用Branch.getInstance().getLatestReferringParams()，iOS用branchUniversalObject?.resolveDeepLink(...)获取参数，确保代码中没有遗漏目标字段的读取
   • 建议在App内添加日志打印，输出接收到的所有Branch参数，确认是否为空或缺少预期的自定义数据

4. 排查Branch的重定向与路由规则

   • 进入Branch控制台的「Redirects」板块，检查默认重定向规则：如果设置了「强制跳转到应用商店」，会导致已安装App的用户无法直接打开App，进而无法接收参数。需确保「当App已安装时」的路由行为是打开App
   • 测试实际跳转场景：用已安装App的设备点击广告，观察是否直接打开App，还是跳转到应用商店。如果是后者，调整路由规则即可

5. 检查Facebook与Branch的归因集成

   • 回到Branch控制台的Facebook合作伙伴设置页面，确认已开启归因同步，且正确配置了Facebook的App ID和密钥
   • 归因配置错误会导致Branch无法正确解析Facebook广告的上下文参数，进而无法传递自定义数据，这一步容易被忽略，务必仔细核对

内容的提问来源于stack exchange，提问作者Manish Sapkal