fbp
およびfbc
パラメーターこのガイドでは、MetaのClickID、_fbc
パラメーター、および_fbp
パラメーターについて説明します。_fbc
および_fbp
パラメーターはブラウザーのCookie値を表し、サーバーイベントと一緒に送信することができます。MetaピクセルのCookie設定についてをご覧ください。
利用可能な場合はいつでも、ブラウザーのCookie値_fbc
および_fbp
を、それぞれfbc
およびfbp
イベントパラメーターに入れて送信することをおすすめします。これらの値はブラウザーのセッションごとに変化するため、可能な場合はいつでもユーザーのプロフィールを最新の値に更新することをおすすめします。
ClickIDはMetaが生成するパラメーターで、ユーザーがFacebookやInstagramで広告をクリックしたときに広告主のウェブサイトのURLと一緒に渡されます。ClickIDを共有すると、より多くのコンバージョンのアトリビューション分析を行って、より多くの人にリーチできるため、広告パフォーマンスの向上につながります。ClickIDの自動添付ファイルは、有効化されているほかのカスタムトラッキングパラメーターには影響を与えません。
ClickIDを含むURLの例: https://example.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk
fbclid
URLクエリパラメーターから取得するURLクエリパラメーターが存在する場合には、HTTPリクエストURLのクエリ文字列から読み取って、サーバー側のパラメーターを取得するようにします。
例
GET /?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk HTTP/2.0 Host: www.example.org
注: ClickIDの値では大文字と小文字が区別されます。使用する前に小文字や大文字への変更などを行わないでください。
_fbc
Cookieから取得するClickIDの値は、次の2つの場合に_fbc
Cookieから取得できます。
_fbc
ブラウザーCookieに保存されます。どちらのケースでも、フォーマットされたClickIDは、HTTPリクエストのCookieヘッダーを読み込んで_fbc
Cookieから取得することができます。ClickIDを正しくフォーマットする方法については、下のClickIDをフォーマットするのセクションをご覧ください。
ウェブサイトでMetaピクセルが実行されていないために_fbc
Cookieを利用できない場合でも、現在のページリクエストのURLにfbclid
クエリパラメーターが含まれている場合、fbc
イベントパラメーターをコンバージョンAPIイベントで送信できます。
フォーマットされたClickIDの値は、version.subdomainIndex.creationTime.<fbclid>
の形式でなければなりません。
_fbc
が保存された時点でのエポックからの経過時間をミリ秒単位で示すUNIX時刻です。_fbc
Cookieを保存しない場合は、このfbclid
値を最初に確認または受信したタイムスタンプを使います。<fbclid>
は、ページURLのfbclid
クエリパラメーターの値です。結果のfbc
パラメーターの値の例を以下に示します(<fbclid>
の部分は無効であることに注意してください)。
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890
注: ClickIDを保存する前に、上記のClickIDをフォーマットするセクションに記載されているように、フォーマットしておくことが重要です。これにより、コンバージョンAPI経由でMetaに有効な値を送信できるようになります。
_fbc
CookieにフォーマットされたClickIDを設定します。_fbc
を以下のように設定することを強くおすすめします。
fbclid
URLクエリパラメーターまたは_fbc
ブラウザーCookieから取得し、設定します。
注: 次の場合にのみCookieを設定します。
fbclid
URLクエリパラメーターからClickIDを取得した場合fbclid
が、_fbc
Cookie値の対応する値と等しくない場合。Cookieのfbclid
は、Cookie値末尾の「.」の後の文字列に対応します。例
HTTP/2.0 200 OK Content-Type: text/html Set-Cookie: _fbc=fb.1.1709136167115.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk; Expires=Thu, 21 Oct 2021 07:28:00 GMT;
上記のCookieオプションの代わりに、フォーマットされたClickIDの値をバックエンドストレージに保存して管理することができます。この場合、URLクエリパラメーターから取得した最新の値を保存して送信する必要があります。
fbc
パラメーターを送信するClickIDの値を取得した後、コンバージョンAPI経由でイベントを送信する前に、正しくフォーマットする必要があります。以下の手順をご覧ください。コンバージョンAPIに送信するすべてのイベントにfbc
パラメーターを指定することをおすすめします。
パラメーター名: fbc
パラメーター値: fbc
の形式でなければなりません。
fb
です_fbc
Cookieを保存していない場合は、値1を使います。_fbc
Cookie保存時のUNIX時刻です。_fbc
Cookieを保存しない場合は、このfbclid
値を最初に確認または受信したタイムスタンプを使います。fbclid
は、ページURLのfbclid
クエリパラメーターの値です。値の例
fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk
コンバージョンAPIペイロードの例:
{ "data": [ { "event_name": "Purchase", "event_time": 1712248396, "action_source": "website", "user_data": { "fbc": "fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk", "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