Marketing API

Обрезка изображений

Эта функция позволяет получить нужные соотношения сторон изображений для разных мест размещения рекламы. При обрезке Facebook следует вашим спецификациям. Если вы их не предоставили, используются значения по умолчанию. См. справку по изображениям для рекламы. Сначала загрузите изображение, которое вы хотите использовать в рекламном креативе:

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

Затем добавьте рекламный креатив, указав хэш изображения, полученный в результате предыдущего вызова, и спецификации обрезки.

Спецификации обрезки содержат пары "ключ-значение", в которых ключ — это crop key, а значение — размеры обрезки в пикселях. Все поддерживаемые ключи приведены здесь.

Укажите значения в виде координат (x, y) для левого верхнего и правого нижнего углов прямоугольника обрезки. Параметр crop key описывает соотношение сторон. Соотношение сторон прямоугольника с указанной шириной и высотой должно быть как можно ближе к соотношению сторон в crop key.

Исходные координаты (0, 0) для изображения находятся в левом верхнем углу. Точка (width - 1, height - 1) находится в правом нижнем углу.

Требования

Если вы решили использовать эту функцию, это необходимо сделать для всех мест размещения, где может появиться ваша реклама. Например, если вы добавили спецификации обрезки для правого столбца, но реклама также может появиться в Ленте новостей, укажите спецификации и для Ленты новостей.

Ограничения

Обрезка изображений поддерживается только в рекламных креативах с image_file или image_hash. Page posts не поддерживаются. Действуют следующие ограничения:

  • Точки, заданные в виде (x, y), должны лежать внутри изображения. Нельзя задавать координаты прямоугольника таким образом, чтобы он выходил за пределы изображения.
  • Соотношение сторон прямоугольника должно соответствовать соотношению сторон, указанному в параметре crop key.
  • Для координат нельзя использовать отрицательные значения.
  • Обрезка изображений не поддерживается в историях на Facebook.

Пример:

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