リファレンス

標準イベント

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

コンバージョンAPIと共にMetaピクセルを実装する場合、eventIDパラメーターをfbq(‘track’)関数の4番目のパラメーターとして含めるようにおすすめします。詳しくは、ピクセルイベントとサーバーイベントの重複除外のドキュメントをご覧ください。

イベント名	イベントの説明	オブジェクトのプロパティ	宣伝対象のオブジェクトのcustom_event_type値
`AddPaymentInfo`	チェックアウトフローで支払い情報が追加されたときに発生します。利用者が[請求情報保存]ボタンをクリックした場合など。	`content_category`、`content_ids`、`contents`、`currency`、`value` 任意。	ADD_PAYMENT_INFO
`AddToCart`	製品がショッピングカートに追加されたときに発生します。利用者が[カートに追加]ボタンをクリックした場合など。	`content_ids`、`content_name`、`content_type`、`contents`、`currency`、`value` 任意。 Advantage+ カタログ広告の場合は必須: `contents`	ADD_TO_CART
`AddToWishlist`	製品がウィッシュリストに追加されたときに発生します。利用者が[ウィッシュリストに追加]ボタンをクリックした場合など。	`content_name`、`content_category`、`content_ids`、`contents`、`currency`、`value` 任意。	ADD_TO_WISHLIST
`CompleteRegistration`	登録フォームが完了したときに発生します。記入済みサブスクリプションフォームまたは登録フォームを利用者が送信した場合など。	`content_name`、`currency`、`status`、`value` 任意。	COMPLETE_REGISTRATION
`Contact`	利用者が電話、SMS、メール、チャットなどでビジネスに関する連絡を開始したときに発生します。利用者が製品に関する質問を送信した場合など。	任意。	CONTACT
`CustomizeProduct`	利用者が製品をカスタマイズしたときに発生します。利用者がTシャツの色を選択した場合など。	任意。	CUSTOMIZE_PRODUCT
`Donate`	利用者があなたの組織またはあなたの目標のために寄付をしたときに発生します。利用者が人道協会への寄付をカートに追加した場合など。	任意。
`FindLocation`	店の場所を、実際に訪問する目的で利用者がウェブサイトやアプリを使用して検索したときに発生します。利用者が地元の店で特定の製品を探す場合など。	任意。	FIND_LOCATION
`InitiateCheckout`	利用者がチェックアウトフローを完了する前にチェックアウトフローに入ったときに発生します。利用者がチェックアウトボタンをクリックした場合など。	`content_category`、`content_ids`、`contents`、`currency`、`num_items`、`value` 任意。	INITIATE_CHECKOUT
`Lead`	登録が完了したときに発生します。利用者が料金をクリックした場合など。	`content_category`、`content_name`、`currency`、`value` 任意。	LEAD
`Purchase`	購入されたとき、またはチェックアウトフローが完了したときに発生します。利用者が購入やチェックアウトのフローを終了し、サンキューページや確認ページにランディングした場合など。	`content_ids`、`content_name`、`content_type`、`contents`、`currency`、`num_items`、`value` 必須: `currency`および`value` Advantage+ 広告の場合は必須: `contents`または`content_ids`	PURCHASE
`Schedule`	いずれかの所在地への訪問予約を利用者が取ったときに発生します。利用者がテニスレッスンの日時を選択した場合など。	任意。	SCHEDULE
`Search`	検索が行われたときに発生します。利用者がウェブサイトで製品を検索した場合など。	`content_category`、`content_ids`、`content_type`、`contents`、`currency`、`search_string`、`value` 任意。 Advantage+ 広告の場合は必須: `contents`または`content_ids`	SEARCH
`StartTrial`	提供している製品やサービスの無料トライアルを利用者が開始したときに発生します。利用者がゲームの1週間無料利用を選択した場合など。	`currency`、`predicted_ltv`、`value` 任意。	START_TRIAL
`SubmitApplication`	提供する製品、サービス、プログラムを利用者が申し込んだときに発生します。利用者がクレジットカード、教育プログラム、仕事に申し込む場合など。	任意。	SUBMIT_APPLICATION
`Subscribe`	提供している製品やサービスのペイドサブスクリプションに利用者が申し込んだときに発生します。利用者がストリーミングサービスに登録した場合など。	`currency`、`predicted_ltv`、`value` 任意。	SUBSCRIBE
`ViewContent`	対象のコンテンツページ(商品ページやランディングページなど)へのアクセス。`ViewContent`では、利用者がウェブページのURLを閲覧したかどうかは分かりますが、閲覧した内容やそのページで行った操作は分かりません。利用者が製品詳細ページにランディングした場合など。	`content_ids`、`content_category`、`content_name`、`content_type`、`contents`、`currency`、`value` 任意。 Advantage+ 広告の場合は必須: `contents`または`content_ids`	VIEW_CONTENT

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

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

プロパティキー	値のタイプ	パラメーターの説明
`content_category`	文字列	ページ/製品のカテゴリ
`content_ids`	整数または文字列の配列	SKUなどの、イベントに関連付けられた製品ID (例: `['ABC123', 'XYZ789']`)。
`content_name`	文字列	ページ/製品の名前
`content_type`	文字列	渡される`content_ids`または`contents`に応じた、`product`または`product_group`。`content_ids`または`contents`パラメーターに指定して渡されたIDが商品のIDである場合、この値は`product`になります。商品グループのIDが渡される場合、この値は`product_group`になります。 `content_type`が指定されていない場合、Metaはイベントを同じIDを持つすべてのアイテム(型は問わない)とマッチングさせます。
`contents`	オブジェクトの配列	数量、EAN (International Article Number) (該当する場合)、またはその他の製品やコンテンツIDを含むJSONオブジェクトの配列。`id`と`quantity`は必須のフィールドです。例: `[{'id': 'ABC123', 'quantity': 2}, {'id': 'XYZ789', 'quantity': 2}]`。
`currency`	文字列	指定した`value`の通貨。
`num_items`	整数	`InitiateCheckout`イベントで使用します。チェックアウトが開始されたときのアイテム数
`predicted_ltv`	整数、Float	広告主によって定義されたサブスクリプション登録者の予想顧客生涯価値。正確な値として表されます。
`search_string`	文字列	`Search`イベントで使用します。利用者が検索のために入力した文字列。
`status`	ブーリアン	`CompleteRegistration`イベントで使用します。登録のステータスを示します。
`value`	整数またはFloat	このイベントを実行する利用者のビジネスに対する価値。