Đối tượng tương tự

Nhắm mục tiêu những người giống với các khách hàng hiện có của bạn nhất. Đối tượng tương tự lấy một vài nhóm người làm "nguồn", sau đó Facebook tạo một đối tượng gồm những người tương tự. Bạn có thể sử dụng đối tượng tương tự cho bất kỳ mục tiêu kinh doanh nào: Nhắm mục tiêu những người giống với khách hàng của bạn để thu hút fan, đăng ký trang web, mua hàng ngoài Facebook, nhận ưu đãi phiếu giảm giá hoặc chỉ để nâng cao mức độ nhận biết về thương hiệu.

Đối tượng nguồn có thể là:

Cứ 3 ngày 1 lần, Facebook sẽ làm mới các thành viên trong một đối tượng tương tự nếu đối tượng đó thuộc về một nhóm quảng cáo.

Tạo

Đối tượng tương tự có thể mất từ 1 đến 6 giờ mới hiển thị đầy đủ. Bạn có thể tạo và chạy nhóm quảng cáo nhắm mục tiêu đến đối tượng trong khi đối tượng đang kết nạp thành viên. Sau khi đối tượng đã sẵn sàng, Facebook sẽ phân phối quảng cáo đến những người được kết nạp vào đối tượng và phân phối quảng cáo sẽ cập nhật và hoạt động như bình thường. Hãy xem phần Trạng thái phân phối. Tạo đối tượng tương tự mới trên: https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences.

Ví dụ về lệnh gọi để tạo đối tượng tương tự từ một đối tượng tùy chỉnh:

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

Để tạo đối tượng tương tự với SDK Quảng cáo PHP hoặc SDK Quảng cáo Python, hãy sử dụng CustomAudience.

Phản hồi chứa:

Tên Mô tả

id

loại: số nguyên

ID của đối tượng tương tự

Đối tượng tương tự đối tượng tùy chỉnh

Nếu Đối tượng tùy chỉnh của bạn có ít nhất 100 người, thì bạn có thể tạo đối tượng tương tự dựa trên đó. Đối tượng này bao gồm Đối tượng tùy chỉnh cho trang web và Đối tượng tùy chỉnh cho ứng dụng di động của bạn.

Tên Mô tả

name

loại: chuỗi

Bắt buộc.

Tên Đối tượng tùy chỉnh

origin_audience_id

loại: dài

Bắt buộc.

ID của Đối tượng tùy chỉnh. Đối tượng gốc phải có ít nhất 100 thành viên.

lookalike_spec

kiểu: mảng

Bắt buộc.

Xem mô tả bên dưới.

lookalike_spec.type

loại: chuỗi

Bắt buộc. Đặt type hoặc ratio.

similarity hoặc reach

lookalike_spec.starting_ratio

loại: nổi

Không bắt buộc.

Phần trăm bắt đầu cho đối tượng tương tự. Ví dụ: starting_ratio 0,01 và ratio 0,02 sẽ tạo đối tượng tương tự từ 1% đến 2% phân khúc đối tượng tương tự. starting_ratio phải nhỏ hơn ratio

lookalike_spec.ratio

loại: nổi

Bắt buộc. Đặt type hoặc ratio.

0.01-0.20 tăng theo mức 0,01. x% hàng đầu của đối tượng gốc trong một quốc gia đã chọn

lookalike_spec.allow_international_seeds

loại: boolean

Không bắt buộc.

Ít nhất phải có 100 thành viên trong đối tượng nguồn từ một quốc gia. Nếu không, allow_international_seeds được đặt thành true nghĩa là Facebook tìm thấy số lượng thành viên tối thiểu của đối tượng ở một quốc gia khác. Giá trị mặc định là false.

lookalike_spec.country

loại: chuỗi

Bắt buộc. Đặt country hoặc location_spec.

Tìm thành viên cho đối tượng tương tự ở quốc gia này

lookalike_spec.location_spec

loại: mảng

Bắt buộc. country hoặc location_spec.

Tìm thành viên đối tượng ở những vị trí này. Danh sách các quốc gia hoặc nhóm quốc gia, chẳng hạn như Asia

lookalike_spec.location_spec.geo_locations

loại: mảng

Bắt buộc. Tối thiểu một mục nhập trong countries hoặc country_groups.

Bao gồm những vị trí này

