API Marketing

Cắt hình ảnh

Cung cấp tỷ lệ khung hình cho hình ảnh ở các vị trí quảng cáo khác nhau. Facebook sẽ cắt hình ảnh của bạn theo quy cách bạn cung cấp hoặc hiển thị hình ảnh đó theo giá trị mặc định nếu bạn không cung cấp quy cách cắt. Hãy xem bài viết Hình ảnh quảng cáo. Ví dụ: tải một hình ảnh lên để sử dụng trong nội dung quảng cáo:

curl \
  -F 'filename=@<IMAGE_PATH>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adimages

Sau đó, cung cấp nội dung quảng cáo bằng cách tham chiếu đến hash hình ảnh được trả về trong lệnh gọi trước đó kèm theo quy cách cắt.

Phần cắt sẽ chứa các cặp khóa-giá trị, trong đó khóa là crop key và giá trị là kích thước của phần cắt (tính bằng pixel). Hãy xem Tài liệu tham khảo về phần cắt hình ảnh quảng cáo để biết tất cả những khóa được hỗ trợ.

Cung cấp giá trị dưới dạng tọa độ (x, y) cho các góc trên bên trái và góc dưới cùng bên phải của hình chữ nhật cắt. crop key mô tả tỷ lệ khung hình. Tỷ lệ khung hình của ô được chỉ định theo chiều rộng và chiều cao phải gần với tỷ lệ khung hình trong crop key nhất có thể.

(0, 0) gốc của hình ảnh nằm ở góc trên bên trái. Điểm (width - 1, height - 1) nằm ở góc dưới cùng bên phải.

Quy cách

Khi sử dụng tính năng này, bạn nên dùng nó cho mọi vị trí mà quảng cáo có thể hiển thị. Ví dụ: nếu cung cấp quy cách cho Cột bên phải, đồng thời muốn sử dụng quảng cáo trong Bảng tin, bạn sẽ cần cung cấp quy cách cắt cho vị trí quảng cáo Bảng tin.

Giới hạn

Chỉ hỗ trợ cắt hình ảnh đối với nội dung quảng cáo có image_file hoặc image_hash. Không hỗ trợ Page posts. Giá trị phải tuân theo những hạn chế dưới đây:

  • Các điểm được chỉ định theo tọa độ (x, y) phải nằm trong hình ảnh. Hình chữ nhật vượt ra ngoài ranh giới của hình ảnh là không hợp lệ.
  • Hình chữ nhật phải có tỷ lệ khung hình giống như được chỉ định bằng khóa cắt.
  • Tọa độ không được chứa giá trị âm.
  • Facebook Stories không hỗ trợ cắt hình ảnh.

Ví dụ:

Example:{"100x100": [ [330, 67], [1080, 817] ]}