Chiến dịch quảng cáo, nhóm quảng cáo và quảng cáo có một trong các loại trạng thái sau đây:
Để biết thông tin cơ bản, hãy xem Blog dành cho nhà phát triển quảng cáo, Đã xóa và Đã lưu trữ.
Đối tượng quảng cáo đang hoạt động có thể có trạng thái sau đây:
ACTIVE
PAUSED
PENDING_REVIEW
CREDIT_CARD_NEEDED
PREAPPROVED
DISABLED
PENDING_PROCESS
WITH_ISSUES
Đặt đối tượng quảng cáo thành ARCHIVED
bằng cách đặt trường status
thành ARCHIVED
. Khi trạng thái đối tượng được đặt thành ARCHIVED
, bạn có thể tiếp tục truy vấn thông tin chi tiết và số liệu thống kê dựa trên ID đối tượng. Tuy nhiên, sẽ có giới hạn tối đa đối với số lượng đối tượng mà bạn có thể lưu trữ. Vì vậy, bạn nên tuân thủ giới hạn này và thay đổi trạng thái thành DELETED
khi không cần một đối tượng nữa.
Đối tượng ARCHIVED
chỉ có 2 trường mà bạn có thể thay đổi: name
và status
. Bạn cũng chỉ có thể thay đổi status
thành DELETED
.
Đặt đối tượng quảng cáo thành DELETED
bằng cách đặt trường status
thành DELETED
hoặc gửi HTTP DELETE
đến đối tượng đó. Sau khi đặt trạng thái đối tượng thành DELETED
, bạn sẽ không thể đặt lại về ARCHIVED
.
Nếu giữ lại ID đối tượng đã xóa, bạn có thể tiếp tục truy xuất số liệu thống kê hoặc thông tin chi tiết đối tượng bằng cách truy vấn ID đối tượng đó. Tuy nhiên, bạn không thể truy xuất đối tượng đã xóa như đối tượng kết nối từ nút hoặc đối tượng không xóa. Ví dụ: <API_VERSION>/<AD_ID>/insights
có hiệu quả với đối tượng đã xóa nhưng <API_VERSION>/act_<AD_ACCOUNT_ID>/insights?level=ad
không trả về số liệu thống kê cho đối tượng đã xóa đó.
Sau khi bạn xóa một quảng cáo, quảng cáo đó có thể vẫn theo dõi lượt hiển thị, lượt click và hành động trong 28 ngày sau ngày phân phối gần đây nhất. Bạn có thể truy vấn thông tin chi tiết về đối tượng DELETED
bằng cách sử dụng bộ lọc ad.effective_status
.
Nếu nhóm quảng cáo có 2 quảng cáo và bạn xóa một quảng cáo thì 2 truy vấn sau đây sẽ không trả về cùng kết quả:
https://graph.facebook.com/v21.0
/<AD_SET_ID>/insights https://graph.facebook.com/v21.0
/<AD_ID>/insights
Nhóm quảng cáo trả về số liệu thống kê cho cả quảng cáo đã xóa và không xóa. Tuy nhiên, khi truy vấn quảng cáo trong nhóm quảng cáo đó, bạn sẽ chỉ thấy một quảng cáo:
https://graph.facebook.com/v21.0
/<AD_SET_ID>/ads
Để tránh tình huống này, bạn nên xóa quảng cáo sau 28 ngày kể từ ngày phân phối gần đây nhất để đảm bảo số liệu thống kê không thay đổi nữa. Ngoài ra, bạn cũng nên lưu trữ số liệu thống kê hoặc ID của các đối tượng đó trong hệ thống của chính mình trước khi xóa đi. Đề xuất này không bắt buộc:
Bạn không thể thay đổi bất cứ trường nào - ngoại trừ name
- đối với đối tượng DELETED
.
Sau đây là cách bạn thường quản lý trạng thái đối tượng:
deleted
để giảm giới hạn này.Trạng thái của đối tượng quảng cáo hoạt động theo cách này để phân cấp đối tượng quảng cáo:
with_issues
, paused
, archived
hoặc deleted
cho một chiến dịch, tất cả đối tượng thuộc chiến dịch đó sẽ tự động kế thừa trạng thái đó. deleted
, bạn sẽ không thể truy xuất nhóm quảng cáo hoặc quảng cáo thuộc chiến dịch đó mà không chỉ định rõ ID.with_issues
, paused
, archived
hoặc deleted
, nhóm quảng cáo hoặc chiến dịch quảng cáo chứa quảng cáo đó sẽ giữ nguyên trạng thái ban đầu và có thể truy xuất được.Các giới hạn sau đây áp dụng với đối tượng ARCHIVED
của tài khoản quảng cáo đã cho:
Nếu đọc cạnh archived
, bạn phải lọc cụ thể các đối tượng đã lưu trữ vì chúng tôi không trả về các đối tượng này theo mặc định. Nếu bạn đọc số liệu thống kê về đối tượng quảng cáo, chúng tôi sẽ bao gồm số liệu thống kê của mọi đối tượng con, bất kể đối tượng con đó ở trạng thái active
, archived
hay deleted
. Do vậy, bạn không cần lọc thông tin chi tiết về đối tượng con.
Những đối tượng có trạng thái như ACTIVE
, PAUSED
khác với những đối tượng có trạng thái ARCHIVED
và DELETED
. Sau đây là các điểm khác biệt chính.
Truy vấn | Đang hoạt động | ĐÃ LƯU TRỮ | ĐÃ XÓA |
---|---|---|---|
Tồn tại trong cơ sở dữ liệu | Có | Có | Có |
Số lượng tối đa trên mỗi tài khoản quảng cáo | 100.000 | Không có giới hạn | |
Truy vấn dưới dạng cạnh không có bộ lọc | Có | Không | Không |
Truy vấn dưới dạng cạnh có bộ lọc trạng thái | Có đối với các đối tượng có trạng thái nằm trong bộ lọc này | Có nếu bộ lọc trạng thái chứa | Không nếu bộ lọc trạng thái không chứa |
Truy vấn theo ID riêng | Có | Có | Có |
Số liệu thống kê được tổng hợp trong | Có | Có | Có |
Số liệu thống kê được bao gồm trong danh sách kết quả của | Có | Không | Không |
Số liệu thống kê được bao gồm trong danh sách kết quả của | Có đối với các đối tượng có trạng thái nằm trong bộ lọc này | Có đối với các đối tượng có trạng thái nằm trong bộ lọc này | Không |
Thông tin chi tiết được hiển thị với | Có | Có | Có |
Có thể thay đổi trạng thái thành | Bất kỳ trạng thái nào hợp lệ |
| Không thể thay đổi |
Cách đặt quảng cáo thành đã lưu trữ:
use FacebookAds\Object\Ad;
$ad = new Ad(<AD_ID>);
$ad->archive();
from facebookads.adobjects.ad import Ad
ad = Ad(ad_id)
ad.remote_archive()
new Ad(<AD_ID>, context).update()
.setStatus(Ad.EnumStatus.VALUE_ARCHIVED)
.execute();
curl \
-F 'status=ARCHIVED' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/<AD_ID>
Cách xóa quảng cáo:
use FacebookAds\Object\Ad;
$ad = new Ad(<AD_ID>);
$ad->deleteSelf();
from facebookads.adobjects.ad import Ad
ad = Ad(<AD_ID>)
ad.remote_delete()
new Ad(<AD_ID>, context).update()
.setStatus(Ad.EnumStatus.VALUE_DELETED)
.execute();
curl -X DELETE \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/<AD_ID>/
Cách truy xuất các đối tượng con đang hoạt động của một đối tượng đang hoạt động - chẳng hạn như tất cả quảng cáo đang hoạt động của một chiến dịch quảng cáo - không bao gồm quảng cáo ARCHIVED
hoặc DELETED
:
curl -X GET \
-d 'fields="name"' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>/ads
Cách truy xuất đối tượng con ARCHIVED
của một đối tượng đang hoạt động - chẳng hạn như tất cả quảng cáo ARCHIVED
của một nhóm quảng cáo - yêu cầu bộ lọc trạng thái:
curl -X GET \
-d 'effective_status=[
"ARCHIVED"
]' \
-d 'fields="name"' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>/ads