短縮リンクとMeta Conversions API: 今できること

ElidoはいまのところConversions APIにコンバージョンを転送しません。連携の一覧を見て、切り替えるだけのスイッチを期待してここに来たのなら、それは存在しません。どこにも行き着かない設定手順へ案内するより、先にそう言っておきたいと思います。以降では、Elidoが何を記録するのか、Metaのドキュメント(2026-10-25 閲覧)が何を求めるのか、そして短縮リンクがあってもなくても、サーバー側の呼び出しを自分で組み立てる方法を説明します。

要点はこうです。Elidoが提供するのはリンクごとのクリック数と、ShopifyとStripeについてはリンクごとの売上です。Metaが求めるのは、event_id、ハッシュ化した顧客データ、できればfbcクリックIDを備えたイベントです。それは自分で組み立てることになります。

現時点でElidoがMeta向けに行うこと、行わないこと

2026-10-25 にリポジトリで確認したコードの状態です。

• MetaピクセルID: ワークスペースに1つ保存できます。Elidoのスプラッシュページとインタースティシャルページのブラウザピクセルに使われます。これはブラウザ側のタグであり、CAPIではありません。
• サーバー側のMeta呼び出し: クリックパイプラインには、IPとユーザーエージェント付きのPageViewを送信するMeta用コードパスがあります。ピクセルIDとアクセストークンの両方が存在するときだけ動作しますが、設定にトークンが保存されることはないため、実行されません。
• コンバージョン: 注文はShopifyとStripeのWebhook経由でのみ届き、渡したelido_link_idの値でリンクに結び付けられます。公開のコンバージョンエンドポイントも、クリックIDのヘッダーやクッキーもありません。
• fbclid: Elidoは取得も転送もしません。

コンバージョントラッキング機能ページも同じWebhookモデルを説明しています。Metaへのワンコール転送を約束する古い記事は、製品ではなく計画を述べたものと考えてください。

合成のサンプルデータを使ったデモワークスペースであり、顧客の実績ではありません。

この画面はMetaと並べても役立ちます。自社の注文から出したキャンペーンごとの売上は、広告マネージャの主張を検証する材料になります。両者が1円単位まで一致することはまずありません。

MetaのConversions APIの仕組み

MetaのConversions APIドキュメント(2026-10-25 閲覧)によると、アクセストークンを付けて https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events にPOSTします。現在のドキュメントの例はv26.0です。コードを書く前に知っておくべき制限がいくつかあります。

• 1リクエストで最大1,000件のイベントを送れます。
• event_timeは最大7日前までです。バッチ内に古いイベントが1件でもあると、Metaはリクエスト全体を拒否します。
• すべてのイベントにevent_idを付けて送ります。Metaが同じevent_idとevent_nameを2回受け取ると最初のものを残すため、リトライしても安全です。

トークンについては、Metaのはじめにガイド(2026-10-25 閲覧)が、イベントマネージャでの生成を推奨しています。ピクセルを選び、設定を開き、Conversions APIセクションの「アクセストークンを生成」を使います。このリンクは、そのビジネスの開発者権限を持つユーザーにしか表示されません。トークンはサーバーのシークレットとして保管してください。

自分で組み込む手順

クリックが短縮リンク、QRコード、広告への直接アクセスのどれから来ても、手順は同じです。

1. クリックIDを保持する。 Metaのfbpとfbcのガイド(2026-10-25 閲覧)では、fbclidがランディングURLにあればサーバー側で読み取り、fb.1.<作成時刻(ミリ秒)>.<fbclid>の形式にするよう説明しています。これをfbcの値として訪問者のセッションに保存し、注文にコピーします。ピクセルが_fbpクッキーを設定していれば、その値も保存します。
2. イベントIDを決める。 注文IDを使い、ブラウザピクセルの呼び出し(eventID)とサーバーイベント(event_id)で同一の文字列を使います。同じ注文にord_98231と98231のように異なる形式を使うと、重複排除されません。
3. 正規化してハッシュ化する。 Metaの顧客情報パラメーター(2026-10-25 閲覧)によると、メールは前後の空白を除いて小文字にしてからSHA-256でハッシュ化します。電話番号は記号、文字、先頭のゼロを取り除き、ハッシュ化の前に国番号を含める必要があります。fbc、fbp、client_ip_addressはハッシュ化しません。
4. イベントを送る。 注文の支払いが完了したとき、バックエンドまたは注文Webhookのハンドラーから送ります。
5. テストイベントで確認し、その後テストコードを外します。

