API de Marketing

Cortes de imagem

Forneça taxas de proporção para imagens em diferentes posicionamentos de anúncio. O Facebook corta sua imagem de acordo com as especificações fornecidas. Caso você não disponibilize as proporções de corte, usaremos nossos padrões para exibição. Consulte a Ad, Image. Por exemplo, carregue uma imagem para usar no criativo do anúncio:

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

Depois, forneça o criativo do anúncio referenciando o hash da imagem retornado na chamada anterior junto com o corte.

Os cortes contêm pares de chaves-valor, sendo a chave uma crop key e o valor as dimensões em pixels do corte. Para conferir todas as chaves compatíveis, consulte o artigo de referência Ads Image Crops.

Forneça um valor como coordenadas (x, y) para os cantos superior esquerdo e inferior direito do retângulo de corte. crop key descreve uma taxa de proporção. A taxa de proporção da caixa especificada pela largura e altura deve ser o mais próximo possível da proporção em crop key.

A origem de uma imagem ((0, 0)) fica no canto superior esquerdo. O ponto, (width - 1, height - 1), fica no canto inferior direito.

Especificação

Quando usado, esse recurso deve ser aplicado a todos os posicionamentos onde um anúncio pode aparecer. Por exemplo, se você fornecer informações de proporção para a coluna da direita e quiser usar o mesmo anúncio no Feed de Notícias, será necessário informar o corte para o posicionamento do feed também.

Limitações

Os cortes de imagem funcionam apenas para criativos de anúncio com image_file ou image_hash. Page posts não são compatíveis. Os valores precisam obedecer a estas restrições:

  • Os pontos especificados por (x, y) precisam estar dentro da imagem. Um retângulo que se estende além dos limites da imagem é considerado inválido.
  • O retângulo deve ter a mesma proporção especificada pela chave de corte.
  • As coordenadas não podem conter valores negativos.
  • Os Facebook Stories não são compatíveis com cortes de imagem.

Por exemplo:

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