方法 1：本地 JavaScript SDK 实现选项：

Singular Web SDK 为 Web 到应用程序转发提供了两个 JavaScript 函数。 选择最适合你的实现方法：

选项 A：openApp() - 自动重定向

当您想立即将用户重定向到您的应用程序（或应用程序商店，如果未安装）时，请使用此方法。

// Basic usage - redirect to app with web parameters
singularSdk.openApp("https://mydomain.sng.link/Buour/55cx");

// With deep link to specific content
singularSdk.openApp(
  "https://mydomain.sng.link/Auour/55ba", 
  "product/12345",
  null,
  "product/12345"
);

选项 B：buildWebToAppLink() - 手动控制

如果您想构建链接，但又想控制何时/如何触发链接，请使用此方法。

// Build link and assign to button
const webToAppLink = singularSdk.buildWebToAppLink(
  "https://mydomain.sng.link/Buour/55cx"
);

document.getElementById("download-btn").href = webToAppLink;

// Or redirect programmatically
window.location.href = webToAppLink;

方法 2：Google 标签管理器 SDK 实施选项

当您想在不直接修改网站代码的情况下管理网络到应用程序的链接时，GTM 是理想的实施方法。有两种方法：

选项 A：动态链接替换（推荐）

在 Web SDK 初始化后自动更新页面上的所有奇异链接。

1. 在 GTM 中创建一个新的自定义 HTML 标签
2. 使用标签序列将其配置为在奇异初始化标签之后触发
3. 粘贴以下代码：

<script>
(function() {
  // Replace with your Web-to-App baselink
  var baseLink = "https://mydomain.sng.link/Auour/55ba";
  
  // Extract optional parameters from URL
  var urlParams = new URLSearchParams(window.location.search);
  var deeplink = urlParams.has('_dl') ? decodeURIComponent(urlParams.get('_dl')) : '';
  var deferredDeepLink = urlParams.has('_ddl') ? decodeURIComponent(urlParams.get('_ddl')) : '';
  var passthrough = '';

  function replaceSngLinks() {
    if (window.singularSdk && typeof window.singularSdk.buildWebToAppLink === 'function') {
      var webToAppLink = window.singularSdk.buildWebToAppLink(
        baseLink,
        deeplink,
        passthrough,
        deferredDeepLink
      );

      if (webToAppLink) {
        // Update all Singular Links on the page
        var links = document.querySelectorAll('a[href*="sng.link"]');
        links.forEach(function(link) {
          link.href = webToAppLink;
        });
      }
    }
  }

  // Run immediately and after 1 second (for dynamically loaded content)
  replaceSngLinks();
  setTimeout(replaceSngLinks, 1000);
})();
</script>

选项 B：按钮点击触发器

仅在点击特定按钮时触发 Web 到应用程序的重定向。

1. 在 GTM 中创建自定义 HTML 标签
2. 将触发器设置为在特定按钮点击事件时触发
3. 使用以下代码结构：

<script>
(function() {
  if (window.singularSdk && typeof window.singularSdk.openApp === 'function') {
    var baseLink = "https://mydomain.sng.link/Auour/55ba";
    var deeplink = '';
    var passthrough = '';
    var deferredDeepLink = '';
    
    singularSdk.openApp(baseLink, deeplink, passthrough, deferredDeepLink);
  }
})();
</script>