從推廣 API v15.0 發佈起,您將無法再建立特殊廣告受眾。詳情請參閱下文特殊廣告受眾區塊。
所有使用推廣 API 的企業都必須註明其新建和經過編輯的宣傳活動是否屬於特殊廣告類別。目前可用的類別有:住屋、就業、信貸或議題、選舉和政治。如果企業刊登的廣告不屬於特殊廣告類別,則企業必須在 special_ad_categories
欄位中輸入 NONE
或傳送空白陣列。
備註:在選擇任何 special_ad_categories
後,您亦必須設定 special_ad_category_country
。
刊登住屋、就業或信貸廣告的企業必須遵守目標設定和分享對象限制條件。為社會議題、選舉或政治廣告設定目標受眾不受 special_ad_categories
標籤的限制。
從推廣 API v7.0 開始,special_ad_category
欄位已由 special_ad_categories
取代(留意從單數到複數的變化)。新欄位支援以陣列形式顯示。
在廣告宣傳活動的建立過程中,所有廣告客戶都需要指定特殊廣告類別。特殊廣告類別欄位可包含以下一項或多項內容:
HOUSING
CREDIT
EMPLOYMENT
ISSUES_ELECTIONS_POLITICS
NONE
即使宣傳活動不包含推廣住屋、就業、信貸或議題、選舉和政治的廣告,廣告客戶仍必須選擇 NONE
或傳送空白陣列以指定類別。
如果選擇住屋、就業或信貸類別,則可供此類宣傳活動使用的廣告目標設定選項將會受到限制。
如果選擇議題、選舉或政治類別,系統將要求您選擇在哪些國家/地區刊登這些廣告。您需要獲得特定國家/地區的授權,才能在其境內刊登社會議題、選舉或政治類廣告。
special_ad_category
欄位已由 special_ad_categories
欄位取代(留意從單數到複數的變化),且廣告客戶不能再使用 special_ad_category
欄位。參見下文推廣 API v6.0 及較舊版本部分。
所有宣傳活動建立程序均須包含 special_ad_categories
欄位。如果您的宣傳活動不需要特殊廣告類別,您可以輸入空白陣列或使用 NONE
值。
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'EMPLOYMENT\']"'\ https://graph.facebook.com/v7.0/act_<AD_ACCOUNT_ID>/campaigns
詳情請參閱廣告幫助中心 > 特殊廣告類別。
special_ad_category
欄位指定特殊廣告類別。 NONE
作為 special_ad_category
欄位的預設值。ISSUES_ELECTIONS_POLITICS
選項若廣告客戶刊登社會議題、選舉和政治類廣告,便需在廣告宣傳活動建立過程中指定 special_ad_categories
。此外,廣告客戶亦需在廣告創意級別設定 authorization_categor
標示:刊登政治廣告時應使用 POLITICAL
;而自 2024 年 1 月 9 日起,如刊登的廣告包含以數碼方式建立或變造的影音素材,則應使用 POLITICAL_WITH_DIGITALLY_CREATED_MEDIA
。
您可以建立包含議題、選舉和政治類廣告的整個宣傳活動,而非展示此類內容的個別廣告。在單個廣告宣傳活動中,您無法再同時刊登議題、選舉和政治類廣告及與此等主題無關的廣告。此外,您不能再將個別廣告標記為議題、選舉和政治類別。
如要建立議題、選舉或政治宣傳活動,請在 special_ad_categories
欄位傳遞 ISSUES_ELECTIONS_POLITICS
。廣告客戶亦可傳遞多個值至此欄位,以合併此類別與其他類別。
在選擇任何 special_ad_categories
後,您還必須設定 special_ad_category_country
。在此指定您想刊登社會議題、選舉或政治類廣告的國家/地區。special_ads_category_country
欄位要求:
ISO Alpha 2
國家/地區代碼的陣列。要刊登議題、選舉或政治宣傳活動,請按照下列步驟操作:
要建立議題、選舉或政治宣傳活動,請按照下列步驟操作:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'ISSUES_ELECTIONS_POLITICS\']" '\ -F 'special_ad_category_country="[\'US\']" '\ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
要建立包含多個類別的宣傳活動,請按照下列步驟操作:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'EMPLOYMENT\', \'ISSUES_ELECTIONS_POLITICS\']" '\ -F 'special_ad_category_country="[\'US\']" '\ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
在目前所有宣傳活動中,系統會分配 NONE
作為 special_ad_category
欄位的預設值。若要刊登特殊類別的廣告,您需要按照下列指示更新設定:
重新建立宣傳活動並指定 special_ad_category
。詳情請參閱建立新的宣傳活動。
更新目標設定,並更改 special_ad_category
:
curl -i -X POST \ -F 'tune_for_category=EMPLOYMENT' https://graph.facebook.com/<API_VERSION>/<ADSET_ID>
/<AD_CAMPAIGN_ID>
傳送 POST
要求以申請更改 special_ad_category
。加入類別資訊:curl -i -X POST \ https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>?special_ad_category=EMPLOYMENT
使用 tune_for_category
時,廣告宣傳活動和廣告組合的變化如下所示:
支援的功能 | 移除的功能 |
---|---|
|
|
更新的功能 | 移除的功能 |
---|---|
|
|
要建立包含 special_ad_category
的廣告宣傳活動,請跟從標準宣傳活動建立流程並加入 special_ad_category
。範例如下:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ -F 'special_ad_category=EMPLOYMENT' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
如要建立 special_ad_category
欄位值為 NONE
的宣傳活動,請按照下列步驟操作:
curl -X POST \ -F 'name="My campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ -F 'special_ad_category=NONE' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns參考資料:宣傳活動
以下限制適用於刊登住屋、就業和信貸廣告的廣告客戶。
自 2021 年 12 月起,若廣告客戶刊登住屋、就業和信貸類廣告,便需在廣告宣傳活動建立過程中指定 special_ad_categories
。在選擇任何 special_ad_categories
後,您還應設定 special_ad_category_country
。住屋、就業和信貸廣告的 special_ad_category_country
欄位要求:
如果您想在歐洲刊登信貸、就業或住屋機會相關廣告,則須在 2021 年 12 月 7 日之前申報相關的特殊廣告類別。若廣告屬於特殊類別,其可用的目標設定類別便會較少。
若廣告客戶位於美國且刊登住屋、就業和信貸廣告,或者向美國、加拿大或歐洲用戶刊登廣告,便需遵守以下廣告組合和廣告級別的限制要求:
若廣告客戶位於美國且提供住屋、就業和信貸機會,或者向美國、加拿大或歐洲用戶刊登廣告,其可選擇的目標設定選項將受到限制。例如,他們無法使用描述受保護類別或看似與這些類別相關的目標設定選項,當中可能包括人口統計資料、行為或興趣。
相關限制如下:
住屋、就業和信貸廣告的選項通常固定為 18 歲至 65 歲以上。然而,在歐洲刊登信貸廣告的廣告客戶可以選擇不同的年齡範圍,以滿足其行業和當地對此特殊廣告類別的要求。
無法鎖定特定性別為目標。您有兩種選項:
genders
參數。genders
預設包含所有性別。subcity
neighborhood
metro_area
small_geo_area
subneighborhood
electoral_district
zips
不適用。要接觸新用戶,請建立特殊廣告受眾。
從推廣 API v15.0 發佈起,您將無法再建立特殊廣告受眾。此停用變更會影響以下端點:
POST /{ad-account-id}/customaudiences?fields=subtype
POST /{custom-audience-id}
POST /{ad-account-id}/adsets?fields=subtype
POST /{ad-campaign}?fields=subtype
GET /{ad-account-id}/customaudiences?fields=operation_status
請更新程式碼以避免出錯。
刊登住屋、就業和信貸廣告的廣告客戶無權使用類似廣告受眾。但他們可以建立特殊廣告受眾,選用此類受眾需考慮更多限制。
向 /act_<AD_ACCOUNT_ID>/customaudiences
傳送 POST
要求以建立新受眾。subtype
應設定為 REGULATED_CATEGORIES_AUDIENCE
。
curl -X POST \ -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \ -F 'subtype=REGULATED_CATEGORIES_AUDIENCE' -F 'regulated_audience_spec={"country": "US", "ratio": 0.1}' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
使用 GET
要求載入特殊廣告受眾。在 fields
下提供所需資訊:
curl -X GET \ -d 'fields=regulated_audience_spec' https://graph.facebook.com/<API_VERSION>/<AUDIENCE_ID>
結果應如下所示:
"regulated_audience_spec": { "country": "US", "origin": [ { "id": "<SEED_AUDIENCE_ID>", "name": "My Seed Audience", "type": "custom_audience" } ], "ratio": 0.05, "type": "custom_ratio", "target_country_names": [ "United States" ] }
在推廣 API v3.2 中,我們推出了新的廣告刊登狀態,當宣傳活動、廣告組合或廣告出於任何原因而無法刊登時,您可將其狀態設為 WITH_ISSUES
。讀取物件時,您可以詳細了解 WITH_ISSUES
來解決該物件的任何問題。
呼叫狀態為 "effective_status": "WITH_ISSUES"
的物件會傳回名為 issues_info
的欄位,其中包含與所找到問題相關的資訊。使用特殊廣告類別時,您可能會遇到下列問題:
error_code | error_message | error_summary |
---|---|---|
| 需要認證 | 商業帳戶管理員必須查閱並接受我們的無歧視政策,方可刊登廣告。他們可以在「企業管理平台設定」>「系統用戶」中找到此政策。幫助中心連結:https://www.facebook.com/business/help/338925176776440 |
| 自訂年齡選項無法使用 | 刊登這種特殊類別廣告時無法使用所選廣告受眾年齡範圍。請選擇符合當地和行業對此特殊廣告類別的要求之年齡範圍。 |
| 儲備廣告受眾無法使用 | 刊登這種特殊類別廣告時無法使用儲備廣告受眾。如需解決此問題並完成宣傳活動建立程序,請移除全部所選的儲備廣告受眾。 |
| 類似廣告受眾無法使用 | 刊登這種特殊類別廣告時無法使用類似廣告受眾。如需解決此問題並完成宣傳活動建立程序,請移除全部所選的類似廣告受眾。如要接觸新用戶,您可建立特殊廣告受眾。 |
| 地點半徑範圍選項無法使用 | 刊登這種特殊類別廣告時無法使用 {category} 這個地點半徑範圍選項。如要解決此問題並完成宣傳活動建立程序,請選擇距離超過自訂地點最近範圍的地點半徑。 |
| 詳細目標設定選項無法使用 | 刊登這種特殊類別廣告時無法使用詳細目標設定選項 {name} ({id})。如要解決此問題並完成宣傳活動建立程序,請移除這個目標設定選項。 |
| 地點剔除功能無法使用 | 刊登這種特殊類別廣告時無法剔除特定地點。如要解決此問題並完成宣傳活動建立程序,請移除所有地點剔除條件。 |
| 自訂性別選項無法使用 | 刊登這種特殊類別廣告時無法選擇自訂性別。如要解決此問題並完成宣傳活動建立程序,請更新廣告受眾以加入所有性別 |
| 地點選項無法使用 | 刊登這種特殊類別廣告時無法使用 {category} 這個選項。如要解決此問題並完成宣傳活動建立程序,請移除這個地點選項。所有地點選項必須加入距離任何所選城市、地址或自訂地點最短半徑的範圍。郵遞區號選項無法使用。 |
| 詳細目標設定剔除功能無法使用 | 刊登這種特殊類別廣告時無法剔除任何行為、人口統計資料或興趣。如要解決此問題並完成宣傳活動建立程序,請移除所有詳細目標設定剔除條件。 |
| 目標設定擴充功能無法使用 | 刊登這種特殊類別廣告時無法使用目標設定擴充功能。如要解決此問題並完成宣傳活動建立程序,請移除目標設定擴充選項。 |
| 興趣選項無法使用 | 刊登這種特殊類別廣告時無法使用 {category} 這個詳細目標設定選項。如要解決此問題並完成宣傳活動建立程序,請移除這個目標設定選項。 |
| 出價乘數無法使用 | 刊登特殊類別廣告時,您無法使用出價乘數。 |
| 剔除特定廣告受眾功能無法使用 | 刊登這種特殊類別廣告時無法剔除類似廣告受眾和特殊廣告受眾。如要解決此問題並完成宣傳活動建立程序,請移除所有類似廣告受眾和特殊廣告受眾剔除條件。 |
如需協助讀取警告和錯誤資訊,請參閱我們關於此主題的開發人員網誌。
若使用推廣 API v5.0 或以上版本,無論廣告是否提供住屋、就業或信貸機會,特殊廣告類別欄位均為必填項目。
自 2019 年 12 月 4 日起,位於美國或指定美國用戶為目標的企業必須為其新建和經過編輯的住屋、就業或信貸類廣告宣傳活動註明類別,否則其廣告會被禁止刊登。由此日期開始,位於美國或指定美國用戶為目標的企業必須為其新建和經過編輯的宣傳活動指定 special_ad_category
,並使用適用於該類宣傳活動的有限廣告受眾條件。此規定適用於所有廣告購買平台,包括推廣 API。
對於提供住屋、就業或信貸的刊登中廣告來說,2020 年 2 月 11 日是一個具有特殊意義的日子。
自 2020 年 3 月 31 日起,所有使用推廣 API 的新建和經過編輯廣告,包括並非提供住屋、就業或信貸機會的所有企業,都必須為 special_ad_category
指定 NONE
。
自 2020 年 12 月 3 日起,若廣告客戶向加拿大用戶刊登關於信貸、就業或住屋機會的廣告,便須申報相關的特殊廣告類別。
自 2021 年 12 月 7 日起,若廣告客戶向歐洲用戶刊登關於信貸、就業或住屋機會的廣告,便須申報相關的特殊廣告類別。
除了要求廣告客戶自行註明宣傳活動的類別外,我們還會繼續透過真人審查員和機器學習來識別此類廣告。如果您向我們傳送了錯誤的 special_ad_category
,您的廣告便有機會被暫停刊登,直到宣傳活動改為正確的類別。
如果您選擇 HOUSING
、EMPLOYMENT
或 CREDIT
作為 special_ad_category
,則系統將強制執行所有目標設定限制,同時還會出現無法修正的錯誤。