排版的度爛說明
關於本份文件的排版與分類是否感到非常迷惑與不解呢?或許有或許沒有,但是本於終於原著的精神,基本上的結構是以 Facebook 官方提供的 changelog 進行整理的,所以與官方版本相似性很高噢。 😘
不的不面對的死線
-
Marketing API 舊版終止時間:2016/07 正式終止 2.6 版之前的 API 支援
- Graphic API 舊版終止時間:2018/04/12 正式終止 2.6 版之前的 API 支援
被搞過調整的東西
Pages
• Page API 內的 likes 更名爲 fan_count,有沒有聞到 Unique Users 的味道了?
Marketing API
• Ads Management
• 移除 connectionobjects API,未來改用以下方式獲取廣告物件,避免一次拿到全部的物件:
• Pages: user_id/accounts
• Events: user_id/promotable_events
• Apps:
adaccount_id/advertisable_applications
• Domains: user_id/promotable_domains
• 分享 Custom Audience 可透過 <CUSTOM_AUDIENCE_ID>/adaccounts API,另外可指定權限。權限又分爲只可使用於廣告投遞-targeting、以及可投遞與可使用 Insight Tool 閱覽 Audience 的 Demographics 資訊-targeting_and_insights。
• Targeting
• 設定投遞裝置的 user_device 格式從 [“samsung_galaxy_s6”] 的樣式,簡化變更爲 [“galaxy s6”]。從
API /search?type=adTargetingCategory&class=user_device 獲得的裝置名稱都已經採用新的格式,寫入的規格也需要改爲新版。
• Insights
• 改變預設的
date_preset ,從 lifetime 變更爲 last_30_days。
• 改變預設回傳的 fields,現在只會回傳 impressions 與 spend,如果需要其他資料請不要偷懶自行指定欄位。
• fields 的參數現在不可傳入像是 age 或是 gender 的 breakdown ,請把這些參數帶入 breakdowns parameter,相關的可用參數請自行翻翻文件。
• 現在不管怎麽下,只要下的區間是未來,像是今天到明天,或是下週到明年,Insights API 會拋出錯誤而不是空值給你。
• Dynamic Ads
• Changed Product Catalog Sales 這個 Objective 廣告的預設 optimization_goal 改爲 OFFSITE_CONVERSIONS。
• Carousel 再 object_story_spec 內的 force_single_link 的預設值改爲 true,這是爲了解決,從 Carousel 改爲其他形態的時候可能導致廣告設定值異常的問題。
• 設定
(S)FTP 自動下載型錄的時候,若沒有傳入帳號密碼會拋出 error,如果沒有帳號密碼請傳空字串,而不是不傳入。e.g. username:””
• Lead Ads
• 讀取回傳結果時,自定問題的 label 與 question 將會互換,以確保結果會被正確的回傳。
倒數 90 天的死線(包含 Graphic API)
• 全部的
Callback 訂閱都要升級爲 Https - 通通、通通,聽好噢,通通都要升級,不然就 GG 了。
• Page Request 的 Rate Limit 公式調整 - 從 07/11 開始,使用 Page Access Token 呼叫的操作,將根據 Page 按讚的人數決定,所以越多人 Rate Limit 越高,殭屍 Page 的 Rate Limit 就哭哭了。
新東西
權限
• 收發粉絲專頁訊息 - 現在可以要求 pages_messaging ,取得在專頁上收發訊息的權限。
• 以手機號碼收發粉絲專頁訊息 - 現在可以要求 pages_messaging_phone_number,取得在專頁上以手機號碼作爲 Id 收發訊息的權限。
粉絲專頁
• 澳洲粉絲備註
- 新的 API 允許專頁管理員對粉絲進行備註,請參考 admin_notes API 得知如何註記常常罵髒話的粉絲。
• 澳洲粉絲分類
- 新的 API 允許專頁管理員對粉絲進行分類,請參考 labels API 得知如何將常常罵髒話的列入澳洲羣組。
• 透過專頁專屬的使用者 Id 與手機號碼發送訊息 - 粉絲專頁現在可以透過 Id 或者手機號碼,送出文字、附件、罐頭訊息給粉絲。
影片 APIs
• 直播
API - 可發起與管理直播,但使用這些 API 需要獲得授權,詳情請洽詢各位自己的 Facebook 窗口,或者可愛的貓頭鷹。
• 直撥影片狀態 - 現在的 Video API 會多一個欄位叫做 live_status,用來描述影片的直撥狀況,其中有三種狀態: LIVE,
LIVE_STOPPED, VOD,如果得到一個 null ,代表影片從來沒有被直播過。
• 直播觀看數量 - 現在的
Video API 會多一個欄位叫做 live_audience_count ,統計直播影片的時候 Unique Viewer 的數量。
• 跨貼文影片
- 粉絲專頁現在可以使用擁有的影片來建立貼文,而不需要重新上傳同一個影片。主要的好處是,這樣觀看 Insights 的時候,可以一次看到單一影片再不同貼文的表現。可從影片的 API 內找到 is_crossposting_eligible 與 crossposted_video_id ,以及粉絲專頁 API 的 videos_you_can_use 來實現這個功能。
• 影片標籤
- Video 的 API 會多一個 content_tags 欄位,允許爲影片增加標籤。
• 影片洞察報告 - Video 的 API 會多一個 video_insights Edge,或許影片的總體(跨貼文)洞察報告。也增加了衡量每日、每分、10秒爲觀點的影片洞察報告。
Messenger API
• Webhooks - 新增原本粉絲專頁可訂閱的項目 messages, message_deliveries, messaging_optins, messaging_postbacks 。這些 Messenger 平臺的事件可收到傳入訊息、授權事件、交貨確認、從結構化訊息回傳的點擊事件。
• Send to Messenger Plugin - 新的網頁 Plugin ,用於授權使用者使用 Messenger 平臺,讓他們透過 Messenger 跟你買東西。
• Message Us Plugin - 新的網頁 Plugin ,讓使用者可以直接送訊息到你的專頁。
• Send/Receive API - 新的 API,用來接收與傳送訊息。
Sharing for Devices
• Sharing for Devices - 新的 Sharing for
Devices API,方便輕鬆容易的從裝置上分享生活點滴到 Facebook。
Reactions API
• Reactions API - 新的 reaction edge,可用來讀取使用者對於廣告物件做的情感動作。
被幹掉移除的東西
Page Insights
雖然以下 API 通通被移除了,但實際上只是改名字,新的 API 名稱都是以 page_views 開頭,相關細節請自行翻閱文件
• page_visits_by_age_gender_logged_in_unique
• page_visits_by_internal_referer_logged_in_unique
• page_visits_by_profile_tab_logged_in_unique
• page_visits_by_profile_tab_total
• page_visits_by_site_logged_in_unique
• page_visits_logged_in_total
Total logged
• page_visits_logged_in_unique
Total logged
• page_visits_total
移除 oauth/device
原本使用這個 API 取得 access tokens 的朋友,請改以 device/login 與 device/login_status 噢。
Marketing API
• Dynamic Ads
• 移除
AdSet 內的 product_ad_behavior 欄位,取而代之每個 AdSet 的預設值是 FALL_BACK_TO_FB_RECOMMENDATIONS ,意思是 Facebook 會自動從 Product Set 找出效益最高的項目,並投遞給那些瀏覽過不在 Product Set 內商品的受衆。
• 移除
DPA 的 <PAGE_ID>/rtb_dynamic_posts,並以 <OBJECT_STORY_ID>/dynamic_posts 取代。
• 移除 max_product_count 項目,由於 Facebook 會自動根據數據優化每個 DPA 顯示的數量,因此不需要再做這個設定,如果是想要顯示單一產品,不顯示 Carousel 格式。可將 object_story_spec 內的 force_single_link 設定爲 true。
• 移除上傳
Product Feed 錯誤 /<UPLOAD_ID>/errors 內的 row_number 與 column_number。
• 6 個月倒數
• Game Groups Beta,又名 App Groups,要移除了。
Feed
Dialog,使用 Feed Dialog 的 App,未來只有在 share 動作有再使用者的動態消息牆上面產生一則貼文時,才會回傳 post_id。同時必須取得 publish_actions 的權限,才有辦法進行以上動作。