Phiên bản API Tiếp thị

Kiểm tra tình trạng phân phối quảng cáo

Chủ đề liên quan

Kiểm tra tình trạng phân phối là loạt kiểm tra có thể giúp tìm ra các vấn đề tiềm ẩn liên quan đến việc phân phối quảng cáo.

Chạy và đọc

Để chạy quá trình kiểm tra tình trạng phân phối quảng cáo và lấy kết quả kiểm tra không đạt, hãy đọc trường failed_delivery_checks của quảng cáo. Ví dụ: chạy quá trình kiểm tra tình trạng phân phối cho quảng cáo 6014290603725:

curl -G \
  -d 'fields=failed_delivery_checks' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>

Nếu mọi quá trình kiểm tra đều đạt thì trường failed_delivery_checks sẽ không xuất hiện trong phản hồi.

Ví dụ: phản hồi cho một quảng cáo có quá trình kiểm tra invalid_custom_audiences không đạt sẽ có dạng sau:

{
 "failed_delivery_checks": [
    {
      "summary": "Custom Audience No Longer Shared", 
      "description": "This ad uses a custom audience that's no longer being shared with you. Please contact the person who set up the audience for more information.", 
      "check_name": "invalid_custom_audiences", 
    }
  ], 
  "id": "6014290603725"
}

Trường failed_delivery_checks là một mảng JSON chứa các đối tượng JSON của quá trình kiểm tra không đạt. Mỗi quá trình kiểm tra không đạt có các trường sau:

Tên Mô tả Loại

check_name

Tên của quá trình kiểm tra không đạt (Xem phần Các loại kiểm tra tình trạng phân phối)

Chuỗi

tóm tắt

Mô tả dài một dòng về lỗi

Chuỗi

mô tả

Giải thích chi tiết hơn về lỗi

Chuỗi

Các loại kiểm tra tình trạng phân phối

Kiểm tra tình trạng phân phối quảng cáo bao gồm các loại sau:

check_name Lý do xảy ra lỗi

page_status

Trang chưa đăng - Quảng cáo này không thể phân phối vì trang mà quảng cáo nhắm mục tiêu chưa được đăng.

mobile_eligible

Không đủ điều kiện cho thiết bị di động - Quảng cáo này sẽ không phân phối đến người dùng thiết bị di động.

blocked_url

URL trong danh sách chặn - Quảng cáo này chuyển hướng đến một URL đáng ngờ.

invalid_custom_audiences

Một trong các trường hợp sau:
1. Đối tượng tùy chỉnh không được chia sẻ nữa - Quảng cáo này sử dụng đối tượng tùy chỉnh không được chia sẻ với bạn nữa. Vui lòng liên hệ với người đã thiết lập đối tượng để biết thêm thông tin. Nếu tài khoản không còn quyền truy cập vào một số đối tượng mà quảng cáo sử dụng, quảng cáo sẽ không thể phân phối.
2. Xung đột về liên kết chọn không tham gia của đối tượng tùy chỉnh - Quảng cáo này sử dụng các đối tượng khác nhau có liên kết chọn không tham gia khác nhau. Bạn chỉ có thể sử dụng các đối tượng tùy chỉnh khác nhau trên cùng một quảng cáo nếu các đối tượng đó không sử dụng liên kết xung đột.
3. Quảng cáo sử dụng đối tượng tùy chỉnh đã xóa - Quảng cáo này sử dụng đối tượng tùy chỉnh đã bị bạn hoặc người thiết lập xóa. Một quảng cáo sử dụng đối tượng tùy chỉnh đã xóa không thể phân phối được.
4. Lỗi đối tượng tùy chỉnh - Đã xảy ra sự cố với đối tượng tùy chỉnh liên kết với quảng cáo này. Chúng tôi đang nỗ lực khắc phục sự cố này. Vui lòng thử lại sau.

logged_out_ads

Một trong các trường hợp sau:
1. Chỉ cho phép các quảng cáo bài viết trên Trang đối với quảng cáo đã đăng xuất.
2. Tin dùng cho quảng cáo đã đăng xuất là tin không công khai.