API Marketing

Ritagli delle immagini

Fornisci le proporzioni delle immagini nei vari posizionamenti dell'inserzione. Facebook ritaglia l'immagine in base alle specifiche fornite o, se non fornisci un'immagine ritagliata, la visualizziamo utilizzando i valori predefiniti. Vedi Immagine dell'inserzione. Ad esempio, carica un'immagine da utilizzare nella creatività dell'inserzione:

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

Quindi, fornisci la creatività dell'inserzione facendo riferimento all'hash dell'immagine restituito nella chiamata precedente insieme al ritaglio.

I ritagli contengono coppie chiave-valore, dove la chiave è una crop key e il valore contiene le dimensioni in pixel del ritaglio. Per tutte le chiavi supportate, consulta il riferimento Ritagli delle immagini delle inserzioni.

Indica il valore come coordinate (x, y) per gli angoli in alto a sinistra e in basso a destra del rettangolo di ritaglio. crop key indica le proporzioni. Le proporzioni della casella specifica per larghezza e altezza deve essere il più vicino possibile alle proporzioni in crop key.

L'origine dell'immagine (0, 0) è nell'angolo in alto a sinistra. Il punto, (width - 1, height - 1), è nell'angolo in basso a destra.

Specifica

Quando usi questa funzione, devi usarla per tutti i posizionamenti in cui potrebbe essere visualizzata un'inserzione. Ad esempio, se la fornisci per la colonna di destra e desideri utilizzare l'inserzione anche nella sezione Notizie, dovrai fornire il ritaglio per il posizionamento nella sezione Notizie.

Limitazioni

I ritagli dell'immagine sono supportati solo per creatività dell'inserzione con image_file o image_hash. Page posts non sono supportati. I valori devono rispettare i seguenti limiti:

  • I punti specificati da (x, y) devono trovarsi all'interno dell'immagine. Un rettangolo che si estende oltre i limiti dell'immagine non è valido.
  • Il rettangolo deve avere le stesse proporzioni specificate dalla crop key.
  • Le coordinate non possono contenere valori negativi.
  • Le Facebook Stories non supportano i ritagli delle immagini.

Ad esempio:

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