API Marketing

Nhắm mục tiêu chi tiết

Với tính năng Tìm kiếm nhắm mục tiêu, bạn có thể tìm thấy tùy chọn nhắm mục tiêu bằng một cách nhắm mục tiêu trong một lệnh gọi API duy nhất. Với API Nhắm mục tiêu chi tiết, bạn có thể tìm kiếm cùng lúc nhiều cách nhắm mục tiêu trong một yêu cầu duy nhất. Bạn cũng có thể nhận được gợi ý dựa trên truy vấn của mình.

API này có 4 điểm cuối, đó là: Tìm kiếm, Gợi ý, Lướt xem và Xác thực.

Phản hồi cho những điểm cuối này chứa thông tin sau đây:

Tên Mô tả

id

loại: string

ID đối tượng mục tiêu

name

loại: string

Tên đối tượng mục tiêu

audience_size_lower_bound

integer

Giới hạn dưới về quy mô đối tượng mục tiêu ước tính

audience_size_upper_bound

integer

Giới hạn trên về quy mô đối tượng mục tiêu ước tính

path

loại: mảng string

Bao gồm hạng mục và bất kỳ hạng mục chính nào chứa tùy chọn nhắm mục tiêu

description

loại: string

Nội dung mô tả ngắn về đối tượng mục tiêu

Nếu bạn không cung cấp limit_type, chúng tôi sẽ lọc các kết quả có dưới 2.000 người thành 4 hạng mục: work_employers, work_positions, education_majors, education_schools. Nếu không, bạn sẽ nhận được kết quả kém ý nghĩa hơn. Khi bạn sử dụng limit_type, chúng tôi sẽ lọc cho một trong 4 hạng mục đó và sẽ không trả về tất cả thông tin.

Truy xuất đối tượng mục tiêu khớp với truy vấn tìm kiếm cho quảng cáo của bạn. Bạn có thể cung cấp các thông số sau đây tại điểm cuối này:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
Tên Mô tả

q

loại: string

Bắt buộc.

Chuỗi truy vấn

limit

loại: integer

Không bắt buộc.

Số lượng kết quả

limit_type

loại: string

Không bắt buộc.

Giới hạn loại đối tượng cần truy xuất. Mặc định là tất cả các loại.

Giá trị hợp lệ:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

loại: string

Không bắt buộc.

Ngôn ngữ để hiển thị tên và nội dung mô tả đối tượng, nếu có. Mặc định là ngôn ngữ của tài khoản quảng cáo

Gợi ý

Trả về các đối tượng khác mà bạn có thể nhắm mục tiêu dựa trên một số đối tượng đã chọn mà bạn cung cấp.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Hãy cung cấp các thông số sau đây:

Tên Mô tả

targeting_list

loại: Mảng {'type':'{TYPE}', 'id':{ID}}

Bắt buộc.

Mảng các cặp {'type':'{TYPE}', 'id':{ID}} đóng vai trò là đối tượng đầu vào cho gợi ý.

limit

loại: integer

Không bắt buộc.

Số lượng kết quả. Mặc định là 30. Tối đa là 45.

limit_type

loại: string

Không bắt buộc.

Giới hạn loại đối tượng cần truy xuất. Mặc định là tất cả các loại

Giá trị hợp lệ:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

loại: string

Không bắt buộc.

Ngôn ngữ để hiển thị tên và nội dung mô tả đối tượng. Mặc định là ngôn ngữ của tài khoản quảng cáo

Lướt xem

Lấy tùy chọn nhắm mục tiêu theo cách phân loại có cấu trúc cho hạng mục trên Facebook, nhà cung cấp dữ liệu bên thứ ba và một số sở thích. Kết quả mà điểm cuối này trả về sẽ xuất hiện ở chức năng Lướt xem thuộc thành phần giao diện người dùng Nhắm mục tiêu chi tiết trong Trình quản lý quảng cáo.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

Hãy cung cấp các thông số không bắt buộc sau đây:

Tên Mô tả

limit_type

loại: string

Giới hạn loại đối tượng cần truy xuất. Mặc định là tất cả các loại.

locale

loại: string

Ngôn ngữ để hiển thị tên và nội dung mô tả đối tượng. Mặc định là ngôn ngữ của tài khoản quảng cáo

Xác thực

Xác minh xem đối tượng có hợp lệ để nhắm mục tiêu hay không. Việc này sẽ hữu ích nếu bạn đã tạo một nhóm quảng cáo và muốn xác minh để đảm bảo rằng quy cách nhắm mục tiêu của nhóm quảng cáo đó vẫn hợp lệ. Nếu tùy chọn nhắm mục tiêu không hợp lệ, bạn nên xóa tùy chọn đó khỏi quy cách nhắm mục tiêu.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

Ngoài các trường tiêu chuẩn trong phản hồi Nhắm mục tiêu chi tiết, điểm cuối này cũng trả về thông tin sau đây:

Tên mô tả

valid

loại: boolean

Liệu đối tượng nhắm mục tiêu có hợp lệ hay không

Sau đây là danh sách các thông số đầu vào:

Tên Mô tả

targeting_list

loại: Mảng {'type':'{TYPE}', 'id':{ID}}

Mảng các cặp {'type':'{TYPE}', 'id':{ID}} để xác thực. Ưu tiên.

id_list

loại: mảng string

Mảng ID để xác thực. Chỉ thành công nếu chúng tôi có thể xác định chính xác ID trong cơ sở dữ liệu đối tượng của mình

name_list

loại: mảng string

Mảng string để xác thực. Chỉ áp dụng cho sở thích, không phân biệt chữ hoa chữ thường

locale

loại: string

Ngôn ngữ để hiển thị tên và nội dung mô tả đối tượng. Mặc định là ngôn ngữ của tài khoản quảng cáo

Hãy cung cấp ít nhất một trong các thông số sau đây: targeting_list, id_list và name_list.