ClickIDと、fbpおよびfbcパラメーター

このガイドでは、MetaのClickIDと_fbcおよび_fbpパラメーターについて説明します。_fbcおよび_fbpパラメーターはブラウザーのCookie値を表し、サーバーイベントと一緒に送信することができます。MetaピクセルのCookie設定についてをご覧ください。

利用可能なら常に、ブラウザーCookie値_fbcおよび_fbpを、それぞれfbcおよびfbpイベントパラメーターに入れて送信することをおすすめします。それらの値はブラウザーのセッションごとに変化するため、可能な場合はいつでもユーザーのプロフィールを最新の値に更新することをおすすめします。

MetaのClickIDとは

ClickIDはMetaが生成するパラメーターで、ユーザーがFacebookやInstagramで広告をクリックしたときに広告主のウェブサイトのURLと一緒に渡されます。ClickIDを共有すると、より多くのコンバージョンのアトリビューション分析をして多くの人にリーチすることができ、広告パフォーマンスの向上につながります。ClickIDの自動添付ファイルは、有効な他のカスタムトラッキングパラメーターには影響を与えません。

ClickIDを含むURLの例: https://example.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc

ClickIDのメリット

  • コンバージョンの増加
  • キャンペーンのアトリビューションと最適化の改善
  • 広告パフォーマンスの向上

1. Meta ClickIDを取得する

fbclid URLクエリパラメーターから取得する

URLクエリパラメーターが存在する場合には、HTTPリクエストURLのクエリ文字列から読み取って、サーバー側のパラメーターを取得するようにします。

例:

GET /?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc 
HTTP/2.0
Host: www.example.org

: ClickIDの値では大文字と小文字が区別されます。使用する前に小文字や大文字などの変更は行わないでください。

_fbc Cookieから取得する

ClickIDの値は、次の2つの場合に_fbc Cookieから取得できます。

  • ウェブサイトにMetaピクセルがインストールされている。この場合、Metaピクセルが利用できるようになると、ClickIDの値が_fbcブラウザーCookieに保存されます。
  • 「ストアClickID」セクションに記載されているベストプラクティスに従って、すでにサーバーのCookieやバックエンドストレージに保存している。

どちらのケースでも、フォーマットされたClickIDは、HTTPリクエストのCookieヘッダーを読み込んで_fbc Cookieから取得することができます。ClickIDを正しくフォーマットする方法については、下のClickIDをフォーマットするのセクションをご覧ください。

2. ClickIDをフォーマットする

ウェブサイトでMetaピクセルが実行されていないために_fbc Cookieを利用できない場合でも、現在のページリクエストのURLにfbclidクエリパラメーターがあるなら、fbcイベントパラメーターをコンバージョンAPIイベントで送信できます。

フォーマットされたClickIDの値は、version.subdomainIndex.creationTime.<fbclid>の形式でなければなりません。

  • versionは、常にプレフィックスのfbです
  • subdomainIndexは、Cookieがどのドメインで定義されているかを示します('com' = 0'example.com' = 1'www.example.com' = 2)
  • creationTimeは、_fbcが保存されたときの、エポックからの経過時間をミリ秒単位で示すUNIX時刻です。_fbc Cookieを保存しない場合は、このfbclid値を最初に観測または受信したタイムスタンプを使います。
  • <fbclid>は、ページURLのfbclidクエリパラメーターの値です。

結果のfbcパラメーターの値の例を以下に示します(<fbclid>の部分は無効であることに注意してください)。

fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

3. ClickIDを保存する

: ClickIDを保存する前に、上記のClickIDをフォーマットするのセクションに記載されているように、フォーマットしておくことが重要です。これにより、コンバージョンAPI経由でMetaに有効な値を送信できるようになります。

HTTP応答の_fbc CookieにフォーマットされたClickIDを設定します。

_fbcを以下のように設定することを強くおすすめします。

  • HTTP応答ヘッダー内のHTTP Cookieに設定する
  • 90日間の有効期限付きで設定する

