リファレンス

標準イベント

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

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

イベント名	イベントの説明	オブジェクトのプロパティ	宣伝対象のオブジェクトのcustom_event_type値
`AddPaymentInfo`	チェックアウトフローで支払い情報が追加されたときに発生します。利用者が[請求情報保存]ボタンをクリックした。	`content_ids`、`contents`、`currency`、`value` 任意。	ADD_PAYMENT_INFO
`AddToCart`	商品がショッピングカートに追加されたときに発生します。利用者が[カートに追加]ボタンをクリックした。	`content_ids`、`content_type`、`contents`、`currency`、`value` 任意。 Advantage+ カタログ広告の場合は必須: `contents`	ADD_TO_CART
`AddToWishlist`	商品がウィッシュリストに追加されたときに発生します。利用者が[ウィッシュリストに追加]ボタンをクリックした。	`content_ids`、`contents`、`currency`、`value` 任意。	ADD_TO_WISHLIST
`CompleteRegistration`	登録フォームが完了したときに発生します。利用者が記入済みサブスクリプションフォームまたは登録フォームを送信した。	`currency`、`value` 任意。	COMPLETE_REGISTRATION
`Contact`	利用者が電話、SMS、メール、チャットなどでビジネスに関する連絡を開始したときに発生します。利用者が商品に関する質問を送信した。	任意。	CONTACT
`CustomizeProduct`	利用者が商品をカスタマイズしたときに発生します。利用者がTシャツの色を選択した。	任意。	CUSTOMIZE_PRODUCT
`Donate`	利用者があなたの組織またはあなたの目標のために寄付をしたときに発生します。利用者が人道協会への寄付をカートに追加した。	任意。
`FindLocation`	店の場所を、実際に訪問する目的で利用者がウェブサイトやアプリを使用して検索したときに発生します。利用者が地元の店で特定の商品を探そうとした。	任意。	FIND_LOCATION
`InitiateCheckout`	利用者がチェックアウトフローを完了する前にチェックアウトフローに入ったときに発生します。利用者が[チェックアウト]ボタンをクリックした。	`content_ids`、`contents`、`currency`、`num_items`、`value` 任意。	INITIATE_CHECKOUT
`Lead`	登録が完了したときに発生します。利用者が価格をクリックした。	`currency`、`value` 任意。	LEAD
`Purchase`	購入されたとき、またはチェックアウトフローが完了したときに発生します。利用者が購入やチェックアウトのフローを終了し、サンキューページや確認ページにランディングした。	`content_ids`、`content_type`、`contents`、`currency`、`num_items`、`value` 必須: `currency`および`value` Advantage+ 広告の場合は必須: `contents`または`content_ids`	PURCHASE
`Schedule`	いずれかの所在地への訪問予約を利用者が取ったときに発生します。利用者がテニスレッスンの日時を選択した。	任意。	SCHEDULE
`Search`	検索が行われたときに発生します。利用者があなたのウェブサイトで商品を検索した。	`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_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	このイベントを実行しているユーザーのビジネスに対する価値。