リファレンス

投稿

エンドポイント説明

/{ad-account-id}/ads

広告を作成します。

/{business-id}/initiated_sharing_agreements

処理待ちビジネス合意リクエストを承認または却下します。

/{business-creative-folder-id}

ビジネスクリエイティブフォルダーを作成・更新します。

/{business-id}/creative_folders

ビジネスクリエイティブフォルダーを指定します。

/{business-id}/images

クリエイティブフォルダーに画像をアップロードします。

/{business-id}/videos

クリエイティブフォルダーに動画をアップロードします。

/{business-creative-folder-id}/agencies

クリエイティブフォルダーにパートナーを追加します。

/{business-creative-folder-id}/assigned_users

ビジネスクリエイティブフォルダーにアクセスできる人のリストを取得します。

読み取り

エンドポイント説明

/{business-creative-folder-id}

ビジネスクリエイティブフォルダーの詳細を取得します。

/{business-id}/creative_folders

ビジネスがアクセスできるビジネスクリエイティブフォルダーのリストを取得します。

/{business-id}/creatives

ビジネスのビジネス画像とビジネス動画を取得します。

/{business-id}/initiated_sharing_agreement

承認待ちの合意リクエストのリストを取得します。


このエンドポイントは2020年5月に再導入されました。それ以前、/initiated_sharing_agreementグラフAPI V6.0の公開により廃止されていました。

/{business-image-id}

画像の詳細を取得します。

/{business-image-id}/insights

共有画像のインサイトを取得します。

/{business-video-id}

共有動画の詳細を取得します。

/{business-video-id}/insights

共有動画のインサイトを取得します。

/{business-creative-folder-id}/agencies

該当クリエイティブフォルダーにアクセスできるビジネスのリストを取得します。

/{business-creative-folder-id}/assigned_users

該当クリエイティブフォルダーにアクセスできる人のリストを取得します。

削除

エンドポイント説明
/{business-creative-folder-id}

クリエイティブフォルダーを削除します。

/{business-creative-folder-id}/agencies

クリエイティブフォルダーからパートナーを削除します。

/{business-creative-folder-id}/assigned_users

クリエイティブフォルダーからユーザーを削除します。

/{business-image-id}

共有画像を削除します。

/{business-video-id}

共有動画を削除します。

許可されているタスク

ビジネスユーザーに対して許可されているタスク説明

CREATE_CONTENT

このユーザーは、フォルダーを作成できます。

MANAGE_CONTENT

このユーザーは、クリエイティブフォルダーアセットを管理できます。

MANAGE_PERMISSIONS

このユーザーは、ビジネスクリエイティブフォルダーのアクセス許可を管理できます。

VIEW_CONTENT

このユーザーは、クリエイティブフォルダー内のアセットを閲覧できます。

VIEW_INSIGHTS

このユーザーは、クリエイティブアセットのインサイトを閲覧できます。

インサイト

これらの指標は開発中です。

指標名説明
impressions

画像または動画が広告に表示された回数。

inline_link_clicks

広告内のリンクをクリックした回数。インラインリンクのクリックでは、固定クリック1日アトリビューション時間枠を使います。

video_play_actions

動画の再生が開始された回数。動画インプレッションごとにカウントされ、リプレイは除外されます。

actions

該当広告がきっかけとなって実行されたアクションの合計数。アクションには、エンゲージメント、クリック、コンバージョンが含まれることがあります。サポートされているタイプの完全なリストについては、こちらのドキュメントをご覧ください。

video_thruplay_watched_actions

動画が最後まで再生されたか、15秒以上再生された回数です。

quality_ranking

広告の評価品質のランキング。品質は。広告のフィードバックとクリック後エクスペリエンスを使って測定されます。広告のランキングは、同じオーディエンスを対象として競合する他の広告との比較によります。


次のような値を指定できます。

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN、広告に関する情報が不足している場合。

これは広告関連度診断に関連する値です。

次の内訳を使うことができます。

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal