類似廣告受眾

鎖定與您現有顧客最相似的用戶。類似廣告受眾會使用幾組用戶作為「種子」,然後 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.010.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
}, 

類似廣告受眾包含 2 個 subtype 之一。我們也會傳回 lookalike_spec,下列格式的陣列:

名稱 說明

type

類型:字串

similarityreachcustom_ratio - 一律傳回

starting_ratio

類型:浮點

指定 starting_ratio 時傳回

ratio

類型:浮點

多重的 0.01typecustom_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 年的門檻,系統會自動將其標記為「到期廣告受眾」,且在系統排定刪除廣告受眾時,會以估計時間(即從標記時間開始的 90 天)標記 delete_time 欄位。

接著,您可以主動刪除廣告受眾,或在有效廣告組合中使用廣告受眾以避免刪除。您可以篩選廣告受眾的 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 欄位將傳回帶有 This audience is disabled. 說明的代碼 400。針對新類似廣告受眾,則會傳回代碼 200 的回應。

operation_status 欄位會針對具有地點規格的舊類似廣告受眾傳回淘汰通知。針對新類似廣告受眾,則會傳回代碼 200Normal 說明的回應。

請參閱自訂廣告受眾,以取得關於這些欄位的詳細資訊。

廣告組合的變更

廣告建立流程和編輯

如果編輯包含舊類似廣告受眾的現有行銷活動的目標設定,我們將自動升級廣告以使用新類似廣告受眾。舊類似廣告受眾將無法再用於新建立的廣告行銷活動。

在從類似廣告受眾建立流程中移除地點規格後,您將需要在廣告組合建立期間設定地點目標。如果嘗試建立沒有地點目標設定的廣告組合,將會產生錯誤。

當行銷活動中的 excluded_custom_audiencesflexible_specexclusions 中包括廣告受眾時,上述所有變更也將適用。

端點: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 第 11 版推出之日時生效。

在行銷 API 第 10 和第 11 版之間,不支援透過 API 在推出的廣告帳號和未推出的廣告帳號之間分享類似廣告受眾。請使用廣告受眾管理員來處理分享。行銷 API 第 11 版推出後,您可以繼續透過 API 使用分享,以在廣告帳號之間分享新的類似廣告受眾。