類似廣告受眾

將與您現有顧客最相似的用戶鎖定為目標。類似廣告受眾會使用幾組用戶作為「種子」,然後 Facebook 便會建立包含類似用戶的廣告受眾。您可以將類似廣告受眾用於任何業務目標:您可以出於粉絲招攬、網站註冊、Facebook 站外購買、優惠券領取或者僅僅是為了提高品牌知名度等目標,來鎖定與您的顧客類似的用戶。

種子廣告受眾可以為:

如果類似廣告受眾屬於廣告群組,則 Facebook 會每 3 天重新整理類似廣告受眾成員一次。

建立

系統需要 1 至 6 個小時才能加入全部類似廣告受眾。加入廣告受眾成員時,您可建立及執行將廣告受眾指定為目標的廣告組合。廣告受眾準備就緒後,Facebook 就可向廣告受眾中的用戶展示廣告,而廣告刊登狀況將會趕上進度並如常運作。請參閱刊登狀態。在 https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences 建立一個新的類似廣告受眾。

以下是透過自訂廣告受眾執行建立類似廣告受眾之呼叫的範例:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::NAME => 'My lookalike audience',
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::ORIGIN_AUDIENCE_ID => <SEED_AUDIENCE_ID>,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'type' => 'similarity',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.origin_audience_id: '<SEED_AUDIENCE_ID>',
    CustomAudience.Field.lookalike_spec: {
        'type': 'similarity',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F 'lookalike_spec={"type":"similarity","country":"US"}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

如要使用 PHP 廣告 SDKPython 廣告 SDK 建立類似廣告受眾,請使用 CustomAudience

回應包含:

名稱 描述

id

類型:整數

類似廣告受眾的編號

自訂廣告受眾的類似廣告受眾

如果您的自訂廣告受眾至少擁有 100 個用戶,則您可用來建立類似廣告受眾。這包括您網站的自訂廣告受眾及您流動應用程式的自訂廣告受眾。

名稱 描述

name

類型:字串

此為必要項目。

自訂廣告受眾的名稱

origin_audience_id

類型:長整型

此為必要項目。

自訂廣告受眾的編號。原始廣告受眾必須最少有 100 個成員。

lookalike_spec

類型:陣列

此為必要項目。

請參閱下方說明。

lookalike_spec.type

類型:字串

此為必要項目。設定 typeratio

similarityreach

lookalike_spec.starting_ratio

類型:浮點數

此為選用項目。

類似廣告受眾的開始百分比。例如,若 starting_ratio 為 0.01 而 ratio 為 0.02,系統便會建立類似廣告受眾族群為 1% 至 2% 的類似廣告受眾。starting_ratio 必須低於比例

lookalike_spec.ratio

類型:浮點數

此為必要項目。設定 typeratio

0.01-0.20 按 0.01 遞增。特定國家/地區的頭 x% 原始廣告受眾

lookalike_spec.allow_international_seeds

類型:布林值

此為選用項目。

最少需要有 100 個來自同一個國家/地區的種子廣告受眾成員。如果沒有,系統會將 allow_international_seeds 設定為 true,即 Facebook 會在另一國家/地區尋找廣告受眾成員,以達至此最低數量。預設為 false

lookalike_spec.country

類型:字串

此為必要項目。設定 countrylocation_spec

尋找位於這個國家/地區的類似廣告受眾成員

lookalike_spec.location_spec

類型:陣列

此為必要項目。countrylocation_spec

尋找位於這些地點的廣告受眾成員。國家/地區或國家/地區群組的名單,如 Asia

lookalike_spec.location_spec.geo_locations

類型:陣列

此為必要項目。countriescountry_groups 下至少要有一個項目。

包含這些地點

lookalike_spec.location_spec.geo_locations.countries

類型:字串陣列

此為選用項目。

目標國家/地區。國碼/區碼陣列,請參閱目標設定搜尋 API,國家/地區範例'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

類型:字串陣列

此為選用項目。

將全球地區及自由貿易區的國家/地區指定為目標。國家/地區群組代碼數組。有關完整選項,請參閱目標設定,地點country_groups目標設定搜尋,country_groups範例'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

類型:陣列

此為選用項目。

需要排除的地點

lookalike_spec.location_spec.excluded_geo_locations.countries

類型:字串陣列

此為選用項目。

geo_locations 下的 countries 相同

lookalike_spec.location_spec.excluded_geo_locations.country_groups

類型:字串陣列

此為選用項目。

geo_locations 下的 country_groups 相同

類型

針對「相似度」或「更多接觸人數」優化廣告受眾。

  • 相似度 - 廣告受眾包含與種子自訂廣告受眾最相似的頭 1% 特定國家/地區用戶。新廣告受眾的接觸人數將會較少,而匹配結果將會更加精準。
  • 更多接觸人數 - 廣告受眾包含與種子自訂廣告受眾相似的頭 5% 特定國家/地區用戶,但匹配結果將會較不精準。

您可以手動設定 ratio 以代表所選國家/地區中首 x% 的廣告受眾,而非使用類型。ratio 應為 1%-20%,間隔為 1%。

宣傳活動或廣告組合轉換類似廣告受眾

Facebook 提供宣傳活動和廣告組合轉換類似廣告受眾,讓您可將與先前或現有宣傳活動或廣告組合的轉換顧客相似的用戶指定為目標;例如,針對轉換進行優化的宣傳活動或廣告。我們會根據轉換規格中的宣傳活動或廣告組合類型來衡量轉換。例如,您可將目標指定為在點擊廣告後 28 天內在網站執行動作或安裝應用程式的用戶。

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'origin_ids' => <CAMPAIGN_ID>,
    'starting_ratio' => 0.03,
    'ratio' => 0.05,
    'conversion_type' => 'campaign_conversions',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'origin_ids': '<CAMPAIGN_ID>',
        'starting_ratio': 0.03,
        'ratio': 0.05,
        'conversion_type': 'campaign_conversions',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "origin_ids": "<CAMPAIGN_ID>", 
    "starting_ratio": 0.03, 
    "ratio": 0.05, 
    "conversion_type": "campaign_conversions", 
    "country": "US" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

您必須擁有最少 100 名來自宣傳活動或廣告組合的不重複轉換顧客。轉換顧客越多,產生的預測模型就越理想,因此我們建議達到 200 位或以上的轉換成員。您也應選擇設有類似目標的宣傳活動或廣告組合。

如要建立此類似廣告受眾,請指定一個或以上的宣傳活動或廣告組合。例如,您可指定一個宣傳活動,以及另一個宣傳活動的兩個廣告組合。

Facebook 會使用最多過去 180 天的過往轉換數據,並將在宣傳活動及廣告組合轉換的用戶用作範例。我們會訓練預測模型,並建立類似廣告受眾。隨著宣傳活動及廣告組合取得新轉換,Facebook 亦會持續更新內部的預測模型。

名稱 描述

lookalike_spec

類型:陣列

此為必要項目。

請參閱下方說明。

lookalike_spec.origin_ids

類型:整數陣列

此為必要項目。

廣告對象編號數組。在這些廣告上轉換的用戶將會用於製作類似廣告受眾模型。一個或多個宣傳活動編號或廣告組合編號,或者兩者的組合。

lookalike_spec.conversion_type

類型:字串

此為必要項目。

campaign_conversions。表明廣告受眾是宣傳活動轉換類似廣告受眾

lookalike_spec.country

類型:字串

此為必要項目。

用於尋找類似廣告受眾成員的國家/地區。

lookalike_spec.allow_international_seeds

類型:布林值

此為選用項目。

最少需要有 100 個來自同一個國家/地區的種子廣告受眾成員。如果沒有,系統會將 allow_international_seeds 設定為 true,即 Facebook 會在另一國家/地區尋找成員,以達至此最低數量。預設為 false

lookalike_spec.starting_ratio

類型:浮點數

此為選用項目。

類似廣告受眾的開始百分比。例如,若 starting_ratio 為 0.01 而 ratio 為 0.02,系統便會建立類似廣告受眾族群為 1% 至 2% 的類似廣告受眾。starting_ratio 必須低於 ratio

lookalike_spec.ratio

類型:浮點數

此為必要項目。

範圍為 0.01-0.20。特定國家/地區的頭 x% 原始廣告受眾。

目前,以下宣傳活動轉換類型符合類似廣告受眾資格:

  • 連結點擊次數
  • 優惠廣告
  • 專頁讚好次數
  • 全螢幕展示廣告應用程式安裝
  • 活動回覆次數
  • 帖子互動
  • 網站轉換
  • 流動應用程式安裝次數
  • 流動應用程式互動程度
  • 影片觀看次數
  • 提高本地市場知名度

專頁粉絲類似廣告受眾

根據對您的專頁讚好的用戶建立類似廣告受眾:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'ratio' => 0.01,
    'country' => 'US',
    'page_id' => <PAGE_ID>,
    'conversion_type' => 'page_like',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'ratio': 0.01,
        'country': 'US',
        'page_id': '<PAGE_ID>',
        'conversion_type': 'page_like',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "ratio": 0.01, 
    "country": "US", 
    "page_id": "<PAGE_ID>", 
    "conversion_type": "page_like" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
名稱 描述

lookalike_spec

類型:陣列

此為必要項目。

請參閱下方說明。

lookalike_spec.page_id

類型:整數

此為必要項目。

用於建立類似廣告受眾的粉絲所屬專頁的 Facebook 編號

lookalike_spec.conversion_type

類型:字串

此為必要項目。

page_like:表明這是專頁粉絲類似廣告受眾

lookalike_spec.country

類型:字串

此為必要項目。

用於尋找類似廣告受眾用戶的國家/地區。預設值為「美國」

lookalike_spec.allow_international_seeds

類型:布林值

此為選用項目。

您最少需要有 100 個來自同一個國家/地區的種子廣告受眾成員。如果未達此最低值,系統會將 allow_international_seeds 設定為 true,即 Facebook 會在另一國家/地區尋找成員,以達至此最低數量。預設為 false

lookalike_spec.starting_ratio

類型:浮點數

此為選用項目。

類似廣告受眾的開始百分比。例如,若您設定 starting_ratio 為 0.01,而 ratio 則設定為 0.02,就可根據 1% 至 2% 的類似廣告受眾族群建立類似廣告受眾。starting_ratio 值必須少於 ratio 的值

lookalike_spec.ratio

類型:浮點數

此為必要項目。

範圍為 0.01 至 0.20。類似廣告受眾的目標國家/地區數量。

目標設定

鎖定類似廣告受眾與鎖定自訂廣告受眾的方式相同。請參閱自訂廣告受眾目標設定。這也同樣適用於排除目標設定和連結的 AND 目標設定。如要在建立廣告時指定目標:

use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdSetBillingEventValues;
use FacebookAds\Object\Values\AdSetOptimizationGoalValues;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;

$adset = new AdSet(null, 'act_<AD_ACCOUNT_ID>');
$adset->setData(array(
  AdSetFields::NAME => 'My AdSet',
  AdSetFields::OPTIMIZATION_GOAL => AdSetOptimizationGoalValues::REACH,
  AdSetFields::BILLING_EVENT => AdSetBillingEventValues::IMPRESSIONS,
  AdSetFields::BID_AMOUNT => 2,
  AdSetFields::DAILY_BUDGET => 1000,
  AdSetFields::CAMPAIGN_ID => <CAMPAIGN_ID>,
  AdSetFields::TARGETING => (new Targeting())->setData(array(
    TargetingFields::GEO_LOCATIONS => array(
      'countries' => array('US'),
    ),
    TargetingFields::CUSTOM_AUDIENCES => array(
      array(
        'id' => <LOOKALIKE_AUDIENCE_ID>,
      ),
    ),
  )),
));

$adset->create(array(
  AdSet::STATUS_PARAM_NAME => AdSet::STATUS_ACTIVE,
));
from facebookads.adobjects.adset import AdSet

adset = AdSet(parent_id='act_<AD_ACCOUNT_ID>')
adset.update({
    AdSet.Field.name: 'My Adset',
    AdSet.Field.daily_budget: 10000,
    AdSet.Field.campaign_id: '<CAMPAIGN_ID>',
    AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks,
    AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks,
    AdSet.Field.bid_amount: 150,
    AdSet.Field.daily_budget: 2000,
    AdSet.Field.targeting: {
        'geo_locations': {
            'countries': ['US'],
        },
        'custom_audiences': [
            {
                'id': <LOOKALIKE_AUDIENCE_ID>,
            },
        ],
    },
})

adset.remote_create(params={
    'status': AdSet.Status.paused,
})
AdSet adSet = new AdAccount(act_<AD_ACCOUNT_ID>, context).createAdSet()
  .setName("My AdSet")
  .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
  .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
  .setBidAmount(2L)
  .setDailyBudget(1000L)
  .setCampaignId(<CAMPAIGN_ID>)
  .setTargeting(
    new Targeting()
      .setFieldCustomAudiences(Arrays.asList(
        new IDName()
          .setFieldId(<LOOKALIKE_AUDIENCE_ID>)
      ))
      .setFieldGeoLocations(
        new TargetingGeoLocation()
          .setFieldCountries(Arrays.asList("US"))
      )
  )
  .setStatus(AdSet.EnumStatus.VALUE_ACTIVE)
  .execute();
String ad_set_id = adSet.getId();
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={ 
    "custom_audiences": [{"id":"<LOOKALIKE_AUDIENCE_ID>"}], 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

更多範例請參閱目標設定規格

管理廣告受眾

詳細瞭解用於建立類似廣告受眾的自訂廣告受眾,以及類似廣告受眾。我們傳回的欄位與自訂廣告受眾相同。以下是用於建立類似廣告受眾的自訂廣告受眾之回應範例。lookalike_audience_ids 用於指定哪些類似廣告受眾是根據此廣告受眾而產生。

 {
  "id": "6006164557194",
  "account_id": 12345,
  "approximate_count": 816400,
  "lookalike_audience_ids": [
    6006183285954,
    6006183285955
  ],
  "name": "Boys Apparel",
  "parent_audience_id": 0,
  "parent_category": "Custom",
  "status": "ready",
  "subtype": "CUSTOM",
  "type": 4,
  "type_name": "Advertiser Generated",
  "time_updated": 1362439491
}, 

類似廣告受眾包含的 subtype 為 2。我們還會傳回 lookalike_spec 陣列,格式如下:

名稱 描述

type

類型:字串

similarityreachcustom_ratio:一律傳回

starting_ratio

類型:浮點數

在指定 starting_ratio 時傳回

ratio

類型:浮點數

0.01 的倍數。在 typecustom_ratio 時傳回

country

類型:字串

國碼/區碼

origin

類型:陣列

請參閱下方說明。

origin.deleted

類型:布林值

true,在刪除來源時傳回

origin.id

類型:整數

原始自訂廣告受眾編號

origin.name

類型:字串

原始自訂廣告受眾名稱

origin.type

類型:字串

custom_audiencepage

target_countries

類型:字串陣列

所有用於建立廣告受眾的國家/地區

以下是 subtypeLOOKALIKE 的另一廣告受眾:

{
 "id": "6006183285954",
 "account_id": 12345,
 "approximate_count": 1782100,
 "name": "Boys Apparel_lookalike_US_Similarity",
 "origin_audience_id": 6006567610735,
 "parent_audience_id": 0,
 "parent_category": "Custom",
 "status": "ready",
 "subtype": "LOOKALIKE",
 "type": 4,
 "type_name": "Advertiser Generated",
 "time_updated": 1362506552
},  

刊登狀況狀態

建立類似廣告受眾後,我們將會傳回自訂廣告受眾編號。該廣告受眾或需 1 個小時才能完全加滿。您可以在 /{lookalike_audience_ID}?fields=delivery_status 獲得狀態。自動填入廣告受眾後,系統將傳回附有 delivery_status 或代碼 200 的 JSON 回應:

"delivery_status": {
  "code": 200, 
  "description": "This audience is ready for use."
},

為了進行測試,您應以廣告管理員身分來檢查清單狀態。

如要刪除類似廣告受眾,其步驟與刪除自訂廣告受眾的方式相同。

停用廣告受眾

如果 90 天內沒有在有效的廣告中使用類似廣告受眾,此類似廣告受眾則視為已停用。已停用的類似廣告受眾具有不同的 approximate_countoperation_statusdelivery_estimate

欄位停用類似廣告受眾後的變更

approximate_count

您無法擷取尺寸資訊。如為停用的類似廣告受眾呼叫此欄位,則會傳回 -1

operation_status

450:此類似廣告受眾現為停用。此類似廣告受眾仍可以在廣告中使用,但不會具有估計值,直到宣傳活動發佈前為止。
100:如果超過 2 年未在刊登中的廣告組合使用廣告受眾,即會開始過期。如果在 90 天內仍未使用即將過期的廣告受眾,廣告受眾就會被刪除。

delivery_estimate

您無法擷取刊登估值。如為停用的類似廣告受眾呼叫此欄位,則會傳回 -1。您可在廣告帳戶和廣告組合節點下找到此欄位。兩者會就停用的類似廣告受眾展示相同的行為。

delete_time

如果廣告受眾的 operation_status 被標記為即將過期(代碼 100),delete_time 欄位會顯示系統刪除該廣告受眾的時間(以 Unix 時間為單位)。

您仍可以使用停用的類似廣告受眾來開始宣傳活動。當您新的廣告發佈後,系統會提供接觸人數預估資訊。

刪除

對於 2021 年 6 月 8 日之後的所有廣告客戶,一旦廣告受眾停用時間超過 2 年,我們都會自動將其移動至「即將過期的廣告受眾」階段。換言之,如果廣告受眾未在刊登中的廣告組合中使用的時間超過 2 年,系統會自動將其標示為「即將過期的廣告受眾」,delete_time 欄位也會標示估計刪除時間(即標示之時的 90 天後),屆時系統預計將會刪除該廣告受眾。

您之後可以主動刪除該廣告受眾,也可以在刊登中的廣告組合中使用該廣告受眾,以免廣告受眾遭刪除。您可以篩選廣告受眾的 operation_statusdelete_time 欄位,以便隨時查看哪些廣告受眾處於即將過期的階段。

如要瞭解更多資訊,請查看自訂廣告受眾概覽文件。

最佳操作實例

  • 種子自訂廣告受眾 - 將之盡量擴大,以便我們有足夠數據尋找類似用戶。
  • 合併類似廣告受眾 - 結合使用其他 Facebook 目標設定,以獲得額外人口統計資料或興趣。
  • 如果您的種子廣告受眾具有屬性,如性別或地理位置,其所產生的類似廣告受眾未必會遵循此等屬性。

近期類似廣告受眾的變更

於 2021 年 4 月 28 日更新:類似廣告受眾建立流程的 location_speccountry 參數暫時不會移除。我們會陸續公佈有關此項變更何時生效的最新消息。

我們將從類似廣告受眾建立流程中移除 location_speccountry 參數。類似廣告受眾的地點將由宣傳活動目標設定規格中的國家/地區地點來定義。目標地點不屬於類似廣告受眾規格之一。系統只會在廣告發佈後的幾個小時內,自動填入使用新建立的類似廣告受眾來估計的宣傳活動接觸人數。

此項變更不會影響現有的宣傳活動。此要求僅會影響全新及編輯過的宣傳活動。

如果沒有目標地點,我們會將舊版類似廣告受眾自動轉換為新版類似廣告受眾。

類似廣告受眾建立流程變更

地點參數變更

端點:act_{AD_ACCOUNT_ID}/customaudiences

要求範例

curl POST \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F ‘lookalike_spec={
  "is_financial_service":false,
  "allow_international_seeds":true,
  "ratio":0.01,
  "type":"custom_ratio"}
  	’}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

如果已在建立流程期間傳遞以下參數,系統便會略過相關參數:

  • lookalike_spec.country
  • lookalike_spec.location_spec
  • lookalike_spec.location_spec.geo_locations
  • lookalike_spec.location_spec.geo_locations.countries
  • lookalike_spec.location_spec.geo_locations.country_groups
  • lookalike_spec.location_spec.excluded_geo_locations
  • lookalike_spec.location_spec.excluded_geo_locations.countries
  • lookalike_spec.location_spec.excluded_geo_locations.country_groups

尺寸參數變更

端點:act_{AD_ACCOUNT_ID}?fields=approximate_count

新版類似廣告受眾將不會有相關的尺寸,且 approximate_count 欄位將為所有類似廣告受眾傳回 -1

回應範例

{
    "approximate_count": -1,
    "id": "6126486105659",
}

刊登和營運狀態

端點:

  • {AD_ACCOUNT_ID}?fields=delivery_status
  • {AD_ACCOUNT_ID}?fields=operation_status

設有地點規格的舊版類似廣告受眾 delivery_status 欄位將傳回代碼 400,並附有說明 This audience is disabled.。對於新版類似廣告受眾,將傳回代碼 200 的回應。

operation_status 欄位將就設有地點規格的舊版類似廣告受眾傳回停用通知。對於新版類似廣告受眾,系統將傳回代碼 200Normal 說明的回應。

更多關於這些欄位的資訊,請參閱自訂廣告受眾

廣告組合變更

廣告建立流程和編輯

如果您編輯了包含舊版類似廣告受眾的現有宣傳活動目標設定,我們將自動升級廣告以使用新版類似廣告受眾。舊版類似廣告受眾將不再可用於新建立的廣告宣傳活動。

從類似廣告受眾建立流程中移除地點規格後,您將需要在廣告組合建立流程期間設定地點目標。若在未設定地點目標的情況下嘗試建立廣告組合,將導致錯誤。

如果廣告受眾包含在宣傳活動的 excluded_custom_audiencesflexible_spec 以及 exclusions 中,則以上所有變更都適用。

端點:act_{AD_ACCOUNT_ID}/adsets

要求範例

curl POST \
  -F 'targeting={
        "geo_locations":{
            "countries":["US"],
        },
        "age_min":25,
        "age_max":40,
        "custom_audiences":[{"id": <CUSTOM_AUDIENCE_ID>}]
  ‘}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

若在未設定地點目標的情況下嘗試建立廣告組合,將導致錯誤。

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342134,
    "is_transient": false,
    "error_user_title": "Missing Location while using Lookalike",
    "error_user_msg": "You need to use a location with your lookalike    audience.",
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

如果您嘗試編輯包含共用舊版類似廣告受眾的廣告組合,但在擁有廣告受眾的廣告帳戶中沒有對應的新版類似廣告受眾,則會發生錯誤。請要求擁有廣告受眾的廣告帳戶與您分享新版類似廣告受眾,以解決問題。

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342135,
    "is_transient": false,
    "error_user_title": "",
    "error_user_msg": "Please ask the owner of the audience 1234 to share the new lookalike which does not contain location with you. You will be able to use the new audience"
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

分享類似廣告受眾

在推出這些變更期間,您將無法透過 API 在屬於及不屬於變更計劃的廣告帳戶之間分享類似廣告受眾。請使用受眾管理員來處理分享事宜。2021 年 5 月 24 日以後,您可以繼續透過以下開發人員文件中的 API 使用分享功能,以在廣告帳戶之間分享新版類似廣告受眾。

端點:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}

接觸人數和刊登估值變更

端點:

  • act_{AD_ACCOUNT_ID}/reachestimate
  • act_{AD_ACCOUNT_ID}/delivery_estimate

