2016年4月14日 星期四

Facebook Platform API 2.6


排版的度爛說明

關於本份文件的排版與分類是否感到非常迷惑與不解呢?或許有或許沒有,但是本於終於原著的精神,基本上的結構是以 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 的數量。
•   版權管理 API - 新的版權管理 API 允許擁有版權的人,可以對影片註記擁有權限,並記錄版權規則。使用這個功能請至 Rights Manager Enrollment 網站操作。
•   跨貼文影片 - 粉絲專頁現在可以使用擁有的影片來建立貼文,而不需要重新上傳同一個影片。主要的好處是,這樣觀看 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 的權限,才有辦法進行以上動作。

沒有留言:

張貼留言