> ## Documentation Index > Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt > Use this file to discover all available pages before exploring further. # コンバージョントラッキング > Scribe JavaScript SDKで、ウェブサイトのサインアップ、デモ、購入をトラッキングし、すべてのコンバージョンをその起点となったメール署名に紐付けます。 コンバージョントラッキングは、メール署名の効果測定を最後まで完結させます。署名アナリティクスでは、すでに表示回数とクリック数を確認できます。Scribe JavaScript SDKを使えば、自社ウェブサイト上でその後に起きたこと(サインアップ、予約されたデモ、購入)まで記録し、それぞれをきっかけとなった署名・チームメンバー・リンクに紐付けられます。ファネルの最下部、すなわち表示→クリック→コンバージョンまで追跡できます。 Scribeでは、これらのコンバージョンを**イベント**と呼びます。数行のJavaScriptで記録でき、アナリティクス全体を支えるのと同じクリックトラッキングにより、Scribeが自動でアトリビューションを行います。 コンバージョントラッキングは有料プランでご利用いただけます。ワークスペースのプランに含まれていない場合、トラッキングスニペットは何も記録しません。 ## 仕組み 1. 受信者がメール署名内のリンクをクリックします。 2. Scribeはリンク先URLに`scribe_click_id`パラメーターを付与して、自社サイトへリダイレクトします。 3. ランディングページ上のScribe SDKがその`scribe_click_id`を読み取り、ファーストパーティとして保存し、記録するすべてのイベントに付加します。 4. 訪問者がコンバージョンした時点で`scribe.track('signup')`を呼び出します。Scribeがそのイベントを起点となったクリックに紐付けます。 その結果、単なるクリック数ではなく、どの署名・チームメンバー・クリック要素が実際のコンバージョンや売上を生んでいるかを把握できます。アトリビューションは送信者・署名・要素の各レベルで機能し、Scribeはクリックから最長30日間、コンバージョンとクリックのマッチングを行います。 既知の `scribe_click_id` を伴わずにイベントが到達した場合(直接トラフィック、期限切れリンク、パラメータが除去されたリンクなど)でも、そのイベントは記録されます。ただし、クリックには紐づけられません。 ## 始める前に 次の3つが必要です: * **コンバージョントラッキングを含む有料プラン**。 * ワークスペースで **トラッキングを有効化** していること。これは署名の表示数・クリック数の分析を動かしているのと同じ設定です。必要な同意を得たうえで有効化してください([プライバシーと同意](#privacy-and-consent)を参照)。 * **Event Tracking ID**。ワークスペースの公開識別子(秘密情報ではありません)で、Webサイトの HTML に埋め込んでも安全です。 Scribe で **Settings** を開き、**Workspace** タブに移動して、**Event Tracking ID** の値をコピーします。同時に **Tracking** が有効になっていることを確認してください。 通常の Web サイトではスクリプトスニペットを、アプリやシングルページアプリケーションでは npm パッケージを利用してください。どちらも同じ `scribe.track(...)` API を公開します。 **オプション A:スクリプトスニペット。** 計測したいすべてのページで、閉じ `` タグの直前に次のスニペットを追加してください。スニペットは `data-workspace` から自動的に初期化されるため、`init()` を呼び出す必要はありません。 ```html theme={null} ``` **オプション B:npm または yarn。** パッケージをインストールし、アプリ起動時に一度だけ初期化してください。 ```bash theme={null} npm install @scribemail/js # or: yarn add @scribemail/js ``` ```js theme={null} import scribe from '@scribemail/js'; scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup ``` モジュールのインポートに副作用はありません(サーバーサイドレンダリングでも安全です)。`init()` を呼び出すまで、何も送信されません。 コンバージョンが発生する箇所(たとえばサインアップ成功時のハンドラー内)で `scribe.track` を呼び出してください。 ```js theme={null} scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' }); ``` SDK がランディング URL から Scribe のクリック帰属情報を取得し、イベントをバッチ化して、訪問者がページを離れた場合でも確実に送信します。 サイト上でイベントを発生させ、Scribe の **Analytics** を開いてください。コンバージョンが表示・クリックとともに、署名・チームメンバー・キャンペーン・国別に分解して表示されます。 ## SDK リファレンス ### `scribe.track(name, metadata)` イベントを記録します。`name` は必須で、例として `signup`、`demo_booked`、`purchase` などがあります。 ```js theme={null} scribe.track('purchase', { value: 149.0, // optional, monetary value of the conversion currency: 'EUR', // optional, ISO currency code event_id: 'order_8821', // optional, your own id, used for idempotency plan: 'team', // any other key becomes an event "property" seats: 5 }); ``` * `value`、`currency`、`event_id` はトップレベルのフィールドとして認識されます。 * **それ以外のすべてのキー** はイベントの `properties` に含まれます。プロパティはフラットなスカラー値(文字列・数値・真偽値)にとどめてください。メールアドレスや電話番号などの個人データはプロパティに含めないでください。Scribe は個人データと思われるキーを自動的に破棄します。 * 送信を安全にリトライできるようにするには、独自の `event_id` を指定してください。同じ `event_id` を 24 時間以内に 2 回受信した場合、記録は 1 回のみです。 ### `scribe.identify(userId, traits)` 訪問者を自社ユーザーの 1 人と関連付け、どの署名がどの顧客を獲得したかを把握できます。B2B や ABM の運用に役立ちます。 ```js theme={null} scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' }); ``` `identify` の呼び出し後、以降の `track` 呼び出しはそのユーザーに紐づきます。ログアウト時には `scribe.reset()` を呼び出して識別情報をクリアしてください。 ### `scribe.flush()` イベントはバッチ化され自動で送信されます。ページが非表示になる際にも必ず送信されます。現在のバッチを直ちに送信する必要がある場合のみ、`flush()` を呼び出してください。 ### スニペット属性 スクリプトスニペットを使用する場合は、`data-*` 属性で設定します。 | 属性 | 必須 | 説明 | | -------------------- | --- | ------------------------------------------------------ | | `data-workspace` | はい | イベントトラッキング ID。 | | `data-consent` | いいえ | 訪問者の同意が得られるまでファーストパーティストレージを無効化するには `"denied"` に設定します。 | | `data-cookie-domain` | いいえ | サブドメイン間で識別情報を共有するには、頂点ドメインを設定します。 | ### コンテンツセキュリティポリシー サイトでコンテンツセキュリティポリシーを設定している場合は、Scribeのホストを許可リストに追加してください: ``` script-src https://cdn-1.scribe-mail.com; connect-src https://t.scribe-mail.com; ``` サーバーで確認した支払いなど、バックエンドから信頼できるイベントを記録する必要がありますか?ScribeはAPI経由でもイベントを受け取れます。`events:write` APIキーを使えば、収益値をクライアント側の入力に頼らず信頼できる値として扱えます。詳しくは[APIリファレンス](/api-reference/introduction)をご覧ください。 ## ユースケース:コンバージョンを成長につなげる コンバージョントラッキングにより、メール署名は測定可能な獲得チャネルになります。ここでは、有料リマーケティングへの連携も含め、各チームがデータを活用している方法を紹介します。 ### Google広告およびMeta広告でリマーケティングキャンペーンを実施 `scribe.track`を呼び出すのと同じ場所で広告プラットフォームのコンバージョンピクセルを発火させれば、1件のコンバージョンがScribe、Google広告、Metaに同時に記録されます。Scribeはメール署名由来のコンバージョンであることを示し、GoogleとMetaは同じシグナルを入札とオーディエンスに活用します。 ```js theme={null} function onSignupComplete(plan, price) { // 1. Attribute the conversion to the email signature that drove it scribe.track('signup', { value: price, currency: 'USD', plan }); // 2. Send the same conversion to your ad platforms for bidding and audiences // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' }); // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' }); } ``` ### 購入意欲の高いリターゲティングオーディエンスを構築 署名をクリックしてサイトに訪れたもののコンバージョンに至らなかったユーザーは、見込みの高い層です。Scribeで署名経由のトラフィックを確認し、GoogleとMetaで最適化されたオファーを配信してリターゲティングしましょう。自社メールからのトラフィックのため、コールドプロスペクティングよりもコンバージョン率が高くなる傾向があります。 ### コンバージョン済みユーザーから類似オーディエンスを作成 最良のシードオーディエンスは、信頼できるチャネルですでにコンバージョンに至ったユーザーです。署名で獲得した訪問者を抽出し(署名、チームメンバー、キャンペーン別に絞り込み)、Metaのカスタムオーディエンスまたはグーグル広告のカスタマーマッチリストとしてアップロードして、この高品質なシードから類似(Lookalike / Similar)オーディエンスを構築してください。 ### 既存顧客を新規獲得広告の配信対象から除外 すでに登録済み・購入済みの人を獲得するために広告費を払い続けない方がよいでしょう。コンバージョンしたユーザーを書き出し、プロスペクティング広告の除外リストや抑制リストに追加することで、予算を純粋な新規見込み客に振り向けられます。 ### クリックではなく収益で最適化 各コンバージョンに実際の`value`と`currency`を渡します。収益情報を紐付けることで、GoogleやMetaを価値ベース入札に切り替えられ、Scribe上ではクリック数だけでなく、生み出した収益で署名・チームメンバー・キャンペーンをランク付けできます。 ### チャネルを証明し、予算を再配分 コンバージョントラッキングにより、メール署名経由の収益を有料チャネルと同じ基準で比較できます。署名キャンペーンが有料キャンペーンを上回った場合、成果の出ている施策へ予算を移す根拠となる数値が手に入ります。 ## AIエージェントに設定を依頼 手作業で組み込む必要はありません。AIコーディングアシスタント(Claude Code、Cursor、エディタ内の同種のエージェントなど)を利用している場合は、次のようなプロンプトに自分のEvent Tracking IDと計測したいコンバージョンを入れて貼り付けてください: ```text theme={null} Install the Scribe conversion tracking SDK on my website. - If this is an app or single-page app, add the @scribemail/js package and call scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with data-workspace="YOUR_EVENT_TRACKING_ID" before instead. - Call scribe.track('signup', { value, currency }) from my signup success handler and scribe.track('purchase', { value, currency }) from my checkout confirmation. - If I have logged-in users, call scribe.identify(userId, { email, plan }) after login. - Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content Security Policy if I have one. ``` コンバージョンデータが流れ始めたら、[Scribe MCPサーバー](/ja/ai-agents/connect)に接続したエージェントが結果を読み取り、解説してくれます。「今月最も多くのコンバージョンと収益を生んだ署名とチームメンバーは?」や「今週、署名が獲得した訪問者を一覧化して」といった質問が可能です。アシスタントが取得できる内容については、[AIエージェント向けScribe](/ja/ai-agents)と[Scribeアナリティクススキル](/ja/ai-agents/skills)をご覧ください。 ## プライバシーと同意 コンバージョントラッキングは、訪問者と法令上の義務を尊重する設計になっています: * **IPアドレスは匿名化されます。** ScribeはIPをハッシュ化してから保存します。生のIPが保持されることはありません。 * **プロパティに個人データを含めません。** 個人データと思われるキー(メールアドレス、電話番号、パスワード、トークン、カード番号など)は、イベントプロパティから自動的に除去されます。意図的にユーザーを紐付けたい場合は`identify`を使用してください。 * **同意に基づくストレージ。** `data-consent="denied"`(スニペット)または`consent: false`(npm `init`)を設定すると、訪問者が同意するまでSDKがクリック識別子を保存しないようにできます。 * **トラッキングを有効化する前に同意を取得してください。** ワークスペースのトラッキング設定は、他のアナリティクスピクセルと同等の責任を伴います。有効化する前に、地域で必要とされる同意を必ず取得してください。 ## 関連記事 * [アナリティクス概要](/ja/analytics-overview):ワークスペース全体のビュー、クリック、リーチ、CTR。 * [アナリティクスダッシュボード](/ja/analytics-dashboard):各タブでビューやクリックと並べてコンバージョンを確認できます。 * [署名アナリティクス](/ja/signature-analytics):個々の署名のパフォーマンス。 * [マーケティングキャンペーン](/ja/marketing-overview):署名内でバナーキャンペーンを実施・測定します。 * [AIエージェント向けScribe](/ja/ai-agents):アシスタントにトラッキングの設定やコンバージョンのレポート作成を任せられます。