アドテク

FacebookインサイトAPIのフィールド日本語対応表(2019年5月版)・管理画面と照合してみました

  • このエントリーをはてなブックマークに追加
  • Pocket

こんにちは、石垣です。
個人では令和の初記事になります!令和はもう少し情報発信できればと思っています。

今回はFacebookのAPIを利用されている方の役に立つ…かもしれない、APIと管理画面の項目照合表を作りました。

【注意点!】
・調査は人力で行っており、正確な答え合わせはFacebook社にしかできないため、参考程度にご覧ください。

※本記事の内容は2019年5月現在の情報です。最新の設定方法や画面と異なる場合があります。

FacebookのAPIについて

Facebookが公開しているAPIにはグラフAPIやページAPIといったものがあり、その種類は様々です。
コンテンツ投稿などのFacebookへのデータ送信、いいね!数の確認などのデータ取得と、APIによってできることは異なります。

弊社では、管理画面にログインしなくてもFacebook広告の配信結果を取得できるシステムで「インサイトAPI」を利用しています。

この「インサイトAPI」は「マーケティングAPI」というAPIの一部に分類されています。こういったAPI群の大元になるのが「グラフAPI」で、FacebookのAPIはすべてグラフAPIの拡張版なのです。

FacebookAPIの関係性イメージ図

参考: グラフAPI
https://developers.facebook.com/docs/graph-api/?locale=ja_JP

(ややこしくて困りますが)いろいろなことができるのでわくわくしますよね!!!!!!

インサイトAPIでできること

このAPIではFacebook広告アカウントが管理しているキャンペーンの情報や広告配信結果、それらに関連する情報を取得できます。

Facebook広告運用の経験がある方ならおわかりかと思いますが、広告マネージャーの画面で指標や各数値を確認したり、ダウンロードしてきたりするのは結構手間がかかります。APIがあればこういったものをブラウザを使わず取得できるのです。うまく使えば時短になりますし、システムに組み込んで高度な分析にも活用可能です。

クリック数やコストの値は、インサイトAPIの「フィールド」に格納されます。
しかしAPIは便利な半面なかなかの曲者で、管理画面で見えている通りの名前ではデータをくれません。
そこで今回のような照合表を作ってみました。

FacebookインサイトAPI:フィールドの照合表

本記事の内容は2019/05/20時点での下記ページを参考にしています。

◆インサイト:パラメーターとフィールド
https://developers.facebook.com/docs/marketing-api/insights/parameters

繰り返しますが、人力の調査のもと作成したものになり、Facebook側の仕様変更で内容が変わる可能性がありますので、最新情報は公式ドキュメントをご覧ください!!

※管理画面上で見つからないものは「?」としています

