マーケティングAPIバージョン

マーケティングAPIリファレンス

以下は、FacebookマーケティングAPIのルートノードの全リストであり、それぞれのリファレンスドキュメントにリンクされています。APIのアーキテクチャの背景、またルートノードとそのエッジの呼び出し方法については、グラフAPIの利用をご覧ください。

すべてのリファレンス情報にアクセスするには、Facebookにログインする必要があります。

ノード	説明
`/{AD_ACCOUNT_USER_ID}`	広告を作成するFacebookユーザー。各広告ユーザーが複数の広告アカウントで1つの役割を持つことが可能。
`/act_{AD_ACCOUNT_ID}`	広告を管理するビジネスエンティティを表す。
`/{AD_ID}`	クリエイティブエレメントや効果測定情報など、広告の情報を含む。
`/{AD_CREATIVE_ID}`	画像、カルーセル、コレクション、動画広告のフォーマット。
`/{AD_SET_ID}`	同じ予算、スケジュール、入札、ターゲット設定を共有するすべての広告を含む。
`/{AD_CAMPAIGN_ID}`	広告キャンペーンの目的を定義する。1つ以上の広告セットを含む。

ユーザー

エッジ	説明
`/adaccounts`	このユーザーに関連付けられているすべての広告アカウント
`/accounts`	管理者ユーザーが存在するすべてのページとスポット
`/promotable_events`	自分が作成した宣伝可能なすべてのイベント、または自分が管理者となっているページに属する宣伝可能なすべてのページイベント

1つの広告アカウントに属する、マーケティングAPIの広告オブジェクトの全コレクション。

広告アカウントノードの特に人気のあるエッジ。すべてのエッジのリストについては、「広告アカウントエッジリファレンス」をご覧ください。

エッジ	説明
`/adcreatives`	広告の外観とコンテンツを定義する
`/adimages`	広告クリエイティブで使用する画像のライブラリ。単独でアップロードと管理が可能
`/ads`	クリエイティブエレメントや効果測定情報など、広告のデータ
`/adsets`	同じ予算、スケジュール、入札、およびターゲット設定を共有するすべての広告を含む
`/advideos`	広告クリエイティブで使用する動画のライブラリ。単独でアップロードと管理が可能
`/campaigns`	キャンペーンの目的を定義する。1つ以上の広告セットを含む
`/customaudiences`	この広告アカウントが所有する、またはこの広告アカウントと共有されているカスタムオーディエンス
`/insights`	インサイトのインターフェイス。子オブジェクトの結果の重複を除去し、並び替え機能を提供し、非同期レポートを生成する。
`/users`	広告アカウントに関連付けられているユーザーのリスト

広告セットとは、1日の予算または通算予算、スケジュール、入札タイプ、入札情報、ターゲット設定データを共有する広告のグループです。

広告セットノードの特に人気のあるエッジ。すべてのエッジのリストについては、「広告セットエッジリファレンス」をご覧ください。

エッジ	説明
`/activities`	広告セットで実行されたアクションのログ
`/adcreatives`	広告のコンテンツと外観を定義する
`/ads`	クリエイティブエレメントや効果測定情報など、広告に必要なデータ
`/insights`	広告パフォーマンスについてのインサイト。

キャンペーンは、広告アカウント内の管理構造の最上位にあるものです。特定の広告主の単一の目的を表現するために使われることを想定しています。

広告キャンペーンノードの特に人気のあるエッジ。すべてのエッジのリストについては、「広告キャンペーンエッジリファレンス」をご覧ください。

エッジ	説明
`/ads`	クリエイティブエレメントや効果測定情報など、広告に必要なデータ
`/adsets`	同じ予算、スケジュール、入札、およびターゲット設定を共有するすべての広告を含む。
`/insights`	広告パフォーマンスについてのインサイト。

レイアウトを提供し、広告のコンテンツを含むフォーマット。

広告クリエイティブノードの特に人気のあるエッジ。すべてのエッジのリストについては、「広告クリエイティブエッジリファレンス」をご覧ください。

エッジ	説明
`/previews`	既存の広告クリエイティブオブジェクトから広告プレビューを生成する