fbclid URLクエリパラメーターまたは_fbcブラウザーCookieから取得し、設定します。

注: 次の場合にのみCookieを設定します。

  • _fbc Cookieが存在せず、fbclidURLクエリパラメーターからClickIDを取得した場合
  • URLクエリパラメーターのfbclidが、_fbc Cookie値の対応する値と等しくない場合。Cookieのfbclidは、Cookie値末尾の「.」の後の文字列に対応します。

例:

HTTP/2.0 200 OK
Content-Type: text/html
Set-Cookie:
_fbc=fb.1.1709136167115.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc; Expires=Thu, 21 Oct 2021 07:28:00 GMT;

フォーマットされたClickIDをサーバーに保存する

上記のCookieオプションの代わりに、フォーマットされたClickIDの値をバックエンドストレージに保存して管理することができます。この場合、URLクエリパラメーターから取得した最新の値を保存して送信する必要があります。

4. コンバージョンAPIイベントでfbcパラメーターを送信する

ClickIDの値を取得してコンバージョンAPI経由でイベントを送信する前に、正しくフォーマットする必要があります。以下の手順をご覧ください。コンバージョンAPIに送信するすべてのイベントにfbcパラメーターを指定することをおすすめします。

パラメーター名: fbc

パラメーター値: fbcの形式でなければなりません。

  • versionは、常にプレフィックスのfbです。
  • subdomainIndexは、Cookieがどのドメインで定義されているかを示します('com' = 0、'example.com' = 1、'www.example.com' = 2)。このフィールドをサーバー上で生成していて、_fbc Cookieを保存していない場合は、値1を使います。
  • creationTimeは、エポックからの経過ミリ秒数で表す、_fbc Cookie保存時のUNIX時刻です。_fbc Cookieを保存しない場合は、このfbclid値を最初に観測または受信したタイムスタンプを使います。
  • fbclidは、ページURLのfbclidクエリパラメーターの値です。

値の例:

fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc

コンバージョンAPIペイロードの例:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1712248396,
            "action_source": "website",
            "user_data": {

                "fbc": "fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDGrc",

                "em": ["7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068"],
                "ph": ["6069d14bf122fdfd931dc7beb58e5dfbba395b1faf05bdcd42d12358d63d8599"],
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            }
        }
    ]
}

統合ヘルプツール

ペイロードのヘルプツール

ペイロードのヘルプツールは、Metaに正しい形式のデータが送信されるようにコンバージョンAPIリクエストペイロードを構築するためのツールです。コンバージョンAPIとの統合に使用できる、複数のプログラミング言語のビジネスSDKも含まれています。「コードを生成する」のセクション内の「コードを取得する」ボタンをクリックすると使用できます。

fbp

Metaピクセルがウェブサイトにインストールされていて、ピクセルでファーストパーティCookieが使われている場合、そのウェブサイトドメインのユニーク識別情報がまだないなら、ピクセルはその識別情報を自動的に_fbp Cookieに保存します。

fbpイベントパラメーター値は、version.subdomainIndex.creationTime.randomnumberの形式でなければなりません。ここで、

  • versionは、常にプレフィックスのfbです。
  • subdomainIndexは、Cookieがどのドメインで定義されているかを示します('com' = 0、'example.com' = 1、'www.example.com' = 2)。このフィールドをサーバー上で生成していて、_fbp Cookieを保存しない場合は、値1を使います。
  • creationTimeは、_fbp Cookieが保存されたときの、エピックからの経過時間をミリ秒単位で示すUNIX時刻です。_fbp Cookieを保存しない場合は、このfbp値を最初に観測または受信したタイムスタンプを使います。
  • Randomnumberは、_fbp Cookieのそれぞれがすべてユニークになるように、MetaピクセルSDKによって生成されます。

fbp値の例を以下に示します。

fb.1.1596403881668.1116446470

詳しくはこちら

  • クエリパラメーターがないため、またはリダイレクトが切れているために発生する問題については、ピクセルサポートガイドをご覧ください。