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.
Đố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ả |
---|---|
loại: số nguyên | ID của đối tượng tương tự |
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ả |
---|---|
loại: chuỗi | Bắt buộc. Tên Đối tượng tùy chỉnh |
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. |
kiểu: mảng | Bắt buộc. Xem mô tả bên dưới. |
loại: chuỗi | Bắt buộc. Đặt
|
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ụ: |
loại: nổi | Bắt buộc. Đặt
|
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, |
loại: chuỗi | Bắt buộc. Đặt Tìm thành viên cho đối tượng tương tự ở quốc gia này |
loại: mảng | Bắt buộc. 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ư |
loại: mảng | Bắt buộc. Tối thiểu một mục nhập trong Bao gồm những vị trí này |
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ụ: |
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í, |
loại: mảng | Không bắt buộc. Các vị trí cần loại trừ |
loại: mảng chuỗi | Không bắt buộc. Tương tự như |
loại: mảng chuỗi | Không bắt buộc. Tương tự như |
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".
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%.
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ả |
---|---|
loại: mảng | Bắt buộc. Xem mô tả bên dưới. |
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. |
loại: chuỗi | Bắt buộc.
|
loại: chuỗi | Bắt buộc. Quốc gia để tìm thành viên tương tự. |
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, |
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ụ: |
loại: nổi | Bắt buộc. Phạm vi |
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ự:
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ả |
---|---|
loại: mảng | Bắt buộc. Xem mô tả bên dưới. |
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 |
loại: chuỗi | Bắt buộc.
|
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ỳ' |
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, |
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 |
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 đố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.
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ả |
---|---|
loại: chuỗi |
|
loại: nổi | Trả về nếu |
loại: nổi | Bội số của |
loại: chuỗi | Mã quốc gia |
loại: mảng | Xem mô tả bên dưới. |
loại: boolean |
|
loại: số nguyên | ID gốc |
loại: chuỗi | Tên gốc |
loại: chuỗi |
|
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ó subtype
là LOOKALIKE
:
{ "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 },
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 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_status
và delivery_estimate
khác nhau.
Trường | Các thay đổi đối với đối tượng tương tự không hoạt động |
---|---|
| Bạn không thể truy xuất quy mô. Lệnh gọi cho trường này sẽ trả về |
|
|
| 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ề |
| Khi |
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.
Á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ẬP NHẬT VÀO NGÀY 28/04/2021: Hiện đã hoãn việc gỡ thông số location_spec
và country
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_spec
và country
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.
Đ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
Đ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", }
Đ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ã 200
và Normal
.
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.
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_spec
và exclusions
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" }
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}
Đ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_dau
và estimate_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" }] }
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.