概要

KARTE Signalsのコンバージョン補完機能で使用するtransaction_idを、Google Tag Manager(以下GTM)を使用して生成する方法を説明します。
この方法は、サイト内に一意の注文ID(order_id等)が存在しない場合に利用できます。

前提条件

  • GTMが導入済みであること
  • KARTE計測タグがGTMで設定されていること
  • 広告プラットフォームのタグ(例:Google広告、Facebook広告など)がGTMで設定されていること

設定手順

0. 全体像

null

1. transaction_id生成用のカスタムHTMLタグを作成

  1. GTMの「タグ」→「新規」を選択
  2. タグの種類で「カスタムHTML」を選択
  3. 以下のコードを入力:
<script>
  function generateUuid() {
    var chars = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".split("");
    for (var i = 0, len = chars.length; i < len; i++) {
      switch (chars[i]) {
        case "x":
          chars[i] = Math.floor(Math.random() * 16).toString(16);
          break;
        case "y":
          chars[i] = (Math.floor(Math.random() * 4) + 8).toString(16);
          break;
      }
    }
    return chars.join("");
  }

  var transactionId = generateUuid();
  dataLayer.push({
    'signals_transaction_id': transactionId
  });
</script>
  1. 詳細設定内のタグ呼び出しオプションで「1回のイベントにつき1度」が設定されていることを確認
  2. タグ名を「transactionId発火」として保存
    ※タグ名は任意ですが、識別しやすい名称をおすすめします。
    補足

    この時点ではトリガーを設定しないでください。GTM上で警告が表示されますが、後ほど順序制御で実行順を制御するため、そのまま保存して問題ありません。

2. データレイヤー変数の作成

  1. GTMで「変数」→「新規」を選択
  2. 変数の種類で「データレイヤーの変数」を選択
  3. データレイヤー変数名に「signals_transaction_id」を入力
  4. 変数名を「signals_transaction_id」として保存
    ※変数名は任意ですが、タグ内で使用する名前と一致させてください。
  5. データレイヤーバージョンは「バージョン2」を選択
    null

3. KARTEコンバージョンタグの設定

  1. KARTEのコンバージョンタグの詳細設定を開く
  2. 「タグの順序付け」を有効化
  3. 「transactionId発火」タグを、このタグよりも前に実行されるように設定
  4. 「このタグは、指定したタグが配信できなかった場合や一時停止となっている場合には配信しない」オプションにチェックを入れる
  5. KARTEコンバージョンタグで、transaction_id に{{signals_transaction_id}}変数を使用するように設定する
    null

4. 広告プラットフォームタグの設定

  1. 各広告プラットフォームのタグの詳細設定を開く
  2. 「タグの順序付け」を有効化
  3. 「transactionId発火」タグを、このタグよりも前に実行されるように設定
  4. 「このタグは、指定したタグが配信できなかった場合や一時停止となっている場合には配信しない」オプションにチェックを入れる
  5. 各広告プラットフォームのタグで、{{signals_transaction_id}}変数を使用するように設定する
    null

※KARTEのタグと、トリガーを一致させてください。

動作確認方法

  1. GTMの「プレビューモード」で対象ページを開く
    • コンバージョンページで transactionId発火KARTEコンバージョンタグ の順に実行されていることを確認
  2. ブラウザの開発者ツールで dataLayer を確認し、signals_transaction_id が格納されていることを確認
  3. 各広告プラットフォーム(例:Google広告、Facebook広告)のイベントマネージャーで transaction_id が正しく送信されていることを確認

注意事項

  • KARTEタグと広告タグは、同一のGTMコンテナ内で設定してください
  • 既存のタグに変更を加える際は、事前にバックアップを取りましょう
  • 本番反映前に必ずテスト環境での動作確認を行ってください
  • データレイヤー変数の名前やスコープが一致していないと、値が正しく取得できない可能性があります
  • 「タグの順序」が正しく設定されていない場合、transaction_id が未設定のまま送信されてしまう可能性があります

トラブルシューティング

事象 確認ポイント
transaction_id が生成されない - カスタムHTMLタグが有効か(タグの有効化設定を確認)
- dataLayer.push が発火しているか
- JavaScriptエラーが出ていないか(ブラウザの開発者ツールのコンソールを確認)
transaction_id が空のまま送信される - KARTEタグや広告タグで {{signals_transaction_id}} を正しく参照しているか
- データレイヤー変数 signals_transaction_id が正しく定義されているか
- タグの順序設定が正しく設定されているか(transactionId発火 → 各コンバージョンタグ)
コンバージョンが重複して送信される - 複数回 transaction_id を生成していないか(ページ内で複数回実行されていないか)
- タグの発火条件が正しく設定されているか
広告側で transaction_id が未反映 - 広告タグの設定で {{signals_transaction_id}} を参照しているか
- 使用しているテンプレートがカスタムJavaScriptや変数の参照を許可しているか