Tài liệu tham khảo

Đăng

Điểm cuốiMô tả

/{ad-account-id}/ads

Tạo quảng cáo.

/{business-id}/initiated_sharing_agreements

Phê duyệt hoặc từ chối yêu cầu thỏa thuận kinh doanh đang chờ xử lý.

/{business-creative-folder-id}

Tạo và cập nhật thư mục nội dung của doanh nghiệp.

/{business-id}/creative_folders

Cung cấp thư mục nội dung của doanh nghiệp.

/{business-id}/images

Tải hình ảnh lên thư mục nội dung.

/{business-id}/videos

Tải video lên thư mục nội dung.

/{business-creative-folder-id}/agencies

Thêm đối tác vào thư mục nội dung.

/{business-creative-folder-id}/assigned_users

Lấy danh sách những người có quyền truy cập vào thư mục nội dung của doanh nghiệp.

Đọc

Điểm cuốiMô tả

/{business-creative-folder-id}

Lấy thông tin chi tiết về thư mục nội dung của doanh nghiệp.

/{business-id}/creative_folders

Lấy danh sách các thư mục nội dung của doanh nghiệp mà một doanh nghiệp có thể truy cập.

/{business-id}/creatives

Lấy hình ảnh và video của doanh nghiệp.

/{business-id}/initiated_sharing_agreement

Lấy danh sách các yêu cầu thỏa thuận đang chờ xử lý.


Chúng tôi đã ra mắt lại điểm cuối này vào tháng 05/2020. Trước đây, chúng tôi đã ngừng sử dụng /initiated_sharing_agreement khi ra mắt API Đồ thị v6.0.

/{business-image-id}

Lấy thông tin chi tiết về hình ảnh.

/{business-image-id}/insights

Lấy thông tin chi tiết về hình ảnh được chia sẻ.

/{business-video-id}

Lấy thông tin chi tiết về video được chia sẻ.

/{business-video-id}/insights

Lấy thông tin chi tiết về video được chia sẻ.

/{business-creative-folder-id}/agencies

Lấy danh sách các doanh nghiệp có quyền truy cập vào thư mục nội dung của bạn.

/{business-creative-folder-id}/assigned_users

Lấy danh sách những người có quyền truy cập vào thư mục nội dung của bạn.

Xóa

Điểm cuốiMô tả
/{business-creative-folder-id}

Xóa thư mục nội dung.

/{business-creative-folder-id}/agencies

Xóa đối tác khỏi thư mục nội dung.

/{business-creative-folder-id}/assigned_users

Xóa người dùng khỏi thư mục nội dung.

/{business-image-id}

Gỡ hình ảnh được chia sẻ.

/{business-video-id}

Gỡ video được chia sẻ.

Tác vụ được phép thực hiện

Tác vụ người dùng doanh nghiệp được phép thực hiệnMô tả

CREATE_CONTENT

Người dùng này có thể tạo thư mục.

MANAGE_CONTENT

Người dùng này có thể quản lý tài sản trong thư mục nội dung.

MANAGE_PERMISSIONS

Người dùng này có thể quản lý quyền đối với thư mục nội dung của doanh nghiệp.

VIEW_CONTENT

Người dùng này có thể xem tài sản trong thư mục nội dung.

VIEW_INSIGHTS

Người dùng này có thể xem thông tin chi tiết về tài sản nội dung.

Thông tin chi tiết

Sau đây là các số liệu đang trong quá trình phát triển.

Tên số liệuMô tả
impressions

Số lần hình ảnh hoặc video của bạn xuất hiện trong quảng cáo.

inline_link_clicks

Số lượt click vào liên kết trong quảng cáo của bạn. Số lượt click trực tiếp vào liên kết sẽ dựa trên khoảng thời gian phân bổ lượt click cố định trong 1 ngày.

video_play_actions

Số lần video của bạn bắt đầu phát. Chúng tôi tính số liệu này cho mỗi lượt hiển thị video và không tính lượt phát lại.

actions

Tổng số hành động mọi người thực hiện được ghi nhận cho quảng cáo của bạn. Hành động có thể bao gồm tương tác, click hoặc chuyển đổi. Hãy xem danh sách đầy đủ các loại hành động được hỗ trợ trong tài liệu này.

video_thruplay_watched_actions

Số lần video của bạn phát hết hoặc phát tối thiểu 15 giây.

quality_ranking

Xếp hạng chất lượng của quảng cáo theo cảm nhận của người xem. Chất lượng được đo lường dựa trên ý kiến đóng góp về quảng cáo và trải nghiệm sau khi click vào quảng cáo. Quảng cáo được xếp hạng với các quảng cáo khác cạnh tranh để thu hút cùng một đối tượng.


Giá trị có thể sử dụng bao gồm:

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN, nếu không có đủ thông tin về quảng cáo.

Số liệu này liên quan đến dữ liệu chẩn đoán mức độ phù hợp của quảng cáo.

Sau đây là các số liệu chia nhỏ mà bạn có thể sử dụng:

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal