خيارات مواصفات قائمة بيانات الأصول

يمكنك استخدام الخيارات التالية في asset_feed_spec. راجع مواصفات قائمة بيانات أصول الإعلانات لمزيد من معلومات المرجعية.

اسم الخاصية الوصف

اسم الخاصية	الوصف
`images` النوع: array of list (مصفوفة قوائم)	مطلوب لتنسيق `SINGLE_IMAGE` و`CAROUSEL_IMAGE`. مصفوفة صور مؤهلة. يجب تضمين الصور المتوفرة في هذه المصفوفة في مكتبة الصور للحساب الإعلاني. يمكنك توفير هذا الحقل كمصفوفة قوائم تتضمن `{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}`. مطلوب إما `url` أو `hash`.
`videos` النوع: array of list (مصفوفة قوائم)	مطلوب لتنسيق `SINGLE_VIDEO`. مصفوفة من `video_id`. يجب أن تنتمي `video_id` المتوفرة في هذه المصفوفة إلى الحساب الإعلاني. يمكنك توفير هذا الحقل كمصفوفة قوائم تتضمن `{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}`
`carousels` النوع: array of list (مصفوفة قوائم)	اختياري. مصفوفة من `child_attachments` مع القيم المنطقية `multi_share_end_card` و`multi_share_optimized`، و`adlabels`. يجب أن تنتمي `child_attachments` المتوفرة في هذه المصفوفة إلى الحساب الإعلاني. يمكنك توفير `child_attachments` كمصفوفة قوائم تحتوي على `{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}`. مطلوب إما `image_label` أو `video_label`.
`bodies` النوع: array of list (مصفوفة قوائم)	اختياري. مصفوفة من النصوص الأساسية. الرسالة الرئيسية أو نسخة من الإعلان. يمكنك توفير هذا الحقل كمصفوفة قوائم من `{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}`.
`call_to_action_types` النوع: array of list (مصفوفة قوائم)	مطلوب لكل الأهداف، باستثناء `OUTCOME_AWARENESS`. مصفوفة من قيم أنواع الدعوة لاتخاذ إجراء. يمكنك توفير هذا الحقل كمصفوفة قوائم من `{"{CALL_TO_ACTION}"}`. يمكنك توفير قيم متعددة، ما يصل إلى خمس قيم.
`titles` النوع: array of list (مصفوفة قوائم)	اختياري. مصفوفة من العناوين. العنوان هو عنوان قصير في الإعلان يظهر غالبًا بجوار رابط أو صورة أو فيديو. يمكنك توفير هذا الحقل كمصفوفة قوائم من `{"text": "{TITLE}", "url_tags": "{TAG}"}`.
`descriptions` النوع: array of list (مصفوفة قوائم)	اختياري. مصفوفة من النص الوصفي الثانوي الأقل ظهورًا مقارنة بالعناوين أو النصوص الأساسية. يظهر بشكل عام بجوار رابط أو صورة أو فيديو. إذا لم يتم التحديد، فسيستخلص فيسبوك البيانات من الرابط المتوفر لإنشائه. استخدم سلسلة فارغة بمسافة واحدة للوصف الفارغ، إذا كنت لا تريد استخدام النص المستخلص. يمكنك توفير هذا الحقل كمصفوفة قوائم من `{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}`.
`link_urls` النوع: array of list (مصفوفة قوائم)	مطلوب. مصفوفة من عناوين URL للروابط. يمكنك توفير هذا الحقل كمصفوفة قوائم من `{"website_url": "{URL}"}`.
`ad_formats` النوع: array of strings (مصفوفة السلاسل)	مطلوب. مصفوفة من تنسيقات إعلانية لفيسبوك التي يجب إنشاء الإعلانات فيها. التنسيقات المدعومة هي: `SINGLE_IMAGE` و`CAROUSEL` و`SINGLE_VIDEO` و`AUTOMATIC_FORMAT`. يمكنك توفير هذا الحقل كمصفوفة سلاسل من `["{AD_FORMAT}"]`.
`optimization_type` النوع: string (سلسلة)	اختياري. نوع التحسين المستخدم في قائمة بيانات الأصول. القيم المحتملة هي `ASSET_CUSTOMIZATION` و`LANGUAGE` و`PLACEMENT` و`REGULAR`.
`message_extensions` النوع: array of strings (مصفوفة السلاسل)	اختياري. نوع امتداد الرسائل المستخدم في قائمة بيانات الأصول. القيمة المحتملة: `whatsapp`
`onsite_destinations` النوع: array of list (مصفوفة قوائم)	مطلوب لإعلانات المتاجر. صالح للإعلانات الثابتة؛ التنسيق `SINGLE_IMAGE` أو `SINGLE_VIDEO` أو `CAROUSEL`. يمكنك توفير هذا الحقل كمصفوفة قوائم تحتوي على إحدى القيم التالية لتحديد الوجهة المقصودة للمتجر داخل الموقع. {"storefront_shop_id": "<SHOP_STOREFRONT_ID>"} or {"shop_collection_product_set_id": "<PRODUCT_SET_ID>" or {"details_page_product_id": "<PRODUCT_ID>"}
`shops_bundle` النوع: boolean (قيمة منطقية)	مطلوب لإعلانات المتاجر. صالح لإعلانات كتالوج Advantage+. يمكنك توفير هذا الحقل لتحسين المتجر. تتضمن كل من نوعي تحسين المتجر `reasons_to_shop` و`automated_product_tags`. القيم المحتملة: `true` و`false`
`reasons_to_shop` النوع: boolean (قيمة منطقية)	مطلوب لإعلانات المتاجر. صالح لإعلانات كتالوج Advantage+. يمكنك توفير هذا الحقل لتحسين المتجر. يميز معلومات المنتج تلقائيًا من المتجر، مثل "شحن مجاني" أو "رائج" أو "مخزون منخفض". القيم المحتملة: `true` و`false`

images

النوع: array of list (مصفوفة قوائم)

مطلوب لتنسيق SINGLE_IMAGE وCAROUSEL_IMAGE.

مصفوفة صور مؤهلة. يجب تضمين الصور المتوفرة في هذه المصفوفة في مكتبة الصور للحساب الإعلاني.

يمكنك توفير هذا الحقل كمصفوفة قوائم تتضمن {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}. مطلوب إما url أو hash.

videos

النوع: array of list (مصفوفة قوائم)

مطلوب لتنسيق SINGLE_VIDEO.

مصفوفة من video_id. يجب أن تنتمي video_id المتوفرة في هذه المصفوفة إلى الحساب الإعلاني.

يمكنك توفير هذا الحقل كمصفوفة قوائم تتضمن {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}

carousels
النوع: array of list (مصفوفة قوائم)

اختياري.
مصفوفة من child_attachments مع القيم المنطقية multi_share_end_card وmulti_share_optimized، وadlabels. يجب أن تنتمي child_attachments المتوفرة في هذه المصفوفة إلى الحساب الإعلاني.

يمكنك توفير child_attachments كمصفوفة قوائم تحتوي على {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}. مطلوب إما image_label أو video_label.

bodies

النوع: array of list (مصفوفة قوائم)

اختياري.

مصفوفة من النصوص الأساسية. الرسالة الرئيسية أو نسخة من الإعلان.

يمكنك توفير هذا الحقل كمصفوفة قوائم من {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}.

call_to_action_types

النوع: array of list (مصفوفة قوائم)

مطلوب لكل الأهداف، باستثناء OUTCOME_AWARENESS.

مصفوفة من قيم أنواع الدعوة لاتخاذ إجراء.

يمكنك توفير هذا الحقل كمصفوفة قوائم من {"{CALL_TO_ACTION}"}. يمكنك توفير قيم متعددة، ما يصل إلى خمس قيم.

titles

النوع: array of list (مصفوفة قوائم)

اختياري.

مصفوفة من العناوين. العنوان هو عنوان قصير في الإعلان يظهر غالبًا بجوار رابط أو صورة أو فيديو.

يمكنك توفير هذا الحقل كمصفوفة قوائم من {"text": "{TITLE}", "url_tags": "{TAG}"}.

descriptions

النوع: array of list (مصفوفة قوائم)

اختياري.

مصفوفة من النص الوصفي الثانوي الأقل ظهورًا مقارنة بالعناوين أو النصوص الأساسية. يظهر بشكل عام بجوار رابط أو صورة أو فيديو. إذا لم يتم التحديد، فسيستخلص فيسبوك البيانات من الرابط المتوفر لإنشائه. استخدم سلسلة فارغة بمسافة واحدة للوصف الفارغ، إذا كنت لا تريد استخدام النص المستخلص.

يمكنك توفير هذا الحقل كمصفوفة قوائم من {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}.

link_urls

النوع: array of list (مصفوفة قوائم)

مطلوب.

مصفوفة من عناوين URL للروابط.

يمكنك توفير هذا الحقل كمصفوفة قوائم من {"website_url": "{URL}"}.

ad_formats

النوع: array of strings (مصفوفة السلاسل)

مطلوب.

مصفوفة من تنسيقات إعلانية لفيسبوك التي يجب إنشاء الإعلانات فيها. التنسيقات المدعومة هي: SINGLE_IMAGE وCAROUSEL وSINGLE_VIDEO وAUTOMATIC_FORMAT.

يمكنك توفير هذا الحقل كمصفوفة سلاسل من ["{AD_FORMAT}"].

optimization_type

النوع: string (سلسلة)

اختياري.

نوع التحسين المستخدم في قائمة بيانات الأصول. القيم المحتملة هي ASSET_CUSTOMIZATION وLANGUAGE وPLACEMENT وREGULAR.

message_extensions

النوع: array of strings (مصفوفة السلاسل)

اختياري.
نوع امتداد الرسائل المستخدم في قائمة بيانات الأصول.

القيمة المحتملة: whatsapp

onsite_destinations
النوع: array of list (مصفوفة قوائم)

مطلوب لإعلانات المتاجر. صالح للإعلانات الثابتة؛ التنسيق SINGLE_IMAGE أو SINGLE_VIDEO أو CAROUSEL.
يمكنك توفير هذا الحقل كمصفوفة قوائم تحتوي على إحدى القيم التالية لتحديد الوجهة المقصودة للمتجر داخل الموقع.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
النوع: boolean (قيمة منطقية)

مطلوب لإعلانات المتاجر. صالح لإعلانات كتالوج Advantage+.
يمكنك توفير هذا الحقل لتحسين المتجر. تتضمن كل من نوعي تحسين المتجر reasons_to_shop وautomated_product_tags.
القيم المحتملة: true وfalse

reasons_to_shop
النوع: boolean (قيمة منطقية)

مطلوب لإعلانات المتاجر. صالح لإعلانات كتالوج Advantage+.
يمكنك توفير هذا الحقل لتحسين المتجر. يميز معلومات المنتج تلقائيًا من المتجر، مثل "شحن مجاني" أو "رائج" أو "مخزون منخفض".
القيم المحتملة: true وfalse

تقييدات مواصفات قائمة بيانات الأصول

التنسيقات الإعلانية

ad_formats المدعومة: SINGLE_IMAGE وCAROUSEL وSINGLE_VIDEO وAUTOMATIC_FORMAT.
مسموح بتنسيق ad_format واحد فقط لكل قائمة بيانات أصول.
يتم احتساب ad_format كأصل واحد في قائمة بيانات الأصول.

عدد الأصول:

إجمالي 30 أصل كحد أقصى. على سبيل المثال، لديك 28 أصل مع 10 images و5 bodies و5 titles و5 description و1 ad_format و1 link_url و1 call_to_action_types.
إجمالي عدد الصور: <= 10.
إجمالي عدد مقاطع الفيديو: <= 10. إذا استخدمت Instagram كموضع، فلن يتم السماح إلا بمقاطع الفيديو المربعة أو الأفقية.
إجمالي عدد النصوص الأساسية: <= 5.
إجمالي عدد الدعوات لاتخاذ إجراء: <= 5.
إجمالي عدد العناوين: <= 5.
إجمالي عدد الروابط: <= 5.
إجمالي عدد الأوصاف: <= 5.

متطلبات الصورة:

مواصفات الصورة الموصى بها: 1.9:1.
حجم الصورة الموصى به: 1200 × 628 بيكسل.
بالنسبة إلى تنسيق CAROUSEL_IMAGE، يجب توفير صورتين على الأقل.
إذا استخدمت Instagram كموضع، فاستخدم الصور المربعة للحصول على أداء أفضل.

متطلبات النص:

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

url_tags اختيارية وتتوفر فقط لـ images وvideos وbodies وdescriptions وtitles. يلحق فيسبوك url_tags بعنوان URL الرابط كمعلمات لكل أصل في إعلان.

على سبيل المثال، يكون إعداد مجموعة قائمة بيانات الأصول الصالح لتنسيق SINGLE_IMAGE هو:

5 images
3 bodies
3 titles
3 descriptions
تنسيق واحد: SINGLE_IMAGE
2 link_urls

"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

استخدام الروابط لموضع معين

يمكنك استخدام الروابط لموضع معين في مواصفات قائمة بيانات الأصول للحملات الإعلانية بالأهداف التالية:

APP_INSTALLS
CONVERSIONS
LINK_CLICKS

أضف deeplink_url في link_urls عند إنشاء asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

إعلانات التوجيه من موقع الويب إلى واتساب

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

أضف message_extensions عند إنشاء asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives