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

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

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

主なルートノードは次のとおりです。

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

ユーザー

エッジ

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

広告アカウント

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

エッジ

エッジ	表すもの
`/campaigns`	キャンペーンの目的を定義する。1つ以上の広告セットを含む
`/adsets`	同じ予算、スケジュール、入札、およびターゲット設定を共有するすべての広告を含む
`/ads`	クリエイティブエレメントや効果測定情報など、広告のデータ
`/adcreatives`	広告の外観とコンテンツを定義する
`/adimages`	広告クリエイティブで使用する画像のライブラリ。独立してアップロードおよび管理可能
`/advideos`	広告クリエイティブで使用する動画のライブラリ。独立してアップロードおよび管理可能
`/activities`	広告アカウントで実行されたアクションのログ
`/adtags`	広告アカウントのタグのセット。類似したキャンペーン、広告セット、または広告のタグ付けに使用
`/adcampaignconversions`	広告アカウントの広告セットごとに集計されるコンバージョンデータ
`/adgroupconversions`	広告アカウントの広告ごとに集計されるコンバージョンデータ
`/customaudiences`	広告アカウントのカスタムオーディエンス。広告のターゲットを自分のビジネスとすでに関係のある人に設定するのに役立つ
`/generatepreviews`	広告のプレビューを生成する
`/offsitepixels`	このアカウントに関連付けられているピクセル
`/reachestimate`	特定のターゲット設定仕様を持つ広告の推定リーチを生成する
`/reportstats`	広告アカウントデータを取得してレポートをスケジューリングするレポートAPI
`/adcampaignstats`	広告アカウントの広告セットごとに集計される統計情報のセット
`/adgroupstats`	広告アカウントの広告ごとに集計される統計情報のセット
`/targetingsentencelines`	広告セットのターゲット設定について、人間が読める形式の説明を生成する
`/users`	広告アカウントに関連付けられているユーザーのリスト
`/insights`	インサイトのインターフェイス。子オブジェクトの結果の重複を除去し、並び替え機能を提供し、非同期レポートを生成する。

広告キャンペーン

エッジ

エッジ	表すもの
`/adsets`	同じ予算、スケジュール、入札、およびターゲット設定を共有するすべての広告を含む。
`/ads`	クリエイティブエレメントや効果測定情報など、広告に必要なデータ
`/adtags`	キャンペーンのタグ。類似したキャンペーンを簡単に見つけるために使用
キャンペーンごとに集計される統計情報の単一セットを返す
`/insights`	インサイトのインターフェイス。機能として、子オブジェクトの重複除去、並び替え、非同期レポートの作成が含まれる。

広告セット

エッジ

エッジ	表すもの
`/ads`	クリエイティブエレメントや効果測定情報など、広告に必要なデータ
`/adcreatives`	広告のコンテンツと外観を定義する
`/activities`	広告セットで実行されたアクションのログ
`/adtags`	広告セットのタグ。類似した広告セットを簡単に見つけるために使用
`/conversions`	広告セットのコンバージョンデータ
`/insights`	インサイトのインターフェイス。機能として、子オブジェクトの重複除去、並び替え、非同期レポートの作成が含まれる。

エッジ	表すもの
`/adcreatives`	広告の外観とコンテンツを定義する
`/adtags`	広告のタグ。類似した広告を見つけるために使用
`/conversions`	広告のコンバージョンデータ
`/keywordstats`	広告のターゲットに設定されたキーワードごとの統計情報を返す
`/previews`	既存の広告から広告プレビューを生成する
`/reachestimate`	広告の推定リーチを取得する
広告の統計情報のセット
`/targetingsentencelines`	広告セットのターゲット設定について、人間が読める形式の説明を取得する
`/trackingtag`	広告にクリックタグを割り当てる。クリックトラッキングタグにより、広告クリック時の移動先となるURLを指定。
`/insights`	インサイトのインターフェイス。機能として、子オブジェクトの重複除去、並び替え、非同期レポートの作成が含まれる。