lookalike_spec.location_spec.geo_locations.countries

loại: mảng chuỗi

Không bắt buộc.

Các quốc gia mục tiêu. Mảng mã quốc gia, hãy xem phần API tìm kiếm tùy chọn nhắm mục tiêu, Quốc gia. Ví dụ: 'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

loại: mảng chuỗi

Không bắt buộc.

Các quốc gia mục tiêu ở các khu vực trên toàn cầu và các khu vực mậu dịch tự do. Mảng mã nhóm quốc gia. Để biết tất cả tùy chọn, hãy xem phần Nhắm mục tiêu, Vị trí, country_groupsTìm kiếm tùy chọn nhắm mục tiêu, country_groups. Ví dụ: 'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

loại: mảng

Không bắt buộc.

Các vị trí cần loại trừ

lookalike_spec.location_spec.excluded_geo_locations.countries

loại: mảng chuỗi

Không bắt buộc.

Tương tự như countries trong geo_locations

lookalike_spec.location_spec.excluded_geo_locations.country_groups

loại: mảng chuỗi

Không bắt buộc.

Tương tự như country_groups trong geo_locations

Loại

Tối ưu hóa đối tượng của bạn cho "Điểm tương đồng" hoặc "Số người tiếp cận lớn hơn".

  • Điểm tương đồng - Đối tượng bao gồm 1% trên cùng những người ở quốc gia đã chọn gần giống nhất với Đối tượng tùy chỉnh nguồn. Số người tiếp cận của đối tượng mới nhỏ hơn, khớp chính xác hơn.
  • Số người tiếp cận lớn hơn - Đối tượng bao gồm 5% trên cùng những người ở quốc gia đã chọn tương tự với Đối tượng tùy chỉnh nguồn, tuy nhiên có độ khớp ít chính xác hơn.

Thay vì sử dụng các loại, bạn có thể đặt ratio theo cách thủ công để biểu thị giá trị x% cao nhất của đối tượng ở quốc gia được chọn.ratio phải từ 1%-20% và trong khoảng 1%.

Đối tượng tương tự dựa trên chuyển đổi của chiến dịch hoặc nhóm quảng cáo

Facebook có loại đối tượng tương tự dựa trên chuyển đổi của chiến dịch và nhóm quảng cáo để nhắm mục tiêu những người tương tự với những người đã chuyển đổi của các chiến dịch hoặc nhóm quảng cáo hiện tại hoặc trước đây. Ví dụ: các chiến dịch hoặc quảng cáo đang tối ưu hóa cho chuyển đổi. Chúng tôi đo lường chuyển đổi dựa trên loại chiến dịch hoặc nhóm quảng cáo trong Thông số chuyển đổi. Ví dụ: nhắm mục tiêu những người đã thực hiện hành động trên trang web hoặc đã cài đặt ứng dụng của bạn trong vòng 28 ngày kể từ ngày nhấp vào quảng cáo.

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

Bạn cần ít nhất 100 chuyển đổi duy nhất từ chiến dịch hoặc nhóm quảng cáo của mình. Nhiều người chuyển đổi hơn sẽ mang lại mô hình dự đoán tốt hơn và chúng tôi đề xuất 200 thành viên đã chuyển đổi trở lên. Bạn cũng nên chọn các chiến dịch hoặc nhóm quảng cáo có mục tiêu tương tự.

Để tạo đối tượng tương tự này, hãy chỉ định một hoặc nhiều chiến dịch hay nhóm quảng cáo của bạn. Ví dụ: chỉ định một chiến dịch và hai nhóm quảng cáo của một chiến dịch khác.

Facebook sử dụng dữ liệu chuyển đổi của tối đa 180 ngày đã qua và xác định những người chuyển đổi trên chiến dịch và nhóm quảng cáo của bạn như ví dụ. Chúng tôi đào tạo mô hình dự đoán, sau đó tạo đối tượng tương tự. Facebook không ngừng cập nhật mô hình dự đoán cơ bản khi các chiến dịch hoặc nhóm quảng cáo nhận lượt chuyển đổi mới.

Tên Mô tả

lookalike_spec

loại: mảng

Bắt buộc.

Xem mô tả bên dưới.

lookalike_spec.origin_ids

loại: mảng số nguyên

Bắt buộc.

