FB Ads API Meetup #2にて発表したスライドです。

1. Facebook広告運用ツール
Datos（ダトス）の運用事例
yuji0602@cocolable inc

2. Self Introduction
• yuji0602
• 株式会社ココラブル
• 開発室
• 広告運用ツールDatosを主に開発／運用

3. http://www.datos-manage.com/

4. 今日お話すること
• Datos開発前
• Datos作成にあたって
• Datos作成後
• 課題
• API利用例

5. Datos開発前

6. Datos開発前
• 2013年頃
• 社内向けツールでレポーティングをしていた
• Facebookの広告マネージャにスクレイピング
• gem mechanizeを使用していた
• CSVをダウンロードして都合よく加工してレポート集計
• あくるタイミングからCSSが週ごとに変わり地獄の運用にな
った

7. Datos開発前
• 2014年頃
• 念願のAds Management APIが使えるようになった
• gem koalaを使用して
act_<ACCOUNT_ID>/reportstatsを叩きまくって捗
った
• APIを利用して広告入稿も始めた

8. Datos作成にあたって

9. Datos作成にあたって
• 2014年頃
• 社外向けツールを展開するプロジェクトが始まる
• この当時社員のエンジニアが少なかったため外部の
エンジニアをアサイン
• 社内ツールと社外ツールが混同してプログラムの複
雑度が高い

10. Datos作成にあたって
• 開発当時にはSDKがPHPのみ提供されていたので
PHPを採用
• とはいえ当時のSDKの機能をあまり使っていない
• そのツケが回ってなのか、今も技術負債を抱えてい
る

11. Datos作成にあたって
• APIの利用方法についてFacebookのドキュメントを
見てもあまりサンプルがなく手探り状態だった
• あくるタイミングで広告マネージャーをChromeの
デベロッパーツールを見るとAPIを叩いているのが
見れたのでこれにすがるようになった
• Marketing APIと呼ばれるようになってからドキュ
メントがだいぶ分かるようになった

12. Datos作成後

13. Datos作成後
• クライアントへのレポーティングが楽になった
• 広告入稿について、CSVと画像を使って広告を大量
に入稿できるようになった
• この喜びを社外のFacebook広告運用者にも伝えた
い

14. 課題

15. 課題
• レポート集計がまれに失敗。
• 広告を100件くらい一括で入稿するとものすごい時
間がかかる
• APIバージョンUP対応が定期的にやってくる
• 使ってたエンドポイントがdeprecatedになるのつら
い

16. API利用例

17. API利用例
• Datosで実際に使っているAPIの例を書いていきます。
• Graph API Explorerをご利用ください。
• https://developers.facebook.com/tools/explorer/
• Ads Management APIの以下のパーミッションが許可されて
いることを前提にしています。
• ads_management
• ads_read

18. API利用例
• 例１．広告のサムネイルを取得
• <ADGROUP_ID>?fields=id,creative.fields(id,title,name,body,ima
ge_hash,image_url,link_url,object_id,object_type,object_story_id
,object_url,thumbnail_url).thumbnail_width(158).thumbnail_heig
ht(82)
• 広告IDからcreativeをネストでcallする
• サムネイルのサイズを.thumbnail_[width|height]()で設定している
のがポイント

19. API利用例
• 例２．広告名で検索してキャンペーン、広告セット、広告を取得
• act_<ACCOUNT_ID>/campaigns?fields=id,configured_status,name,objective,adset
s.filtering([{‘field': 'ad.name', 'operator': 'CONTAIN', 'value':
‘<SEARCH_WORD>’}]).limit(20).fields(id,configured_status,name,start_time,end_ti
me,daily_budget,lifetime_budget,budget_remaining,insights.fields(spend),ads.filterin
g([{'field': 'ad.name', 'operator': 'CONTAIN', 'value':
'<SEARCH_WORD>'}]).limit(20).fields(id,configured_status,name,creative.fields(id,o
bject_story_id,thumbnail_url).thumbnail_width(158).thumbnail_height(82)))
• キャンペーン、広告セット、広告の名前とかステータスとかサムネイルを表示
• filteringを利用して広告名を検索しているのがポイント

20. おわり