広告数

広告アカウントの広告数の確認

広告アカウントの広告数を確認するには、次のようにします。

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

応答

{"data":[{"ads_running_or_in_review_count":2}]}

広告量の管理について詳しくは、広告数の管理についてをご覧ください。

掲載中または審査中のステータスの表示

広告が掲載中または審査中かを調べるには、次のように、effective_status、configured_status、広告アカウントのステータスという順にチェックします。

• 広告のeffective_statusが1 - activeの場合、掲載中または審査中のステータスであると見なします。
• 広告のconfigured_statusがactiveで、effective_statusが9 - pending reviewまたは17 - pending processingの場合、掲載中または審査中であると見なします。
• 広告アカウントステータスが1 - active、8 - pending settlement、9 - in grace periodの場合にのみ、広告は掲載中または審査中になります。

広告セットのスケジュールに基づいて、広告が掲載中または審査中かを確認することもできます。

• 開始時間が現時刻より前で、現時刻が終了時間より前の場合、広告が掲載中または審査中であると見なします。
• 開始時間が現時刻より前で、広告セットに終了時間がない場合も、広告が掲載中または審査中であると見なします。

例えば、広告セットが将来掲載されるようスケジュールされている場合、広告は掲載中または審査中にはなりません。ただし、広告セットが現在から3カ月間掲載されるようスケジュールされている場合、広告が掲載中または審査中であると見なします。

デイパーティングなどの特別な広告スケジュール機能を使用している場合、広告の掲載が開始されたとき、一日のある部分だけではなく一日中広告が掲載中または審査中であると見なします。

アクターごとの内訳

show_breakdown_by_actorフィールドを使用して、特定のactor_idごとに広告制限の内訳を取得します。

curl -G \
  -d "show_breakdown_by_actor=true" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

応答

{
  "data": [
    {
      "ads_running_or_in_review_count": 0,
      "current_account_ads_running_or_in_review_count": 0,
      "actor_id": "<ACTOR_ID_1>",
      "recommendations": [
      ]
    },
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID_2>",
      "recommendations": [
      ]
    }
  ],
}

page_idを使用して、特定のページの広告制限を取得します。

curl -G \
  -d "page_id=<PAGE_ID>" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

応答

{
  "data": [
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID>",
      "recommendations": [
      ]
    }
  ],
}

サポートされるフィールド

パラメーター