使用iOS Custom URL Scheme集成Instagram Stories分享时，如何添加归因链接？

问题背景 #

我在Flutter应用中通过iOS Custom URL Schemes集成了分享至Instagram Stories的功能，遵循Meta官方指南实现，当前功能运行正常。但希望为分享的Instagram Story添加归因链接，让用户点击后能打开应用内对应内容（类似SoundCloud分享故事的跳转效果），Meta官方指南未提及该实现方式，寻求解决方案。

当前使用的Swift调用代码：

private func shareStickerImage(appID: String, stickerImage: Data, backgroundTopColor: String, backgroundBottomColor: String) {
        do{
            guard let urlScheme = URL(string: "instagram-stories://share?source_application=\(appID)") else {
                return //"Creating url scheme failed"
            }

            if UIApplication.shared.canOpenURL(urlScheme) {
                let pasteboardItems: [[String: Any]] = try [
                    [
                        "com.instagram.sharedSticker.stickerImage": stickerImage,
                        "com.instagram.sharedSticker.backgroundTopColor": backgroundTopColor,
                        "com.instagram.sharedSticker.backgroundBottomColor": backgroundBottomColor
                    ]
                ]

                let pasteboardOptions: [UIPasteboard.OptionsKey: Any] = try [
                    .expirationDate: Date().addingTimeInterval(60 * 5)
                ]

                try UIPasteboard.general.setItems(pasteboardItems, options: pasteboardOptions)
               try  UIApplication.shared.open(urlScheme, options: [:], completionHandler: nil)
            } else {
                return
                // Handle error cases
            }
        }catch{
            print("error")
        }
       
        return
        
    }

实现方案 #

要添加可跳转回应用的归因链接，只需在粘贴板的分享数据中添加com.instagram.sharedSticker.linkUrl字段，同时确保你的应用已配置好对应的URL Scheme（或Universal Links），让Instagram能正确唤起你的应用。

修改后的Swift代码如下：

private func shareStickerImage(appID: String, stickerImage: Data, backgroundTopColor: String, backgroundBottomColor: String, deepLinkUrl: String) {
        do{
            guard let urlScheme = URL(string: "instagram-stories://share?source_application=\(appID)") else {
                return
            }

            if UIApplication.shared.canOpenURL(urlScheme) {
                let pasteboardItems: [[String: Any]] = try [
                    [
                        "com.instagram.sharedSticker.stickerImage": stickerImage,
                        "com.instagram.sharedSticker.backgroundTopColor": backgroundTopColor,
                        "com.instagram.sharedSticker.backgroundBottomColor": backgroundBottomColor,
                        // 添加归因跳转链接
                        "com.instagram.sharedSticker.linkUrl": deepLinkUrl
                    ]
                ]

                let pasteboardOptions: [UIPasteboard.OptionsKey: Any] = try [
                    .expirationDate: Date().addingTimeInterval(60 * 5)
                ]

                try UIPasteboard.general.setItems(pasteboardItems, options: pasteboardOptions)
                try UIApplication.shared.open(urlScheme, options: [:], completionHandler: nil)
            } else {
                // 处理未安装Instagram的情况
                return
            }
        }catch{
            print("分享失败：\(error.localizedDescription)")
        }
    }

关键说明 #

• deepLinkUrl参数：传入你的应用已注册的自定义URL Scheme（例如yourapp://content/123）或Universal Links（例如https://yourapp.com/content/123），确保该链接能正确唤起应用并跳转到对应内容页面。
• 应用URL Scheme配置：在iOS项目的Info.plist中添加URL Scheme，示例：

  <key>CFBundleURLTypes</key>
  <array>
      <dict>
          <key>CFBundleURLSchemes</key>
          <array>
              <string>yourapp</string>
          </array>
      </dict>
  </array>
  

• 测试注意事项：
  • 确保测试设备已安装Instagram应用
  • 跳转链接需符合苹果的Deep Link规范，避免被系统拦截
  • 若使用Universal Links，需完成苹果开发者后台的关联域名配置

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