這對流動應用程式安裝廣告非常實用。
curl -X POST \
-F 'name=My AdSet' \
-F 'optimization_goal=REACH' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting={
"geo_locations": {"countries":["US"]},
"user_device": ["Galaxy S6","One m9"],
"user_os": ["android"]
}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
您可以結合不同類別,例如 iPod、iPad 或 iPhone。
這些類別並非互斥。如果選擇 iOS,則表示將目標設定為所有執行 iOS 的裝置,包括 iPhone 和 iPod,而非指定 user_device。
在品牌知名度目標廣告中,您無法根據流動裝置類型(例如功能手機或 Samsung)或 iOS 版本號碼來指定目標。您只可以選取 Android 或 iOS 或所有手機。
| 欄位 | 說明 |
|---|---|
類型:陣列 | 此為必要項目。 以下 OS 選項表中的一個或更多值。可能值列於具有 有效範例: |
類型:陣列 | 此為選用項目。 裝置必須符合 |
類型:陣列 | 此為選用項目。 需要排除的裝置。裝置必須符合 |
類型:陣列 | 此為選用項目。 可使用的值為 |
| 欄位 | 說明 |
|---|---|
類型:字串 | iOS 裝置,包括 iPhone、iPad 和 iPod |
類型:字串 | 執行 x.x 或以上 OS 版本的 iOS 裝置。 選項:2.0、3.0、4.0、4.3、5.0、6.0、7.0、8.0 和 9.0。範例: Meta 應用程式廣告:
|
類型:字串 | 運行 x.x 至 y.y OS 版本的 iOS 裝置。 選項:2.0、3.0、4.0、4.3、5.0、6.0、7.0、8.0 和 9.0。 範例: |
類型:字串 | Android 裝置 |
類型:字串 | 運行 x.x 或以上版本的 Android 裝置。 選項:2.0、2.1、2.2、2.3、3.0、3.1、3.2、4.0、4.1、4.2、4.3、4.4、5.0、5.1、6.0、7.0、7.1 和 8.0。 範例: |
類型:字串 | 運行 x.x 至 y.y 版本的 Android 裝置。 選項:2.0、2.1、2.2、2.3、3.0、3.1、3.2、4.0、4.1、4.2、4.3、4.4、5.0、5.1、6.0、7.0、7.1 和 8.0。 範例: |
根據感情狀況、教育、財務狀況及人生大事指定目標。
首先查詢 life_events:
curl -G \
-d 'type=adTargetingCategory' \
-d 'class=life_events' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/search
將這些內容加入 targeting_spec:
curl -X POST \
-F 'name="My First AdSet"' \
-F 'daily_budget=10000' \
-F 'bid_amount=300' \
-F 'billing_event="IMPRESSIONS"' \
-F 'optimization_goal="REACH"' \
-F 'campaign_id="<AD_CAMPAIGN_ID>"' \
-F 'promoted_object={
"page_id": "<PAGE_ID>"
}' \
-F 'targeting={
"facebook_positions": [
"feed"
],
"age_max": 24,
"age_min": 20,
"behaviors": [
{
"id": 6002714895372,
"name": "All travelers"
}
],
"device_platforms": [
"mobile"
],
"genders": [
1
],
"geo_locations": {
"countries": [
"US"
],
"regions": [
{
"key": "4081"
}
],
"cities": [
{
"key": 777934,
"radius": 10,
"distance_unit": "mile"
}
]
},
"interests": [
{
"id": "<INTEREST_ID>",
"name": "<INTEREST_NAME>"
}
],
"life_events": [
{
"id": 6002714398172,
"name": "Newlywed (1 year)"
}
],
"publisher_platforms": [
"facebook",
"audience_network"
]
}' \
-F 'status="PAUSED"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
現在我們要指定以下目標:
以下為另一個按地點、人口統計資料、感情狀態及興趣指定目標的範例:
curl \
-F 'name=My AdSet' \
-F 'optimization_goal=REACH' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting={
"age_max": 43,
"age_min": 18,
"genders": [1],
"geo_locations": {
"regions": [{"key":"3847"}],
"cities": [
{
"key": "2430536",
"radius": 12,
"distance_unit": "mile"
}
]
},
"interests": [{"id":6003139266461,"name":"Movies"}],
"relationship_statuses": [
2,
3,
4
]
}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
| 名稱 | 說明 |
|---|---|
類型:陣列 | 代表感情狀態的整數陣列。
預設值: 限制:請勿使用 |
類型:陣列 | 設有「id」及選填「name」欄位的物件陣列: |
類型:陣列 | 設有「id」及選填「name」欄位的物件陣列 |
類型:陣列 | 設有「id」及選填「name」欄位的物件陣列 |
類型:陣列 | 設有「id」及「name」(選填)欄位的物件陣列 |
為所有選項使用目標設定搜尋 API。
| 名稱 | 說明 |
|---|---|
類型:陣列 | 學校、大專院校和機構。 限制:200 間傳統學校。 範例: |
類型:陣列 | 根據教育程度而指定的整數陣列。
|
類型:陣列 | 整數陣列。大學畢業時間 限制:最早年份:1980 |
類型:陣列 | 主修學科。 範例: 限制:200 |
類型:陣列 | 公司、機構或工作場所 範例: 限制:200 |
類型:陣列 | 自行申報的工作。 範例: 限制:200 |
建立自訂廣告受眾並新增用戶。您可以在目標設定中使用廣告受眾(加入或者排除)。在 custom_audiences 和 excluded_custom_audiences 分別加入多達 500 個自訂廣告受眾。
targeting_specs 的 excluded_custom_audiences 與 APP_COMBINATION 自訂廣告受眾的 excluded_custom_audiences 不同。
| 欄位 | 說明 |
|---|---|
類型:陣列 | 廣告受眾編號或廣告受眾物件的陣列。只限 |
類型:陣列 | 廣告受眾編號或廣告受眾物件的陣列。只限 |
targeting:{
"geo_locations":{
"countries":["US"],
},
"age_min":25,
"age_max":40,
"custom_audiences":[{"id":6004192254512}]}
"excluded_custom_audiences":
[{"id":6004192252847}],
}為地區設定指定更具體的目標:
| 欄位 | 說明 |
|---|---|
類型:陣列 | 地區設定。詳見目標設定搜尋,地區設定。此為子陣列「locales」內的指數。指定使用某個地區非常用語言的帳戶管理中心帳戶。提供語言編號,例如 5 代表德文。限制:50。請參閱使用 |
此功能擴充我們現有的地點目標設定功能,讓廣告客戶能接觸用戶,而這些用戶有興趣在同一國家/地區內的所選城市和區域旅行、購物或展現整體興趣。
individual_setting 下方 targeting_automation 中的 geo 參數設定為 1。individual_setting 下方 targeting_automation 中的 geo 參數設定為 0。"targeting": { "age_range": [25, 35], "geo_locations": { "countries": ["GB"], "cities": [{"key":"2430536", "radius":12, "distance_unit":"mile"}] }, "targeting_automation": { "individual_setting": { "geo": 1 } } }
如果您已在地點目標設定(即 geo_locations 欄位)中選擇城市或區域,此功能便會運作。
curl -X POST \ -F 'name="advantage audience test"' \ -F 'is_autobid="true"' \ -F 'daily_budget="100"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'targeting={ "age_range": [25,35], "geo_locations": { "cities": [{"key":"2430536","radius":12,"distance_unit":"mile"}] }, "targeting_automation": {"individual_setting": {"geo": 1 } }}' \ -F 'access_token="<ACCESS_TOKEN>"' \ https://facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
如需進一步了解此功能,請參閱如何接觸對您所選城市和區域感興趣的用戶。
目前此功能僅適用於特定廣告客戶,但我們會在未來幾個月逐步向所有廣告客戶推出此功能。
如要使用「年齡和性別建議」功能,在 targeting_automation 欄位配置 individual_setting 參數即可。如果廣告組合採用此設定,則系統在擷取廣告組合時也會傳回此設定。
OUTCOME_SALES 和 APP_INSTALLS 目標。將 individual_setting 下方 targeting_automation 中的 age 參數設定為 1。然後,在廣告受眾設定中加入 age_range 欄位。
{ "geo_locations": { "countries": [ "US" ] }, "age_min": 18, "age_range": [25, 35], "targeting_automation": { "individual_setting": { "age": 1 } } }
將 individual_setting 下方 targeting_automation 中的 gender 參數設定為 1。
{ "geo_locations": { "countries": [ "US" ] }, "age_min": 21, "genders":[1], "targeting_automation": { "individual_setting": { "gender": 1 } } }
curl -X POST \ -F 'name="advantage audience test"' \ -F 'is_autobid="true"' \ -F 'daily_budget="100"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'promoted_object={"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}' \ -F 'targeting={ "age_min": 18, "age_range": [25,35], "genders":[1], "geo_locations": { "countries": ["US"] }, "targeting_automation": {"individual_setting": {"age": 1, "gender": 1 } }}' \ -F 'access_token="<ACCESS_TOKEN>"' \ https://facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
{ "id": "<AD_SET_ID>", }
curl -X GET \ -d 'fields="targeting"' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/<AD_SET_ID>/
{ "targeting": { "age_max": 65, "age_min": 19, "age_range": [ 25, 35 ], "genders": [ 1 ], "geo_locations": { "countries": [ "US" ], "location_types": [ "home", "recent" ] }, "targeting_relaxation_types": { "lookalike": 0, "custom_audience": 0 }, "targeting_automation": { "advantage_audience": 0, "individual_setting": { "age": 1, "gender": 1 } } }, "id": "<AD_SET_ID>", }
為專為您帳戶建立或提供權限的自訂目標設定使用廣泛類別。如要加入烹飪類別及小型公司負責人類別:
curl \
-F 'name=My AdSet' \
-F 'optimization_goal=REACH' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting={
"geo_locations": {"countries":["US"]},
"user_adclusters": [
{"id":6002714885172,"name":"Cooking"},
{"id":6002714898572,"name":"Small Business Owners"}
]
}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
如要根據 BCT 以及地點和人口統計資料來指定目標:
curl \
-F 'name=My AdSet' \
-F 'optimization_goal=REACH' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting={
"geo_locations": {"countries":["US"]},
"relationship_statuses": [2],
"user_adclusters": [{"id":6002714886772,"name":"Food & Dining"}]
}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
可用選項:
| 名稱 | 說明 |
|---|---|
類型:陣列 | BCT 叢集的編號名稱組合陣列。參閱以下有關擷取 BCT 的資料。限制:50 個編號名稱組合。 |
如要查詢此廣告帳戶的目標受眾,請執行 HTTP GET:
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/broadtargetingcategories
回應為 JSON 鍵值組合數組:
| 名稱 | 說明 |
|---|---|
類型:long | 系統會為廣告目標設定規格使用廣泛類別的編號 |
類型:字串 | 廣泛類別的名稱 |
類型:字串 | 廣泛類別的母類別 |
類型:整數 | 廣泛類別的廣告受眾規模下限 |
類型:整數 | 廣泛類別的廣告受眾規模上限 |
類型:整數 | 6=BCT |
類型:字串 | BCT |