Mảng id đối tượng quảng cáo. Những người chuyển đổi trên những quảng cáo này được sử dụng để lập mô hình đối tượng tương tự. Một hoặc nhiều ID chiến dịch hoặc ID nhóm quảng cáo hoặc kết hợp cả hai.

lookalike_spec.conversion_type

loại: chuỗi

Bắt buộc.

campaign_conversions. Cho biết đối tượng là một đối tượng tương tự dựa trên chuyển đổi của chiến dịch

lookalike_spec.country

loại: chuỗi

Bắt buộc.

Quốc gia để tìm thành viên tương tự.

lookalike_spec.allow_international_seeds

loại: boolean

Không bắt buộc.

Ít nhất phải có 100 thành viên trong đối tượng hạt giống từ một quốc gia. Nếu không, allow_international_seeds được đặt thành true nghĩa là Facebook tìm thấy số lượng thành viên tối thiểu ở một quốc gia khác. Giá trị mặc định là false.

lookalike_spec.starting_ratio

loại: nổi

Không bắt buộc.

Phần trăm bắt đầu cho đối tượng tương tự. Ví dụ: starting_ratio 0,01 và ratio 0,02 sẽ tạo đối tượng tương tự từ 1% đến 2% phân khúc đối tượng tương tự. starting_ratio phải nhỏ hơn ratio

lookalike_spec.ratio

loại: nổi

Bắt buộc.

Phạm vi 0.01-0.20. X% hàng đầu của đối tượng gốc ở quốc gia đã chọn.

Hiện tại, các loại chuyển đổi chiến dịch sau đủ điều kiện nhận Đối tượng tương tự:

  • Lượt click vào liên kết
  • Quảng cáo ưu đãi
  • Lượt thích Trang
  • Lượt cài đặt ứng dụng canvas
  • Lượt phản hồi sự kiện
  • Lượt tương tác với bài viết
  • Lượt chuyển đổi trên trang web
  • Lượt cài đặt ứng dụng di động
  • Tương tác với ứng dụng di động
  • Lượt xem video
  • Mức độ nhận biết tại địa phương

Đối tượng tương tự những người hâm mộ Trang

Tạo đối tượng tương tự dựa trên những người thích Trang của bạn:

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
Tên Mô tả

lookalike_spec

loại: mảng

Bắt buộc.

Xem mô tả bên dưới.

lookalike_spec.page_id

loại: số nguyên

Bắt buộc.

ID Facebook của trang có người hâm mộ sẽ được sử dụng cho đối tượng tương tự này

lookalike_spec.conversion_type

loại: chuỗi

Bắt buộc.

page_like - Cho biết đối tượng tương tự này là fan của trang

lookalike_spec.country

loại: chuỗi

Bắt buộc.

Quốc gia để tìm những người tương tự. Giá trị mặc định là 'Hoa Kỳ'

lookalike_spec.allow_international_seeds

loại: boolean

Không bắt buộc.

Bạn cần phải có ít nhất 100 thành viên đối tượng nguồn từ một quốc gia. Nếu không đạt được giá trị tối thiểu này, allow_international_seeds được đặt thành true nghĩa là Facebook tìm thấy số lượng thành viên tối thiểu của đối tượng hạt giống ở quốc gia khác. Giá trị mặc định là false.

lookalike_spec.starting_ratio

loại: nổi

Không bắt buộc.

Phần trăm bắt đầu của đối tượng tương tự. Ví dụ: starting_ratio là 0,01 và ratio là 0,02 sẽ tạo đối tượng tương tự từ 1% đến 2% phân khúc đối tượng tương tự. Giá trị của starting_ratio phải luôn nhỏ hơn giá trị của ratio

lookalike_spec.ratio

loại: nổi

Bắt buộc.

Phạm vi: 0,01-0,2. Số vùng của quốc gia đó mà đối tượng tương tự phải nhắm mục tiêu.

Nhắm mục tiêu

Nhắm mục tiêu đối tượng tương tự giống với nhắm mục tiêu Đối tượng tùy chỉnh. Hãy xem phần Đối tượng tùy chỉnh, Nhắm mục tiêu. Tùy chọn này cũng áp dụng cho nhắm mục tiêu loại trừ và nhắm mục tiêu AND liên kết. Cách nhắm mục tiêu khi bạn tạo quảng cáo:

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

