日英の記事から同じ紹介リンクへ送ると、どちらの記事が読者の判断につながったかをリンクだけでは区別できない。記事の言語と掲載位置をUTMに入れる方法を、URL生成コードで試した。発行済みリンクのパスと既存の紹介パラメータを保ち、分類に使う値だけを追加する。
検証日は2026年9月30日。今回確かめたのは、ローカルで作ったURLの構造だ。Dub APIでのリンク発行、リダイレクト後のパラメータ保持、購入と報酬の帰属は検証していない。入力には example.com の試験用URLを使い、テストのために紹介クリックや登録を発生させることはしていない。
登録・購入とクリックを対応させる実装は、Dub conversion tracking:lead・sale APIとStripeの顧客対応で説明している。通信しないJSON生成例から確認できる。
クリックと紹介料を別々に確認する
記事から公式サイトへ移動した回数と、紹介料が確定した件数は別の数字になる。読者がリンクを開いても、登録せずに離脱することがある。登録後に無料のまま利用する場合もある。返金やキャンセルの扱いは案件ごとに異なるため、購入の表示だけで入金を見込むのも早い。
このメディアでは、記事の閲覧、リンクのクリック、lead、sale、確定報酬を順に見る。クリック率は「対象リンクのクリック数/対象記事の閲覧数」、lead率は「登録などのlead数/対象リンクのクリック数」と定義する。計測対象と期間をそろえたうえで確認する数字であり、UTMを追加するだけで自動的に計算できるものではない。
Dubの公式説明では、UTM別にリンクの分析を絞り込め、Conversionsと組み合わせると登録や売上を確認できる。ただし、事業者側が計測するconversionを、自分のUTM生成コードだけで追加することはできない。DubのUTM分析機能
紹介URLを正本にする
まず案件へ参加し、事業者が発行した紹介URLを保存する。紹介先の製品サイトを開いて、そのURLを手作業で短縮リンクへ作り直すと、発行済みの紹介識別子を失う可能性がある。記事ごとの分類は発行済みURLに対して行う。
この記事の実験では、https://example.com/ref/demo?ref=keep#pricing を発行済みURLに見立てた。/ref/demo、ref=keep、#pricing を保つことを期待値に置いた。試験用URLで確認できるのは、こちらのコードがそれらを書き換えないことまでで、事業者の帰属処理がどう動くかは分からない。
実際の運用では、Circlebackは参加済みの紹介リンクを使い、未参加のDubには通常の公式リンクを使う。未参加の案件に紹介IDを推測して付ける運用は取らない。Dubの募集ページに掲載された条件は売上の30%、1年間だが、これはこのサイトに報酬が発生するという意味ではない。Dubの公式募集ページ
日英で共通のUTM命名を決める
命名は両言語で同じ形式にした。記事のURLに使うslugをキャンペーン名とし、言語と掲載位置は utm_content に置く。翻訳タイトルを値にすると、タイトルを変更しただけで計測上の別キャンペーンになるためだ。
| パラメータと判別する対象 | この実験の値 |
|---|---|
紹介元サイト(utm_source) |
sakimyto.com |
紹介導線(utm_medium) |
affiliate |
記事(utm_campaign) |
circleback-webhook-action-items |
言語と掲載位置(utm_content) |
ja-footer または en-footer |
本文中なら body、末尾のサービス案内なら footer を使う。最初から値を限定しておくと、JA、jp、Japanese が同じ意味で混在することを避けられる。閲覧者のメールや顧客名を入れる必要はない。URLはブラウザ履歴やアクセスログなどにも残るため、記事の分類に必要な値だけで足りる。
文字列連結を使わないURL生成
既存URLにはすでにクエリが付いていることがある。末尾に ?utm_source=... をつなぐ方式では、二つ目の ? が値に混ざるなど、想定していないURLを作りやすい。URL と URLSearchParams を使ってパラメータ単位で編集した。
import { buildReferralUrl } from './referral-utm.mjs'
const url = buildReferralUrl(
'https://example.com/ref/demo?ref=keep#pricing',
{
locale: 'ja',
slug: 'circleback-webhook-action-items',
placement: 'footer',
},
)
console.log(url)出力は次のURLになる。
https://example.com/ref/demo?ref=keep&utm_source=sakimyto.com&utm_medium=affiliate&utm_campaign=circleback-webhook-action-items&utm_content=ja-footer#pricing既存のUTMがある場合は、今回の命名で上書きする。searchParams.set を使うため、同じ utm_content を二つ残さない。UTM以外の ref=keep とフラグメントは維持する。関数はHTTPSと、資格情報を含まないURLだけを受け付ける。言語はja/en、掲載位置はbody/footer、slugは小文字英数字とハイフンに限定した。
ローカルで確認できた範囲
日本語と英語のURLを同じ入力から生成すると、utm_content だけが ja-footer と en-footer で分かれた。パス、ref、フラグメント、キャンペーン名は一致した。既存UTMを含む入力でも、同じキーが重複しないことをテストした。
不正なURLも試した。相対パス、HTTP、javascript:、資格情報を含むURLは拒否する。frという未対応言語、未知の掲載位置、../private というslugも受け付けない。これは公開記事から渡す値を一定に保つための入力検証であり、任意のリンクを安全な紹介リンクに変える機能ではない。
値が同じでも、URLの表記は変わる
2026年10月7日には、空白とチルダを含む紹介値でも試した。入力は次の合成URLで、tag を二つ、古い utm_content も二つ入れている。
https://example.com/ref/demo?ref=partner%20one~two&tag=alpha&tag=beta&utm_content=old&utm_content=older#pricingUTMを追加すると、ref の表記は partner%20one~two から partner+one%7Etwo へ変わった。デコードした値はどちらも partner one~two だ。Nodeの公式文書も、URLとURLSearchParamsではエンコードの規則が異なり、チルダの表記が変わることを説明している。Node.jsのURLSearchParamsの注意点
次はデモの出力からURLを省いた確認項目だ。tag の二つの値とパス、フラグメントは残り、utm_content は ja-footer 一件になった。
{
"decodedRefBefore": "partner one~two",
"decodedRefAfter": "partner one~two",
"rawRefBefore": "ref=partner%20one~two",
"rawRefAfter": "ref=partner+one%7Etwo",
"repeatedTags": ["alpha", "beta"],
"utmContentValues": ["ja-footer"],
"pathPreserved": true,
"fragmentPreserved": true
}この記事でいう「保持」は、試したパス・デコードした値・フラグメントの保持であり、元のURL文字列が完全に同じという意味ではない。URL文字列の一致を必要とする署名付きURLは、この実装の対象外とする。署名の仕様やUTM追加の条件を確認できないリンクへは適用しない。関数は署名付きURLを自動判別しないし、今回も事業者の署名検証や実際の帰属は試していない。
再現するには、次の二ファイルを同じフォルダに保存し、bun referral-demo.mjs またはNode.js 22以降の node referral-demo.mjs を実行する。日英のURLと確認項目をローカルで出力し、紹介先へアクセスしない。
以前の demo.mjs はCirclebackのタスク変換も試す共通デモとして残している。今回のUTMだけの確認には不要だ。
#pricingの後ろへUTMを連結しない
2026年10月16日には、フラグメント付きURLの末尾にUTMを連結する例も試した。?ref=keep#pricing の後ろへ &utm_source=sakimyto.com を足すと、UTMはフラグメント内に入る。searchParams.get('utm_source') は null になった。クエリがない #pricing 付きURLに ?utm_source=... を足した場合も同じだ。Nodeの公式文書では、クエリを表す search と、フラグメントを表す hash を別の要素として説明している。Node.jsのURL構造
既存の 実行デモ に、同じ入力へ文字列連結と buildReferralUrl を使った結果を加えた。前節の二ファイルだけを保存して同じコマンドで実行すると、次の項目も出力する。
{
"appendedUtmSource": null,
"appendedFragment": "#pricing&utm_source=sakimyto.com",
"builtUtmSource": "sakimyto.com",
"builtFragment": "#pricing"
}BunとNodeのどちらでも、この結果になった。buildReferralUrl はUTMをクエリへ置き、元の #pricing を保った。これは合成URLをローカルで解析した結果であり、Dubでのクリック計測やリダイレクト後の帰属を確認した結果ではない。署名付きURLへの適用条件も前節と同じだ。
紹介IDのプラス記号と空白
2026年10月18日には、合成ID partner+demo をクエリへ入れる方法を比べた。?ref=partner+demo を解析すると、searchParams.get('ref') は partner demo になった。WHATWGのURL仕様では、フォーム形式のクエリを解析する際、パーセントデコードの前に生の + を空白へ置き換える。WHATWGのクエリ解析手順
既存の 実行デモ は、前節の二ファイルと同じコマンドで次の literalPlus も出力する。BunとNodeで結果が一致した。
{
"input": "partner+demo",
"interpolatedRef": "partner demo",
"valueSetRef": "partner+demo",
"encodedQueryRef": "partner+demo",
"builderCannotRepairRef": "partner demo",
"doubleEncodedRef": "partner%2Bdemo"
}未エンコードの値を自分でクエリへ設定する場合は、url.searchParams.set('ref', 'partner+demo') と渡す。この例ではプラスが %2B として保存され、読み出すと partner+demo に戻った。既に %2B を含むURLへ buildReferralUrl でUTMを加えた場合も、この値を保った。値をあらかじめ encodeURIComponent に通してから set すると、デコード後にも %2B が残った。set には未エンコードの値を渡す。
ただし、発行済みURLの生の + が空白とプラスのどちらを意図するかは、この関数には分からない。?ref=partner+demo へUTMを加えても、解析済みの値は partner demo のままだ。発行済みURLを一括置換したり、全体をデコードして組み直したりせず、事業者が発行した正本と仕様を確認する。これは合成URLのローカル解析であり、Dubの実際の紹介IDやクリック・報酬の帰属は検証していない。
実際の紹介リンクへ適用するとき
Dubは短縮リンクに付けたパラメータを遷移先へ渡せると説明している。また、同じパラメータが遷移先にもある場合は短縮リンク側の値が優先される。このため、紹介プログラムが使うパラメータをこちらで上書きしない運用が必要だ。Dubのパラメータ引き継ぎの説明
適用前には案件の条件を確認し、発行済みリンクへUTMを足してよいかを判断する。許可されたテスト方法があれば、最終URLの紹介識別子、UTM、該当リンクのクリック表示を確認する。購入や登録を自分で行って報酬テストをする手順は含めない。自己紹介や広告利用の制限は、案件ごとの条件に従う。
今回のサイト実装では、Circlebackの紹介リンクは確認できた元のURLで掲載している。UTMの追加は、このローカル生成実験と事業者側での帰属確認を別々に扱う。コードが正しいURLを作ったことを、紹介料が正しく計測されたことの証拠にはしない。
何を見て次の記事を決めるか
計測にも、AIに仕事の続きを渡すための情報が要る。「この記事は好調」とだけ記録するより、記事slug、言語、対象期間、閲覧、クリック、確定報酬をそれぞれ残す。公開後にAIへ改善案を頼むとき、露出の問題か、導入判断の問題かを、同じ数字から検討できるようにする。今回のURL生成実験だけでは、その実績値は得られない。
公開後に記事を評価するときは、日英それぞれで対象の課題を検索する読者が来ているかを見る。閲覧はあるがクリックが少ない場合、サービスを導入する理由が本文で判断できるかを見直す。クリック後にleadやsaleが増えない場合は、記事と製品の適合、料金、設定の手間などを調べる。少数のクリックだけで、言語別の成約率に差があると結論づけることはできない。
高い報酬率を見つけるだけでは、読者の作業は進まない。CirclebackのWebhook実験では、担当者なしや再送をどう扱うかまで試した。実装を読んだ読者が、自分の運用で必要かを判断できることを、次のSaaS記事でも基準にする。
このトピックを深掘りする
SaaSの導入・連携
AIに仕事の続きを渡すために、会議の原文、未完了の宿題、確認できない項目をどう残すか。導入判断と連携実装を掘り下げる。
全23本中 23 本目。
次に読む記事
Claude Code 2.1.325のsandbox Bash確認と無人実行の点検
sandboxのBashが通常の許可判定へ。autoAllowBashIfSandboxed、deny・ask、/loopのSkill許可を公式資料で整理。読むだけの点検例と729組の合成テスト、CLI比較の未検証範囲を掲載。
Claude Codeの許可ルールの*は何を通す?2.1.323の警告と点検
Bash(npx *)は内側のコマンドを限定しません。Claude Code 2.1.322と2.1.323の隔離実測で、空白・変数・起動時警告を比較。設定を書き換えない点検例も掲載。
Claude Codeのsubagent MCPはいつ起動する?信頼と停止方法を実測
クローンしたrepoのインラインMCPはフォルダ信頼を待ちます。Claude Code 2.1.319の隔離75条件と読むだけの点検例で、--strict-mcp-config・--bareの範囲を確認。
シリーズ全体の流れを見ながら、次に読む記事へ進めます。 初めての方はホームへ →
よくある質問
紹介IDのプラス記号が空白になるのはなぜですか?
クエリ中の生の+はURLSearchParamsで空白として解析されます。合成IDの検証では、値をsetへ渡す方法と%2Bを含むURLでプラスを保持できました。既に生の+を含むURLへUTMを足しても、意図した値は復元できません。発行済みURLは正本を確認し、Dubの実際の帰属とは分けて判断します。
#pricingの後ろへUTMを足すと、クエリから取得できますか?
合成URLのローカル検証では、末尾に連結したUTMはフラグメントに入り、searchParamsから取得できませんでした。URL APIでクエリを編集すると、UTMと元の#pricingを別々に保持できました。Dubの実計測や帰属は未検証です。
既存パラメータの値が同じなら、署名付きURLにも使えますか?
元のURL文字列を保つ保証はありません。空白やチルダの表記は変わります。関数は署名付きURLを自動判別しないため、署名の仕様やUTM追加の条件を確認できないリンクへは適用しません。事業者の署名検証と実際の帰属は未検証です。
UTMを付ければ紹介料を受け取れますか?
UTMは流入の分類に使う値で、紹介料の権利や帰属を作るものではありません。参加承認と発行済み紹介リンクが必要で、報酬は各プログラムの条件と確定結果に従います。
この記事のコードはDub APIに接続しますか?
接続しません。URLの生成をローカルで検証するコードです。Dubでのリンク発行、リダイレクト後の保存、lead・saleの帰属は別途確認する必要があります。