這些端點將傳回一個新的 targeting_status 參數,並含有以下說明之一:

  • lookalike_container_without_country — 新版類似廣告受眾沒有在宣傳活動目標設定中指定國家/地區。需要提供國家/地區,以查看估計的用戶人數。
  • lookalike_container_without_delivery_lookalike — 新版類似廣告受眾沒有相應的後端類似廣告受眾。您需要在廣告組合中使用新版類似廣告受眾,才能真正獲取接觸人數。
  • none — 此接觸人數沒有任何問題。

首次使用新版類似廣告受眾和國家/地區目標時,reachestimate 端點將為 users 參數傳回 -1;此後將傳回估計的用戶人數。

首次使用新版類似廣告受眾和國家/地區目標時,estimate_dauestimate_mau 參數將為 users 參數傳回 -1;此後將傳回估計的用戶人數。

回應範例

// Reach estimate response
{
    "users": -1,
    "estimate_ready": true,
    "targeting_status": "lookalike_container_without_delivery_lookalike"
}

// Delivery estimate response

{
    "data": [{
        "daily_outcomes_curve": [{
            "spend": 0,
            "reach": 0,
            "impressions": 0,
            "actions": 0
        }],
        "estimate_dau": -1,
        "estimate_mau": -1,
        "estimate_ready": true ,
        "targeting_status": "lookalike_container_without_delivery_lookalike"
    }]
}

常見問題

這些變更會在推廣 API v11 的發佈日期生效,屆時我們會將變更套用至所有版本。

在由推廣 API v10 轉至 v11 期間,您將無法透過 API 在屬於及不屬於計劃的廣告帳戶之間分享類似廣告受眾。請使用廣告受眾管理工具來處理分享事宜。推廣 API v11 發佈後,您可以繼續透過 API 使用分享功能,以在不同廣告帳戶之間分享新的類似廣告受眾。