اقتصاصات الصورة

يمكنك توفير نسب العرض إلى الارتفاع للصور في مواضع إعلانات مختلفة. يعمل فيسبوك على اقتصاص الصورة وفقًا للمواصفات الموضحة أو إذا لم توفر أي اقتصاص فسنقوم بعرضها باستخدام الإعدادات الافتراضية. راجع صورة الإعلان. على سبيل المثال، يمكنك تحميل الصورة لاستخدامها في تصميم الإعلان:

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) ضمن الصورة. يكون المستطيل الممتد خارج حدود الصورة غير صالح.
• يجب أن يكون للمستطيل نسبة العرض إلى الارتفاع ذاتها مثل الموضحة بواسطة مفتاح الاقتصاص.
• لا يمكن للإحداثيات أن تحتوي على قيم سلبية.
• لا تدعم Facebook Stories اقتصاصات الصور.

على سبيل المثال:

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