Xem thêm ví dụ ở phần Thông số nhắm mục tiêu.

Quản lý đối tượng

Xem thông tin chi tiết về đối tượng tùy chỉnh được dùng để tạo đối tượng tương tự. Chúng tôi trả về các trường tương tự như Đối tượng tùy chỉnh. Dưới đây là phản hồi mẫu cho một Đối tượng tùy chỉnh được dùng để tạo đối tượng tương tự. lookalike_audience_ids cho biết đối tượng tương tự nào đã được tạo từ đối tượng này.

 {
  "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
}, 

Đối tượng tương tự chứa subtype là 2. Chúng tôi cũng trả về lookalike_spec, một mảng có định dạng sau:

Tên Mô tả

type

loại: chuỗi

similarity, reach hoặc custom_ratio - Luôn được trả về

starting_ratio

loại: nổi

Trả về nếu starting_ratio được chỉ định

ratio

loại: nổi

Bội số của 0.01. Được trả về nếu typecustom_ratio

country

loại: chuỗi

Mã quốc gia

origin

loại: mảng

Xem mô tả bên dưới.

origin.deleted

loại: boolean

true, Trả về khi giá trị gốc bị xóa

origin.id

loại: số nguyên

ID gốc

origin.name

loại: chuỗi

Tên gốc

origin.type

loại: chuỗi

custom_audience hoặc page

target_countries

loại: mảng chuỗi

Tất cả các quốc gia được sử dụng để tạo đối tượng

Một đối tượng khác bên dưới có 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
},  

Trạng thái phân phối

Sau khi bạn tạo đối tượng tương tự, chúng tôi sẽ trả về ID đối tượng tùy chỉnh. Có thể cần khoảng một giờ để đối tượng kết nạp đủ số thành viên. Bạn có thể lấy trạng thái tại: /{lookalike_audience_ID}?fields=delivery_status. Lệnh này trả về phản hồi JSON có delivery_status hoặc mã 200 nếu một đối tượng xuất hiện:

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

Để thử nghiệm, bạn nên kiểm tra trạng thái của danh sách bằng Trình quản lý quảng cáo.

Để xóa một đối tượng tương tự, bạn thực hiện tương tự như đối với Đối tượng tùy chỉnh.

Đối tượng không hoạt động

Đối tượng tương tự được xem là không hoạt động khi không được sử dụng trong quảng cáo đang chạy trong 90 ngày. Đối tượng tương tự không hoạt động có approximate_count, operation_statusdelivery_estimate khác nhau.

TrườngCác thay đổi đối với đối tượng tương tự không hoạt động

approximate_count

Bạn không thể truy xuất quy mô. Lệnh gọi cho trường này sẽ trả về -1 cho đối tượng tương tự không hoạt động.

operation_status

450: Đối tượng tương tự này không hoạt động. Bạn có thể sử dụng đối tượng tương tự này trong quảng cáo nhưng sẽ không có số liệu ước tính cho đến khi đăng chiến dịch.
100: Đối tượng sẽ hết hạn nếu trong hơn 2 năm mà không được sử dụng cho nhóm quảng cáo đang hoạt động nào. Sau 90 ngày, những đối tượng sắp hết hạn sẽ bị xóa nếu vẫn không được sử dụng.

delivery_estimate

Bạn không thể truy xuất giá trị ước tính phân phối. Lệnh gọi cho trường này sẽ trả về -1 cho đối tượng tương tự không hoạt động. Trường này có sẵn trong các nút Tài khoản quảng cáo và Nhóm quảng cáo. Cả hai nút đều thể hiện cùng một hành vi cho đối tượng tương tự không hoạt động.

delete_time

Khi operation_status của đối tượng được đánh dấu là sắp hết hạn (mã 100), trường delete_time sẽ cho bạn biết thời gian Unix mà đối tượng đó sẽ bị xóa.

Bạn vẫn có thể bắt đầu một chiến dịch bằng cách sử dụng đối tượng tương tự không hoạt động. Thông tin về số người tiếp cận ước tính sẽ có sẵn sau khi quảng cáo mới của bạn được đăng.

Xóa

