画像のトリミング

各所の広告配置に使用する画像のアスペクト比を指定します。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] ]}