發佈日期:2018 年 5 月 1 日 | 有效期限:2020 年 7 月 28 日 | 部落格文章
subscribed_domains_phishing
端點訂閱網路釣魚警示的網域。groups_access_member_info
和 publish_to_groups
。存取權杖到期:若用戶在過去 90 天內沒有使用應用程式,存取權杖會無效。
id
first_name
last_name
middle_name
name
name_format
picture
short_name
age_range
context
cover
currency
devices
gender
link
locale
timezone
updated_time
verified
rsvp_event
和 user_managed_groups
權限已停用。user_managed_groups
權限仍可用於測試,但無法提交以供登入審查。
groups_access_member_info
:用於接收社團內容的成員相關資料。
publish_to_groups
:用於代表用戶發佈內容到社團。
user_age_range
:用於存取用戶的年齡層。
user_gender
:用於存取用戶的性別。
user_link
:用於存取應用程式其他用戶的 Facebook 個人檔案網址。
此版本沒有淘汰項目。
粉絲專頁洞察報告的資料解析衡量指標只會傳回零以外的值。
粉絲專頁和貼文動態互動衡量指標,包括衡量指標欄位所用的 metric
,已從 stories
重新命名為 activity
。
粉絲專頁貼文使用情形互動衡量指標,包括衡量指標欄位所用的 metric
,已從 post_consumption*
重新命名為 post_clicks*
。
GET /{page-id}/insights/{metric}
- 下列衡量指標將在 90 天後移除:
page_story_adds
page_story_adds_by_age_gender_unique
page_story_adds_by_city_unique
page_story_adds_by_country_unique
page_views
page_views_unique
page_views_login
page_views_login_unique
GET /{post-id}/insights/{metric}
- 下列衡量指標將在 90 天後移除:
post_story_adds_by_action_type
post_story_adds_by_action_type_unique
post_story_adds_unique
post_story_adds
post_fan_reach
post_interests_impressions
post_interests_impressions_unique
post_interests_consumptions
post_interests_consumptions_unique
post_interests_consumptions_by_type
post_interests_consumptions_by_type_unique
post_interests_action_by_type
post_interests_action_by_type_unique
/photos
關係連線:/photos
關係連線(使用於多重節點)的 type
參數不再支援 GET
作業(GET /object/photos?type=uploaded
)使用 uploaded
做為值。GET /user
:third_party_id
欄位已停用。使用舊版 API 的應用程式在 2018 年 7 月 30 日之前仍可取得此欄位。用戶在 2018 年 5 月 1 日之後(含當日)安裝的應用程式將無法取得此欄位,無論其使用的 API 版本為何。發佈日期:2018 年 5 月 1 日 | 有效期限:2019 年 2 月 1 日 | 部落格文章
bid_strategy
欄位我們針對 {account-id}/adsets
推出新的 bid_strategy
欄位,可讓您根據業務目標選擇廣告出價策略。每種策略都有優點和權衡。選項包括:
LOWEST_COST
- 根據您的廣告組合預算和透遞 optimization_goal
取得最佳結果。Facebook 會自動進行更多必要的出價來花費您的預算。您可以為出價提供最大值,或使用此選項提供沒有限制的出價。
TARGET_COST
- 在增加廣告組合預算時,為廣告提供穩定的平均成本。
如需詳細資訊,請參閱廣告購買與最佳化:出價策略
適用於建立精選集廣告的新 API - 以前每次建立精選集廣告時,Facebook 都會在背景建立一個全螢幕互動廣告。這個非正式建立的全螢幕互動廣告不僅在使用上有所限制,也無法用來再次鎖定曾與全螢幕互動廣告有過互動的廣告受眾。現在當您從商品組合建立精選集廣告時,必須一併正式建立具有適當素材的全螢幕互動廣告。當您在精選集廣告中使用此全螢幕互動廣告時,Facebook 會自動產生精選集廣告。如需詳細資訊,請參閱從商品組合建立精選集廣告。
右側欄位無效 - 我們讓僅鎖定 Facebook 位置的廣告無效,為 {ad_account_id}/adsets
上 right_hand_column
的具有無效目標的 right_hand_column
。我們現在僅支援可支援使用以下目標的廣告格式右側(廣告)版位:流量、轉換次數和商品目錄銷售。
在 3.0 以上版本中,is_autobid
和 is_average_price_pacing
會同時在 GET
和 POST
中停用。
變更自訂廣告受眾的規則語法 - 我們更新了用於建立網站自訂廣告受眾、行動應用程式自訂廣告受眾、粉絲專頁互動自訂廣告受眾、名單型廣告互動廣告受眾、全螢幕互動廣告的互動廣告受眾和離線自訂廣告受眾的規則結構。如此可讓您根據彙總行為建立規則、從不同事件來源建立規則和排除規則。請參閱:
產品目錄存取 - 若要存取目錄商品,您必須指定正確的目錄產業。如果您的要求無法與正確的目錄產業配對,將發生錯誤。例如,如果您擁有電子商務目錄,應使用對應的 /products
端點(例如 GET {catalog_id}/products
、GET {product_feed_id}/products
或 GET {product_set_id}/products
)存取它。您不能使用其他產業的端點(例如 GET {catalog_id}/autos
、GET {product_feed_id}/hotels
或 GET {product_set_id}/flights
)存取目錄。
範本標籤中的空字串 - 我們不再允許將空字串作為動態廣告:範本標籤選項的參數。例如,如果您將空字串傳送給 {{trip.checkin_date date_format:}}
,將發生錯誤。如需背景資訊,請參閱動態廣告:廣告管理。
洞察報告逾時 - 如果我們預期洞察報告 API 要求在完成之前導致逾時,將傳回錯誤代碼 100
和子代碼 1504033
的錯誤。我們根據要求大小和處理相對於逾時限制的進度進行估計。如果發生此錯誤,您應為此資料進行非同步洞察報告 API 要求。請參閱洞察報告 API 非同步工作。
事件資料中的負值 - 如果您將含有負值的事件資料發佈至 {data_set_id}/events
,將會失敗。這會影響 POST /{data_set_id-id}/events
的 data
欄位。
行銷活動預算最佳化的洞察報告 - 當您的廣告行銷活動使用行銷活動預算最佳化時,adset_budget_value
現在會傳回 using campaign budget
。這會影響:
GET {adaccount-id}/insights
、
GET {campaign-id}/insights
、
GET {adset-id}/insights
、
GET {ad-id}/insights
、
POST {adaccount-id}/insights
、
POST {campaign-id}/insights
、
POST {adset-id}/insights
、
POST {ad-id}/insights
。
像素的預設排序 - 如果您在商業帳號或廣告帳號上呼叫 GET {account_id}/adspixel
關係連線,我們傳回的結果預設會依像素名稱而非上次像素觸發時間進行排序。
重新命名像素統計資料欄位 - 我們將像素統計資料關係連線上的 timestamp
欄位重新命名為 start_time
。這代表我們在像素觸發上開始每小時彙總資料的開始時間。我們現在會以 ISO 8601 格式傳回此欄位資料,並包含時區差距。如此可修復我們傳回無效 Unix 時間戳記的問題。以下端點將受到影響:GET {ads-pixel-id}/stats
。
已停用 POST {pixel-id}/shared_agencies
端點。請使用企業管理平台用戶介面與代理商分享廣告像素。
POST {ad-id}/
、
POST {adset-id}/
、
POST act_{ad-account-id}
、
POST act_{ad-account-id}/ads
、
POST act_{ad-account-id}/adsets
已停用 POST act_{ad-account-id}/adimages
的 zipbytes
欄位,並移除在該關係連線上傳 ZIP 檔案的功能。請使用具有這些副檔名的圖像:jpg
、jpeg
、gif
、bmp
、png
、tiff
或 tif
。
已停用目前建立精選集廣告的方法,其使用單一 API 呼叫,需要將所有必要廣告素材都用作參數。現在改為必須先建立全螢幕互動廣告,然後使用全螢幕互動廣告連結來建立精選集廣告。如此可讓您存取非正式建立的全螢幕互動廣告物件以進行相關動作,例如再次鎖定廣告受眾。請參閱精選集廣告。
已停用針對具有粉絲專頁貼文互動目標的廣告使用輪播廣告格式,該組合不再有效。請參閱驗證、目標和廣告創意。
POST {ad-account-id}/adsets
和 POST {adset-id}
的 is_autobid
和 is_average_price_pacing
欄位,改用新的 bid_strategy
欄位為廣告組合指定特定的出價策略。如需更多資訊,請參閱出價與最佳化。已停用廣告和廣告帳號之 delivery_estimate
下的欄位。其結果不符合廣告商的需求。此外,Facebook 建議的出價金額可能無法充分實現許多廣告商的業務目標。已停用的欄位和參數包括:
bid_estimate
欄位、
currency
參數、
daily_budget
參數、
optimize_for
參數
我們推薦您使用從 Facebook 廣告取得的真實內在商業數值,並在此基礎上出價。如果您還不知道此數值,建議您使用自動出價。如需背景資訊,請參閱廣告使用說明:廣告競價和廣告購買與最佳化。
已停用 GET /{rf-prediction-id}
上 curve_budget_reach
欄位的傳回結果。我們現在會傳回對應,並已停用 JSON 序列化字串回傳值。這會影響:GET /{rf-prediction-id}
。
已停用 GET /{ad-account-id}/ratecard
關係連線。
已停用多個與 /ad_accounts
帳單相關的欄位。這些項目包括:
next_bill_date
active_billing_date_preference
pending_billing_date_preference
active_asl_schedule
salesforce_invoice_group_id
transactions
adspaymentcycle
show_checkout_experience
pixel_id
和 external_event_source
欄位 GET /customaudience
。已停用 OFFLINE_EVENT_SET_ID
上的 matched_unique_users
,其由 GET /{data-set-id}
和 GET /{data-set-upload-id}
所傳回。請參閱離線轉換 API。
已停用 attributed_events
關係連線和 GET /{data_set_id} API
上的 attribute_stats
欄位。使用 GET /{data_set_id}/stats
API 取得歸因事件統計資料。
已停用 OFFLINE_EVENT_SET_ID
上的 matched_unique_users
欄位,其由 GET /{data-set-id}
和 GET /{data-set-upload-id}
所傳回。
已停用 GET {data_set_upload_id}
的預設回傳值。預設將不再傳回以下欄位:first_upload_time
、last_upload_time
、api_calls
、valid_entries
、matched_entries
、duplicate_entries
、event_time_min
、event_time_max
、event_stats
和 matched_unique_users
。
已停用 GET {data_set_id}/stats
的預設回傳值。目前預設僅傳回計數統計資料。若要指定應傳回哪些統計資料,請使用 fields
參數或累積統計資料的 summary
參數(例如 average_upload_delay
)。
已停用 GET {data_set_id}
的預設回傳值。預設將不再傳回以下欄位:attribute_stats
、duplicate_entries
、event_stats
、event_time_max
、event_time_min
、matched_entries
、matched_unique_users
、usage
、valid_entries
。
已停用 GET {data-set-upload-id}/stats
關係連線。請改用 GET {data-set-upload-id}
的 valid_entries
或 matched_entries
欄位。
已停用洞察報告 API 的 canvas_component_avg_pct_view
。