Áp dụng với tất cả nhà quảng cáo kể từ ngày 08/06/2021 trở đi, chúng tôi sẽ tự động chuyển các đối tượng không hoạt động trong hơn 2 năm sang giai đoạn "Đối tượng sắp hết hạn". Điều này nghĩa là sau khi đối tượng đạt đến ngưỡng hơn 2 năm không được sử dụng trong nhóm quảng cáo đang hoạt động nào, đối tượng đó sẽ tự động bị gắn cờ là "Đối tượng sắp hết hạn". Đồng thời, trường delete_time sẽ được đánh dấu bằng thời gian xóa dự kiến (90 ngày kể từ khi gắn cờ) khi lên lịch xóa đối tượng đó.

Sau đó, bạn có thể chủ động xóa đối tượng hoặc sử dụng đối tượng trong nhóm quảng cáo đang hoạt động nào đó để tránh bị xóa. Bất cứ lúc nào bạn cũng có thể xem những đối tượng nào đang ở giai đoạn sắp hết hạn bằng cách lọc theo trường operation_status hoặc delete_time.

Để biết thêm thông tin, hãy xem tài liệu Tổng quan về Đối tượng tùy chỉnh.

Cách làm tốt nhất

  • Đối tượng tùy chỉnh nguồn - Tạo đối tượng này càng lớn càng tốt để chúng tôi có đủ dữ liệu tìm những người tương tự.
  • Đối tượng tương tự kết hợp - Với tùy chọn nhắm mục tiêu khác của Facebook cho các thông tin nhân khẩu học hoặc sở thích khác.
  • Nếu đối tượng nguồn có các thuộc tính như giới tính hoặc khu vực địa lý, thì các đối tượng tương tự được tạo có thể không tuân theo những thuộc tính đó.

Các thay đổi sắp tới đối với đối tượng tương tự

CẬP NHẬT VÀO NGÀY 28/04/2021: Hiện đã hoãn việc gỡ thông số location_speccountry khỏi quá trình tạo đối tượng tương tự. Chúng tôi sẽ sớm đưa ra thông báo cập nhật về thời điểm thay đổi này có hiệu lực.

Chúng tôi sẽ gỡ các thông số location_speccountry khỏi quá trình tạo đối tượng tương tự. Vị trí của đối tượng tương tự sẽ được xác định theo vị trí quốc gia trong thông số nhắm mục tiêu của chiến dịch. Vị trí mục tiêu sẽ không hiển thị trong thông số đối tượng tương tự. Số người tiếp cận ước tính của chiến dịch sử dụng đối tượng tương tự mới tạo sẽ chỉ xuất hiện sau vài giờ kể từ lúc đăng quảng cáo.

Sự thay đổi này sẽ không ảnh hưởng đến các chiến dịch hiện có. Yêu cầu này sẽ chỉ ảnh hưởng đến các chiến dịch mới và chiến dịch được chỉnh sửa.

Chúng tôi sẽ tự động chuyển đổi đối tượng tương tự cũ thành đối tượng tương tự mới mà không cần vị trí mục tiêu.

Các thay đổi đối với quá trình tạo đối tượng tương tự

Các thay đổi đối với thông số vị trí

Điểm cuối:act_{AD_ACCOUNT_ID}/customaudiences

Yêu cầu mẫu

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

Các thông số sau sẽ bị bỏ qua nếu được chuyển trong quá trình tạo:

  • 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

Các thay đổi đối với thông số quy mô

Điểm cuối:act_{AD_ACCOUNT_ID}?fields=approximate_count

Sẽ không có quy mô nào liên kết với đối tượng tương tự mới và trường approximate_count sẽ trả về -1 cho tất cả các đối tượng tương tự.

Phản hồi mẫu

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

Trạng thái phân phối và hoạt động

Điểm cuối:

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

Trường delivery_status cho đối tượng tương tự cũ có thông số vị trí sẽ trả về một mã 400 có mô tả This audience is disabled.. Đối với đối tượng tương tự mới, trường này sẽ trả về một phản hồi mã 200.

Trường operation_status sẽ trả về một thông báo ngừng hoạt động cho đối tượng tương tự cũ có thông số vị trí. Đối với đối tượng tương tự mới, trường này sẽ trả về một phản hồi mô tả mã 200Normal.

Hãy xem phần Đối tượng tùy chỉnh để biết thêm thông tin về các trường này.

Các thay đổi đối với nhóm quảng cáo

Tạo và chỉnh sửa quảng cáo

