方法1：ネイティブJavaScript SDK実装オプション：

Singular Web SDKはWeb-to-App Forwardingのために2つのJavaScript関数を提供します。 あなたの実装に最も適した方法を選択してください：

オプション A: openApp() - 自動リダイレクト

ユーザーをすぐにアプリ（インストールされていない場合はApp Store）にリダイレクトしたい場合にこのメソッドを使います。

// 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の実装は、Webサイトのコードを直接修正せずにWeb-to-Appリンクを管理したい場合に最適です。2つのアプローチがあります：

オプション A: 動的リンク置換（推奨）

Web SDKが初期化された後、ページ上のすべてのSingularリンクを自動的に更新します。

1. GTMで新しいカスタムHTMLタグを作成します。
2. Tag Sequencingを使用して、Singular Init Tagの後に実行されるように設定します。
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-to-Appリダイレクトを実行します。

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>