管理画面名称 フィールド名 備考
?(広告アカウントで使用されている通貨) account_currency string
アカウントID account_id numeric string
アカウント名 account_name string
action_values list<AdsActionStats>
actions list<AdsActionStats>
広告ID ad_id numeric string
広告の名前 ad_name string
広告セットID adset_id numeric string
広告セット名 adset_name string
app_store_clicks numeric string
購入タイプ buying_type string
キャンペーンID campaign_id numeric string
キャンペーン名 campaign_name string
インスタントエクスペリエンスの閲覧率 canvas_avg_view_percent numeric string
インスタントエクスペリエンスの閲覧時間 canvas_avg_view_time numeric string
クリック(すべて) clicks numeric string
動画10秒再生の単価 cost_per_10_sec_video_view list<AdsActionStats>
cost_per_action_type list<AdsActionStats>
推定広告想起リフトの単価(人) cost_per_estimated_ad_recallers numeric string 開発中の指標
CPC(リンククリックの単価) cost_per_inline_link_click numeric string
cost_per_inline_post_engagement numeric string
アウトバウンドクリックの単価 cost_per_outbound_click list<AdsActionStats>
ThruPlayの単価 cost_per_thruplay list<AdsActionStats> 開発中の指標
cost_per_unique_action_type list<AdsActionStats>
ユニーククリック単価(すべて) cost_per_unique_click numeric string
リンククリックの単価(ユニーク) cost_per_unique_inline_link_click numeric string
ユニークアウトバウンドクリックの単価 cost_per_unique_outbound_click list<AdsActionStats>
CPC(すべて) cpc numeric string
CPM(インプレッション単価) cpm numeric string
リーチ1,000人当たりの単価 cpp numeric string
CTR(すべて) ctr numeric string
レポート開始日 date_start string
レポート終了日 date_stop string
deeplink_clicks numeric string
estimated_ad_recall_rate numeric string
estimated_ad_recallers numeric string 開発中の指標
フリークエンシー frequency numeric string
インプレッション impressions numeric string
CTR(リンククリックスルー率) inline_link_click_ctr numeric string
リンクのクリック inline_link_clicks numeric string
投稿のエンゲージメント inline_post_engagement numeric string
モバイルアプリでの購入ROAS(広告費用対効果) mobile_app_purchase_roas list<AdsActionStats> 廃止予定
newsfeed_avg_position numeric string
newsfeed_clicks numeric string
newsfeed_impressions numeric string
広告の目的 objective string
アウトバウンドクリック outbound_clicks list<AdsActionStats>
アウトバウンドCTR (クリック率) outbound_clicks_ctr list<AdsActionStats>
購入ROAS(広告費用対効果) purchase_roas list<AdsActionStats>
リーチ reach numeric string
関連度スコア relevance_score AdgroupRelevanceScore 廃止予定
social_spend numeric string
消化金額 spend numeric string
unique_actions list<AdsActionStats>
ユニーククリック(すべて) unique_clicks numeric string
ユニークCTR(すべて) unique_ctr numeric string
unique_impressions numeric string
ユニークCTR(リンククリックスルー率) unique_inline_link_click_ctr numeric string
リンククリック(ユニーク) unique_inline_link_clicks numeric string
ユニークCTR(リンククリックスルー率) unique_link_clicks_ctr numeric string
ユニークアウトバウンドクリック unique_outbound_clicks list<AdsActionStats>
ユニークアウトバウンドCTR (クリック率) unique_outbound_clicks_ctr list<AdsActionStats>
動画の10秒再生数 video_10_sec_watched_actions list<AdsActionStats>
video_30_sec_watched_actions list<AdsActionStats>
video_avg_percent_watched_actions list<AdsActionStats>
動画の平均再生時間 video_avg_time_watched_actions list<AdsActionStats>
video_complete_watched_actions list<AdsActionStats>
動画の100%再生数 video_p100_watched_actions list<AdsActionStats>
動画の25%再生数 video_p25_watched_actions list<AdsActionStats>
動画の50%再生数 video_p50_watched_actions list<AdsActionStats>
動画の75%再生数 video_p75_watched_actions list<AdsActionStats>
動画の95%再生数 video_p95_watched_actions list<AdsActionStats>
動画再生数 video_play_actions list<AdsActionStats> 開発中の指標
video_play_curve_actions list<AdsHistogramStats>
ThruPlay video_thruplay_watched_actions list<AdsActionStats>
website_clicks numeric string
website_ctr list<AdsActionStats>
website_purchase_roas list<AdsActionStats>

実際にはフィールドと様々なもの(データの対象範囲など)を組み合わせた上でFacebookにデータを要求する必要があるのですが、まずはどの指標のことを指しているのか把握するとAPIの理解がしやすいかもしれません。

APIで広告データを自動取得するシステム「HARBEST」

今回紹介したAPIを利用して、弊社ではマーケティングデータETLツール「HARBEST(ハーベスト)」を開発しています。
HARBESTはFacebookだけでなく様々なプラットフォームからデータを自動取得し、Amazon S3などに出力することができます!

広告やSNSの分析においては、まず分析のためのデータを手元に集める作業が必要ですが、想像以上にコストがかかってしまいお悩みの方も多いのではないでしょうか。
そういったデータ収集コストの削減にHARBESTがお役に立てると思います!

まだ正式提供前となっていますが、この度公式サイトをオープンしました。
ご興味のある方はぜひご覧になってください。
お問い合わせもお待ちしております!

↓サービスサイトはこちらをクリック

HARBEST公式サイトはこちらをクリック

この記事が役に立ったらぜひ↓のSNSボタンを押してもらえると嬉しいです!

運用型広告レポート自動化ツールアドレポ
  • follow us in feedly
  • このエントリーをはてなブックマークに追加