リファレンス

Facebookピクセルのfbq('track')関数のリファレンスです。

標準イベント

fbq('track')関数を使用して、次の標準イベントをトラッキングできます。標準イベントでは、特定のオブジェクトプロパティを持つパラメーターオブジェクトもサポートされています。これを使用して、イベントに関する詳細情報を含めることができます。

イベント名イベントの説明オブジェクトのプロパティ宣伝対象のオブジェクトのcustom_event_type値

AddPaymentInfo

チェックアウトフローで支払い情報が追加されたときに発生します。

利用者が[請求情報の保存]ボタンをクリックした場合など。

content_categorycontent_idscontentscurrencyvalue

必須のものはありません。

ADD_PAYMENT_INFO

AddToCart

製品がショッピングカートに追加されたときに発生します。

利用者が[カートに追加]ボタンをクリックした場合など。

content_idscontent_namecontent_typecontentscurrencyvalue

必須のものはありません。

ダイナミック広告の場合は必須: content_typeおよびcontents、またはcontent_ids

ADD_TO_CART

AddToWishlist

製品がウィッシュリストに追加されたときに発生します。

利用者が[ウィッシュリストに追加]ボタンをクリックした場合など。

content_namecontent_categorycontent_idscontentscurrencyvalue

必須のものはありません。

ADD_TO_WISHLIST

CompleteRegistration

登録フォームが完了したときに発生します。

完了したサブスクリプションまたは登録フォームを利用者が送信した場合など。

content_namecurrencystatusvalue

必須のものはありません。

COMPLETE_REGISTRATION

Contact

利用者が電話、SMS、メール、チャットなどでビジネスに関する連絡を開始したときに発生します。

利用者が製品に関する質問を送信した場合など。
必須のものはありません。

CONTACT

CustomizeProduct

利用者が製品をカスタマイズしたときに発生します。

利用者がTシャツの色を選択した場合など。
必須のものはありません。

CUSTOMIZE_PRODUCT

Donate

利用者があなたの組織またはあなたの目標のために寄付をしたときに発生します。

利用者がHumane Societyへの寄付をカートに追加した場合など。
必須のものはありません。

FindLocation

店の場所を、実際に訪問する目的で利用者がウェブサイトやアプリを使用して検索したときに発生します。

利用者が地元の店で特定の製品を探す場合など。
必須のものはありません。

FIND_LOCATION

InitiateCheckout

利用者がチェックアウトフローを完了する前にチェックアウトフローに入ったときに発生します。

利用者が[チェックアウト]ボタンをクリックした場合など

content_categorycontent_idscontentscurrencynum_itemsvalue

必須のものはありません。

INITIATE_CHECKOUT

Lead

登録が完了したときに発生します。

利用者が価格をクリックした場合など。

content_categorycontent_namecurrencyvalue

必須のものはありません。

LEAD

PageView

これは、ページアクセス数をトラッキングするデフォルトのピクセルです。

利用者がウェブサイトのページにランディングした場合など。
必須のものはありません。

PAGE_VIEW

Purchase

購入されたとき、またはチェックアウトフローが完了したときに発生します。

利用者が購入またはチェックアウトフローを終了し、サンキューページまたは確認ページにランディングした場合など。

content_idscontent_namecontent_typecontentscurrencynum_itemsvalue

必須: currencyおよびvalue

ダイナミック広告の場合は必須: content_typeおよびcontents、またはcontent_ids

PURCHASE

Schedule

指定したいずれかの場所の訪問の予約を利用者が取ったときに発生します。

利用者が歯医者の予約日時を選択した場合など。
必須のものはありません。

SCHEDULE

Search

検索が行われたときに発生します。

利用者がウェブサイトで製品を検索した場合など。

content_categorycontent_idscontentscurrencysearch_stringvalue

必須のものはありません。

SEARCH

StartTrial

提供している製品やサービスの無料トライアルを利用者が開始したときに発生します。

利用者がゲームの無料週間を選択した場合など。

currencypredicted_ltvvalue

必須のものはありません。

START_TRIAL

SubmitApplication

提供する製品、サービス、プログラムを利用者が申し込んだときに発生します。

利用者がクレジットカード、教育プログラム、または仕事に申し込む場合など。
必須のものはありません。

SUBMIT_APPLICATION

Subscribe

提供している製品やサービスのペイドサブスクリプションに利用者が申し込んだときに発生します。

利用者がストリーミングサービスに登録した場合など。

currencypredicted_ltvvalue

必須のものはありません。

SUBSCRIBE

ViewContent

関心のあるコンテンツページ(商品ページやランディングページなど)へのアクセス。ViewContentは、利用者がウェブページのURLを閲覧したことを示しますが、閲覧した内容やそのページで何をしたかはわかりません。

利用者が製品の詳細ページにランディングした場合など。

content_idscontent_categorycontent_namecontent_typecontentscurrencyvalue

必須のものはありません。

ダイナミック広告の場合は必須: content_typeおよびcontents、またはcontent_ids

VIEW_CONTENT

オブジェクトのプロパティ

事前定義されている以下のオブジェクトプロパティは、どのカスタムイベントにも含められます。また、そのプロパティをサポートしていれば、標準イベントにも含めることができます。JSONを使用してパラメーターのオブジェクトデータをフォーマットします。

プロパティキー値のタイプパラメーターの説明

content_category

文字列

ページ/製品のカテゴリ

content_ids

整数または文字列の配列

SKUなどの、イベントに関連付けられた製品ID(例: ['ABC123', 'XYZ789'])

content_name

文字列

ページ/製品の名前

content_type

文字列

渡されるcontent_idsまたはcontentsに応じて、productまたはproduct_groupcontent_idsまたはcontentsパラメーターに指定して渡されるIDが製品のIDである場合、この値はproductになります。製品グループのIDが渡される場合、この値はproduct_groupになります。

contents

オブジェクトの配列

数量、EAN (International Article Number) (該当する場合)、またはその他の製品やコンテンツIDを含むJSONオブジェクトの配列。idquantityは必須のフィールドです。例: [{'id': 'ABC123', 'quantity': 2}, {'id': 'XYZ789', 'quantity': 2}]

currency

文字列

指定したvalueの通貨。

num_items

整数

InitiateCheckoutイベントで使用します。チェックアウトが開始されたときのアイテム数

predicted_ltv

整数、Float

広告主によって定義された登録者の予想顧客生涯価値。正確な値として表されます。

search_string

文字列

Searchイベントで使用します。利用者が検索のために入力した文字列。

status

Boolean

CompleteRegistrationイベントで使用します。登録のステータスを示します。

value

整数またはFloat

このイベントを実行する利用者のビジネスに対する価値。