FaceBook グラフAPIエクスプローラで広告の情報を取得する。

#概要
FaceBookの広告アカウントで出稿している広告のレポートデータを取得しようとしたがドキュメントが壮大なので読み込みや理解に時間が掛かってしまった。「最初に、これが解ってれば早かったのに。。」というところをまとめておきます。

(2020/12/05時点の内容)

準備

ビジネスアカウントに開発アカウントで作成したAPP（開発用）を追加する必要があります。
開発アカウントでAPPを作成し、ビジネスアカウントの設定画面から登録する流れになります。
登録フローは、仕様によって変わるのでご自身で検索して見てください。

##グラフAPIエクスプローラとは

Developersアカウントにて使用できる開発ツールです。
テストでデータの取得するなど様々なことが出来ます。
どのAPIを使うかわからないとき、とりあえず試せるのが素敵。

###FaceBook広告の概念
階層として、キャンペーン/広告セット/広告 となっています。
各種にIDが振られています。

ビジネスアカウントID　= act　　
自分のアカウントID　　= business_id
キャンペーンのID　　　 = selected_campaign_ids
広告セットのID　　　　= selected_adset_ids
広告のID　　　　　　　= selected_ad_ids

指定するとき必要になるので覚えておいてください。

###APIのURL

キャンペーン　　【各種ID】/campaigns
広告セット　　　【各種ID】/adsets
広告　　　　　　【各種ID】/ads
クリエイティブ　【各種ID】/adcreatives
広告レポート　　【各種ID】/insights

ビジネスアカウントIDの場合のみ'act_'をつける必要があります。例 : act_12345678/ads

###取得したい値
取得したい値は,fieldsで指定することが出来ます。
例 : fields=name,status
上記のURLと組み合わせて使用します。
#####例 ： act_12345678/campaigns?fields=name,status

作成したキャンペーンの名前とステータスを取得することが出来ます。

####実践
####1. FaceBookアプリを指定し、アクセストークンを発行します。

#####2. URLにIDと参照したいものを指定する。
ここでは、ビジネスアカウントIDの所有するキャンペーンの名前とステータスを呼び出します。
例 act_12345678/campaigns?fields=name,status

####3. 送信ボタンをクリックして下記の結果になっていれ取得出来てます！

{
  "data": [
    {
      "name": "キャンペーン名",
      "status": "ACTIVE",
      "id": "123456789"
    },
    {
      "name": "キャンペーン名",
      "status": "PAUSED",
      "id": "12345678"
    },  
  ],
  "paging": {
    "cursors": {
      "before": "hoge",
      "after": "hoge"
    }
  }
}

この基本的な検証方法さえ解っていれば、簡単に欲しい情報をドキュメントから得れると思います。

キャンペーン　https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group
広告セット　https://developers.facebook.com/docs/marketing-api/reference/ad-campaign
広告　https://developers.facebook.com/docs/marketing-api/reference/adgroup
広告レポート　https://developers.facebook.com/docs/marketing-api/insights
クリエイティブ　https://developers.facebook.com/docs/marketing-api/reference/ad-creative

公式スタートガイド
https://developers.facebook.com/docs/marketing-apis/get-started

####あとがき
このツールを知らずに、Laravelにコマンドを作成しては、検証を行っていたのでツールを知ったときに便利すぎて膝から崩れ落ちました。。。
私自身、FaceBookAPIの知識はまだまだですが、概念や基本的な検証に時間を使ってしまうのはもったいないと思い作成致しました。9ヶ月目のエンジニアの拙い記事ですが、同じ広告系エンジニアの力になれたと思います。