Chúng tôi sẽ tự động nâng cấp quảng cáo để sử dụng các đối tượng tương tự mới nếu tùy chọn nhắm mục tiêu của chiến dịch hiện có chứa đối tượng tương tự cũ được chỉnh sửa. Đối tượng tương tự cũ sẽ không còn sử dụng được trong các chiến dịch quảng cáo mới tạo.

Khi thông số vị trí bị gỡ khỏi quá trình tạo đối tượng tương tự, bạn sẽ cần đặt mục tiêu vị trí trong quá trình tạo Nhóm quảng cáo. Việc cố tạo Nhóm quảng cáo mà không có tùy chọn nhắm mục tiêu theo vị trí sẽ dẫn đến lỗi.

Tất cả những thay đổi ở trên cũng sẽ được áp dụng khi đối tượng được đưa vào excluded_custom_audiences, flexible_specexclusions trong chiến dịch.

Điểm cuối:act_{AD_ACCOUNT_ID}/adsets

Yêu cầu mẫu

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

Việc cố tạo Nhóm quảng cáo mà không có tùy chọn nhắm mục tiêu theo vị trí sẽ dẫn đến lỗi.

{
  "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"
}

Lỗi sẽ xảy ra nếu bạn cố chỉnh sửa một Nhóm quảng cáo chứa đối tượng tương tự cũ được chia sẻ và không có đối tượng tương tự mới tương ứng trong tài khoản quảng cáo sở hữu. Hãy yêu cầu tài khoản quảng cáo sở hữu chia sẻ đối tượng tương tự mới với bạn để khắc phục sự cố.

{
  "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"
}

Chia sẻ đối tượng tương tự

Trong thời gian triển khai những thay đổi này, chúng tôi không hỗ trợ chia sẻ đối tượng tương tự qua API giữa tài khoản quảng cáo tham gia quá trình triển khai và tài khoản quảng cáo không tham gia quá trình triển khai. Vui lòng sử dụng Trình quản lý đối tượng để xử lý việc chia sẻ. Sau ngày 24/05/2021, bạn có thể tiếp tục sử dụng tính năng chia sẻ qua API trong tài liệu dành cho nhà phát triển dưới đây để chia sẻ đối tượng tương tự mới giữa các tài khoản quảng cáo.

Điểm cuối:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}

Các thay đổi đối với số người tiếp cận và mức phân phối ước tính

Điểm cuối:

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

Những điểm cuối này sẽ trả về một thông số targeting_status mới kèm theo một trong những mô tả sau:

  • lookalike_container_without_country - Đối tượng tương tự mới chưa chỉ định quốc gia trong tùy chọn nhắm mục tiêu chiến dịch. Cần có quốc gia để xem số người dùng ước tính.
  • lookalike_container_without_delivery_lookalike - Đối tượng tương tự mới không có đối tượng tương tự phụ trợ tương ứng. Đối tượng tương tự mới cần được sử dụng trong Nhóm quảng cáo để có số người tiếp cận thực.
  • none - Không có vấn đề với số người tiếp cận.

Điểm cuối reachestimate sẽ trả về -1 cho thông số users vào lần đầu tiên đối tượng tương tự mới và mục tiêu quốc gia được sử dụng; sau đó số người dùng ước tính sẽ được trả về.

Các thông số estimate_dauestimate_mau sẽ trả về -1 cho thông số users vào lần đầu tiên đối tượng tương tự mới và mục tiêu quốc gia được sử dụng; sau đó số người dùng ước tính sẽ được trả về.

Phản hồi mẫu

// 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"
    }]
}

Câu hỏi thường gặp

Những thay đổi này có hiệu lực vào ngày ra mắt API Marketing phiên bản 11, khi chúng tôi áp dụng thay đổi cho mọi phiên bản.

Trong thời gian chuẩn bị ra mắt API Marketing phiên bản 11, chúng tôi không hỗ trợ chia sẻ đối tượng tương tự qua API giữa tài khoản quảng cáo tham gia quá trình triển khai và tài khoản quảng cáo không tham gia quá trình triển khai. Vui lòng sử dụng Trình quản lý đối tượng để xử lý việc chia sẻ. Sau khi API Marketing phiên bản 11 ra mắt, bạn có thể tiếp tục sử dụng tính năng chia sẻ qua API để chia sẻ đối tượng tương tự mới giữa các tài khoản quảng cáo.