推廣 API

詳細目標設定

透過目標設定搜尋，您可以在單一 API 呼叫中尋找一種目標設定類型的目標設定。透過詳細目標設定 API，您可以在單一要求中同時搜尋多種目標設定類型。您也會取得根據查詢內容所提供的建議。

此 API 有四個端點：搜尋、建議、瀏覽和驗證。

這些端點的回應包含以下內容：

名稱 說明

id

類型：字串

目標廣告受眾編號

name

類型：字串

目標廣告受眾的名稱

audience_size_lower_bound

整數

目標廣告受眾規模估計值下限

audience_size_upper_bound

整數

目標廣告受眾規模估計值上限

path

類型：字串陣列

包括目標設定隸屬的類別及任何上層類別

description

類型：字串

關於目標廣告受眾的簡短說明

如果您未提供 limit_type，我們會將少於 2000 人的結果過濾成四個類別：work_employers、work_positions、education_majors、education_schools。否則你會得到不太有意義的結果。當您使用 limit_type 時，我們會過濾出這四個類別之一，而不會傳回所有結果。

擷取您的廣告中符合搜尋查詢的目標廣告受眾。您可以在此端點提供下列參數：

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
名稱 說明

q

類型：字串

必要項目。

查詢字串

limit

類型：整數

選用項目。

結果數量

limit_type

類型：字串

選用項目。

限制所要擷取的廣告受眾類型。預設為所有類型。

有效值：

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

類型：字串

選用項目。

用來顯示廣告受眾名稱和說明（若有）的區域設定。預設為廣告帳號的區域設定

建議

根據您提供的一些選定廣告受眾，傳回您可以鎖定的其他廣告受眾。

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

請提供下列參數：

名稱 說明

targeting_list

類型：{'type':'{TYPE}', 'id':{ID}} 陣列

必要項目。

以 {'type':'{TYPE}', 'id':{ID}} 配對陣列做為輸入的廣告受眾，以便提供建議。

limit

類型：整數

選用項目。

結果數量。預設值為 30。上限 45。

limit_type

類型：字串

選用項目。

限制所要擷取的廣告受眾類型。預設為所有類型

有效值：

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

類型：字串

選用項目。

用來顯示廣告受眾名稱和說明的區域設定。預設為廣告帳號的區域設定

瀏覽

針對 Facebook 類別、第三方資料供應商和一些興趣，取得結構化分類法的目標設定。此端點的結果會顯示在廣告管理員的「詳細目標設定」用戶介面元件的「瀏覽」功能中。

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

請提供下列選用參數：

名稱 說明

limit_type

類型：字串

限制所要擷取的廣告受眾類型。預設為所有類型。

locale

類型：字串

用來顯示廣告受眾名稱和說明的區域設定。預設為廣告帳號的區域設定

驗證

驗證廣告受眾對目標設定是否有效。如果您已經建立廣告組合，並且想要驗證其目標設定規格是否仍然有效，這會很有幫助。如果目標設定無效，您應將其從目標設定規格中刪除。

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

除了標準的「詳細目標設定」回應欄位之外，此端點還會傳回：

名稱 說明

valid

類型：布林值

目標廣告受眾是否有效

輸入參數清單如下：

名稱 說明

targeting_list

類型：{'type':'{TYPE}', 'id':{ID}} 陣列

用於驗證的 {'type':'{TYPE}', 'id':{ID}} 配對陣列。建議使用此參數。

id_list

類型：字串陣列

用於驗證的編號陣列。編號必須是我們廣告受眾資料庫中可識別的不重複編號，才會成功

name_list

類型：字串陣列

用於驗證的字串陣列。僅限興趣，不區分大小寫

locale

類型：字串

用來顯示廣告受眾名稱和說明的區域設定。預設為廣告帳號的區域設定

請至少提供下列其中一項：targeting_list、id_list 和 name_list。