最小限のNodeの例です。

import { createHash } from "node:crypto";

const sha256 = (v) => createHash("sha256").update(v).digest("hex");

const event = {
  event_name: "Purchase",
  event_time: Math.floor(Date.now() / 1000),
  event_id: order.id, // same string the browser pixel uses as eventID
  action_source: "website",
  event_source_url: order.thankYouUrl,
  user_data: {
    em: [sha256(order.email.trim().toLowerCase())],
    fbc: order.fbc,
    fbp: order.fbp,
    client_ip_address: order.ip,
    client_user_agent: order.userAgent,
  },
  custom_data: { currency: "EUR", value: 89.5 },
};

await fetch(
  `https://graph.facebook.com/v26.0/${PIXEL_ID}/events?access_token=${TOKEN}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ data: [event] }),
  },
);

テスト中は、ボディにtest_event_codeを追加してください。URLにトークンが含まれるため、本番ではURL全体をログに出さないでください。

重複排除とテストイベント、2つの落とし穴

Metaの重複排除ガイド(2026-10-25 閲覧)は、event_idとevent_nameの組で照合し、ピクセルのeventIDとサーバーのevent_idを48時間の枠内で比較すると説明しています。これが主に機能するのは、ブラウザイベントが先に届き、サーバーイベントがその後に続く場合だとされています。また、ソースが1つだけの場合は重複排除がまったく行われないとも述べています。

テストイベントツールには落とし穴があります。test_event_codeはテスト専用ですが、MetaのAPIの使い方のページには、それを付けて送ったイベントは破棄されないと書かれています。イベントマネージャに流れ込み、ターゲティングや測定にも使われます。つまり、「無害な」500ユーロのテスト購入もカウントされます。小さなテストイベントを数件送り、本番のペイロードからはコードを外してください。

送信を始めると、Metaによれば約20分以内にイベントマネージャの概要で確認できるはずです。イベント名がピクセルの送る名前と一致していること、イベントにマッチしたユーザーデータが表示されていることを確認してください。

短縮リンクが関わる場面

短縮リンクはCAPIの仕組みを変えません。関わるのは2か所だけです。

1つ目はクリックIDです。Metaは広告に設定した遷移先URLにfbclidを付加します。その遷移先が短縮リンクなら、パラメーターは短縮リンクに届きます。Elidoのリダイレクト処理に、受け取ったクエリ文字列を遷移先にコピーするコードは見つかりませんでした。そのためMeta広告では、UTM付きの最終ランディングURLに向け、短縮リンクはメール、SMS、QRコード、オーガニック投稿に使うのがよいと考えます。広告に短縮リンクを使いたい場合は、先にダミーの?fbclid=testでテストし、ランディングページが何を受け取るかを確認してください。

2つ目はレポートです。ShopifyまたはStripeのチェックアウトにelido_link_idを付けます。するとElidoのコンバージョンレポートに、自社の注文に基づくリンクごと・キャンペーンごとの売上が表示されます。Webhook側はShopifyのチュートリアルで扱っています。ブラウザだけの計測でイベントが失われる理由の全体像は、サーバー側コンバージョントラッキングとクッキーレスアトリビューションの解説を参照してください。

同意とプライバシー

ハッシュ化は匿名化ではありません。メールアドレスのSHA-256ハッシュは、Metaが自社の記録と照合できるため、GDPR上は依然として個人データです。EUでは適法根拠が必要で、広告測定では通常それは同意です。サーバー呼び出しも、訪問者がバナーで行った選択に従う必要があります。同意と越境移転の問題は、トラッキングのためのConsent Mode v2とSchrems IIとトラッキングピクセルで扱っています。訪問者が拒否した場合は、何も送らないでください。

Elidoにまだないもの

1回の呼び出しでMetaへ購入を転送すること、リダイレクト時にfbclidを取得すること、Meta設定のアクセストークン欄は、いずれも未実装です。これらは製品のバックログで管理されており、リリースされればこの記事も更新します。それまでの現実的な設定は上記のとおりです。サーバーがイベントを送り、Elidoはその周辺でリンク単位のクリックと売上のデータを提供します。

ブログの関連記事

• サーバー側コンバージョントラッキング
• クリックID: gclidとfbclid
• UTMをエンドツーエンドで追跡する
• リンクリターゲティングの解説
• Shopify向けURL短縮サービス