يحتوي تنسيق إعلان التشكيلة على تجربة فورية ويتيح للأشخاص إمكانية التعرُّف على المنتجات والخدمات من أجهزتهم المحمولة وتصفحها وشراءها بسهولة بطريقة رائعة تتميز باستخدام عناصر بصرية جاذبة للانتباه. وسيقوم إعلانك في قائمة المنتجات بتمييز ثلاثة منتجات ضمن فيديو أو صورة رئيسية تفتح في التجربة الفورية بشاشة كاملة عندما يتفاعل شخص ما مع إعلانك. ويتوفر نوعان من إعلانات التشكيلة وهما: إعلانات تستند إلى الصور وإعلانات تستند إلى الفيديو.
يجب مراعاة كل المراجع المتعلقة "باللوحة" بحيث تمثل تجربة فورية، علمًا بأن اللوحة هي الاسم السابق لهذا التنسيق.
يمكنك إنشاء إعلان بتنسيق التشكيلة عن طريق تصميم تجربة فورية. وابدأ باستخدام قالب أو اختر تخطيطك المخصص. وللمزيد من المعلومات، يمكنك الرجوع إلى مركز مساعدة الإعلانات، التجربة الفورية.
كما يمكنك تضمين واجهات مستخدم إنشاء الإعلانات في Facebook لتنسيق التشكيلة إلى موقعك على الويب باستخدام مجموعة SDK للغة JavaScript لإنشاء مربع حوار إعلانات المجموعة.
للحصول على معلومات عامة حول استخدام التشكيلات، يمكنك الرجوع:
لإنشاء تشكيلات مُستخدمة في المتاجر أو إضافة بيانات التعريف إلى مجموعة المنتجات، يمكنك الرجوع إلى المنصة التجارية، واجهة API تشكيلة المنتجات.
For API calls, your AD_ACCOUNT_ID
should be formatted as act_XXXXXXXXXXXXXXX
.
يمكنك استخدام إعلانات المجموعة بالأهداف التالية:
لتحقيق أهداف الزيارات والتحويلات، يمكنك أيضًا استخدام مقاطع فيديو بعرض الشرائح. وللحصول على مزيد من المعلومات، يمكنك الرجوع إلى مركز مساعدة الأعمال: اختيار الهدف الإعلاني المناسب.
علمًا بأن المواضع التالية مدعومة:
لمزيد من المعلومات حول المواضع، يمكنك الرجوع إلى مركز مساعدة الأعمال: حول المواضع ومركز مساعدة الأعمال: مواضع الإعلانات المتوفرة لتحقيق أهداف التسويق.
قبل إنشاء إعلان تشكيلة، عليك توفير تصميم إعلان وتجربة فورية. ويجب عليك توفير أربعة عناصر على الأقل تمثل الصور أو أربعة عناصر تمثل المنتجات التي تتضمن إشارات إلى المنتجات المطلوب عرضها بالتناوب. ويمكن أيضًا استخدام عناصر صور فرعية في عنصر إعلان دوّار.
يمكنك إنشاء إعلانات التشكيلة من الكتالوج. يتضمن إعلان التشكيلة أربعة منتجات ضمن صورة أو فيديو رئيسي، ويظهر في الموجز على الهواتف المحمولة. ويمكنك استخدام مقاطع فيديو بعرض الشرائح مع هذه الميزة.
يظهر الإعلان في الموجز ويمكن للأشخاص عرض المزيد في تجربة بوضع ملء الشاشة يتم فتحها عند الضغط على الإعلان.
لاستخدام مجموعة منتجات، يجب أن تكون على دراية بإعلانات كتالوج Advantage+ وقمت بالفعل بإعداد كتالوج منتجات. ولمزيد من المعلومات، يمكنك الرجوع إلى إعلانات كتالوج Advantage+ وإعلانات كتالوج Advantage+، كتالوج المنتجات.
عند إنشاء إعلان تشكيلة من مجموعات المنتجات، يجب أيضًا إنشاء تجربة فورية بوضوح تكون مزوّدة بعناصر مناسبة. وعندما تستخدم هذه التجربة الفورية في إعلان التشكيلة، ينشئ Facebook إعلان تشكيلة تلقائيًا. ويجب أن تحتوي التجربة الفورية الخاصة بك على ما يلي:
يمكنك إنشاء تجربة تتضمن صورة:
curl \
-F 'canvas_photo={
"photo_id": "PHOTO_ID",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
أو تنشئ تجربة فورية تحتوي على فيديو:
curl \
-F 'canvas_video={
"video_id": "VIDEO_ID",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
أو تنشئ تجربة فورية تحتوي على فيديو قالب:
curl -X POST \
-F canvas_template_video={
"name": "Cover Image or Video",
"bottom_padding": "0",
"top_padding": "0",
"product_set_id": <Product_Set_ID>,
"template_video_spec": {
"customization": {
"text_color": "FFFFFF",
"text_background_color": "000000",
"name_template": "{{product.name}}",
"body_template": "{{product.current_price strip_zeros}}"
},
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/canvas_elements
بعد ذلك، تنشئ مجموعة canvas_product_set
تحتوي على product_set_id
من كتالوج المنتجات الخاص بك. يجب عليك تعيين show_in_feed
إلى true
لإنشاء إعلان تشكيلة.
curl \
-F 'canvas_product_set={
"max_items": 50,
"product_set_id": "<PRODUCT_SET_ID>",
"item_headline": "{{product.name}}",
"item_description": "{{product.current_price}}"
"image_overlay_spec": {
"overlay_template": "pill_with_text",
"text_type": "price",
"text_font": "dynads_hybrid_bold",
"position": "top_left",
"theme_color": "background_e50900_text_ffffff",
"float_with_margin": true,
},
"storefront_setting": {
"enable_sections": true,
"customized_section_titles": [
{ "title_id": "popular", "customized_title": "My Populars" },
{ "title_id": "favorites", "customized_title": "My Favorites" }
],
"product_set_layout": {
"layout_type": "GRID_3COL"
}
},
"retailer_item_ids": [0, 0, 0],
"show_in_feed": true
}' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/canvas_elements
ملاحظة: في المثال أعلاه item_headline
وitem_description
وimage_overlay_spec
وstorefront_setting
وretailer_item_ids
هي كلها حقول اختيارية. في الماضي، قمت بتوفير هذه الحقول في الاستدعاء نفسه لإنشاء إعلان التشكيلة والأصل الأساسي للتجربة الفورية. والآن تقوم بتوفيرها في هذا الاستدعاء.
يمكنك توفير أي حقول مطلوبة في المعلمة image_overlay_spec
. لمزيد من المعلومات، راجع API التسويق، المرجع، بيانات رابط تصميم الإعلان، مواصفات تراكب الصور.
تدعم المعلمة storefront_setting
الحقول product_set_layout
وenable_sections
وcustomized_section_titles
.
product_set_layout
الاسم | الوصف |
---|---|
string (سلسلة) | مطلوب.. كيفية عرض مجموعة المنتجات. |
لاستخدام customized_section_titles
، يجب تعيين enable_sections
إلى true
. يتوقع الحقل customized_section_titles
مصفوفة من الكائنات، تتضمن كل منها المعلمتين title_id
وcustomized_title
.
customized_section_titles
الاسم | الوصف |
---|---|
string (سلسلة) | مطلوب. |
string (سلسلة) | مطلوب. |
يمكنك إنشاء تذييل التجربة الفورية من خلال رابط.
curl \
-F 'canvas_button={
"rich_text": {
"plain_text": "See more at www.abc.com."
},
"open_url_action": {
"url": "https://www.abc.com"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
إذا كنت تريد ذلك، يمكنك أيضًا إنشاء زر تستخدمه في التذييل.
curl \
-F 'canvas_footer={
"child_elements": [BUTTON_ELEMENT_ID]
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
يتميز النص الذي توفره في التذييل بمرونة نسبية، ففي الماضي كان يجب عليك توفير See more....
، ولكن يمكنك الآن توفير نص مخصص يحتوى على الزر URL
.
curl \
-F 'body_element_ids=[
PHOTO/VIDEO_ELEMENT_ID,
PRODUCT_SET_ELEMENT_ID,
FOOTER_ELEMENT_ID
]' \
-F 'is_published=true' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvases
Open In Graph API Explorer
لإنشاء التجربة الفورية بفيديو القالب ومجموعة المنتجات والزر وموقع المتجر والتذييل الاختياري الذي قمت بإعداده، ستحتاج إلى تضمين المعلمة source_template_id
:
curl \
-F 'body_element_ids=[
TEMPLATE_VIDEO_ELEMENT_ID,
PRODUCT_SET_ELEMENT_ID,
FOOTER_ELEMENT_ID
]' \
-F 'name="Dynamic Video Instant Experience"' \
-F 'source_template_id="1932289657009030"' \
-F 'is_published=true' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/canvases
Open In Graph API Explorer
بالنسبة لقالب واجهة المتجر، تحتاج إلى تحديد source_template_id = 1932289657009030
، ويتم تعريفه في التجارب الفورية، استخدام القوالب. لا يتغير التخطيط من قالب لآخر؛ ولكن، يمكنك استبدال المحتوى الافتراضي بمقاطع فيديو ومنتجات ونصوص وروابط ديناميكية. ولمزيد من المعلومات، راجع التجارب الفورية، استخدام القوالب.
وأخيرًا، يلزمك إنشاء إعلان تشكيلة. ويسمح ذلك للأشخاص بالنقر على الصور أو عنصر الفيديو من إعلان التشكيلة لديك.
إذا كان العنصر الأول في تجربتك الفورية عبارة عن صورة، فيجب تعيين object_type
إلى SHARE
.
curl \ -F 'name=Collection Sample Image Creative' \ -F 'object_story_spec={ "link_data": { "link": "https://fb.com/canvas_doc/CANVAS_ID", "message": "AD_MESSAGE", "name": "AD_HEADLINE", }, "page_id": "PAGE_ID" }' \ -F 'object_type=SHARE' \ -F 'access_token=ACCESS_TOKEN' \ https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/adcreatives
Open In Graph API Explorer
إذا كان العنصر الأول في تجربتك الفورية عبارة عن فيديو، فقدّم هذا الطلب:
curl \
-F 'name=Collection Sample Video Creative' \
-F 'object_story_spec={
"video_data": {
"call_to_action": {
"type":"LEARN_MORE",
"value":{
"link":"https://fb.com/canvas_doc/CANVAS_ID",
}
},
"image_url": "THUMBNAIL_IMAGE_URL",
"message": "AD_MESSAGE",
"title": "AD_HEADLINE",
},
"page_id": "PAGE_ID"
}' \
-F 'object_type=VIDEO' \
-F 'access_token=ACCESS_TOKEN' \
https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/adcreatives
إذا كان العنصر الأول في تجربتك الفورية عبارة عن فيديو قالب، فقدّم هذا الطلب:
curl -X POST \
-F 'name="Dynamic Video Collection Ad"' \
-F 'adset_id=<ADSET_ID>' \
-F 'status=PAUSED \
-F 'creative={
"object_story_spec": {
"instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
"page_id": "<MAIN_PAGE_ID>",
"template_data":{
"call_to_action":{
"type":"LEARN_MORE"
},
"format_option":"collection_video",
"link":"https://fb.com/canvas_doc/CANVAS_ID",
"name":"Test Dynamic Ads with dynamic video",
"retailer_item_ids":[
"0",
"0",
"0",
"0"
]
}
},
"object_type": "SHARE",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
إذا كان لديك إمكانية معاينة الإعلان، فيمكنك توفير ad_format
ورمز وصول المستخدم لإنشاء معاينات استنادًا إلى إعلانك أو تصميم إعلانك.
curl -X GET \ -d 'ad_format="MOBILE_FEED_STANDARD"' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v21.0
/<CREATIVE_ID>/previews
Open In Graph API Explorer
ملاحظة: بالنسبة إلى إعلانات التجربة الفورية بفيديو القالب، التنسيقات المدعومة هي BIZ_DISCO_FEED_MOBILE
وGROUPS_MOBILE
وMOBILE_FEED_STANDARD
وSUGGESTED_VIDEO_DESKTOP
وSUGGESTED_VIDEO_MOBILE
وWATCH_FEED_MOBILE
.
راجع معاينات الإعلانات لمزيد من المعلومات.
يمكنك استخدام قالب كطريقة سريعة لإنشاء تجربة فورية خاصة بتحقيق هدف معين لنشاط تجاري. ولا يتغير التخطيط من قالب لآخر؛ ولكن، يمكنك استبدال المحتوى الافتراضي بصور ومقاطع فيديو ومنتجات ونصوص وروابط خاصة بك. ولمزيد من المعلومات، راجع التجارب الفورية، استخدام القوالب.
يتوفر نوعان من إعلانات التشكيلة التي تتضمن تجارب فورية وهما: إعلانات قائمة على الصور وإعلانات قائمة على الفيديو بناءً على الأصل الذي تقدمه. وبمجرد اكتمال تصميم إعلان، يمكنك إنشاء إعلان.
curl
-F 'name=Instant Experiences Collection Sample Image Creative'
-F 'object_story_spec={
"link_data": {
"link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID",
"message": "Ad message",
"name": "name",
"picture": "IMAGE_URL",
"collection_thumbnails": [
{"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
{"element_child_index": 0,"element_id": "",},
{"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
],
},
"page_id": "PAGE_ID"
}'
-F 'access_token=ACCESS_TOKEN'
https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/adcreatives
curl
-F 'name=Instant Experiences Collection Sample Video Creative'
-F 'object_story_spec={
"page_id": "PAGE_ID",
"video_data": {
"call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}},
"image_url": "IMAGE_URL",
"collection_thumbnails": [
{"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
{"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
{"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
],
"title": "My title",
"video_id": "VIDEO_ID"
}
}'
-F 'access_token=ACCESS_TOKEN'
https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/adcreatives
الاسم | الوصف |
---|---|
string (سلسلة) | مطلوب |
array (مصفوفة) | مطلوب |
collection_thumbnails
الاسم | الوصف |
---|---|
numeric string (سلسلة رقمية) | مطلوب |
integer (عدد صحيح) | مطلوب لعنصر صورة بإشارات إلى المنتج وعنصر قائمة المنتجات |
| مطلوب لعنصر صورة |
يمكنك تلقائيًا إنشاء جماهير من الأشخاص الذي تفاعلوا مع إعلان التشكيلة. وهذا يشبه جماهير التفاعل للتجارب الفورية القياسية. ولمزيد من المعلومات، راجع التجارب الفورية، جماهير التفاعل.
يمكنك استهداف إعلانات التجارب الفورية بعرض ملء الشاشة لدى الأشخاص الذين يضغطون على إعلان التشكيلة لديك. ونستدعي هذا النوع من الجمهور وهو جمهور التفاعل مع التجربة بوضع ملء الشاشة. ويمكنك إنشاء هذا الجمهور عن طريق إنشاء جمهور مخصص، ثم قم بتعيين object_id
إلى CANVAS_ID
وأنشئ قاعدة لتتبع أحد الأحداث.
curl \ -F 'name=Collection Engagement Audience' -F 'description=People who opened this Instant Experience' -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' -F 'access_token=ACCESS_TOKEN' https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/customaudiences
Open In Graph API Explorer
curl \ -F 'name=Collection Engagement Audience' -F 'description=People who clicked any links in this Instant Experience' -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]' -F 'access_token=ACCESS_TOKEN' https://graph.facebook.com/v21.0
/AD_ACCOUNT_ID/customaudiences
Open In Graph API Explorer
تعتمد إعلانات التشكيلة على التجارب الفورية التي تتضمن قالبًا. وبالتالي ومن أجل إنشاء إعلان تشكيلة باستخدام مربع حوار، ستستخدم مربع حوار التجارب الفورية الذي يتضمن معلمات إضافية. وسيوفر ذلك دفق واجهة مستخدم إنشاء إعلانات التشكيلة على Facebook في موقعك على الويب. ولمزيد من التفاصيل حول مكون واجهة المستخدم، راجع مربعات الحوار.
لإعداد مجموعة Facebook SDK for Javascript، راجع:
تعتمد مجموعة SDK للغة JavaScript على أذونات المستخدم الذي سجّل الدخول لإنشاء تجارب فورية. وإذا لم يتمتع المستخدم بالأذونات اللازمة لإنشاء تجربة فورية للصفحة والنشاط التجاري المتوفر، فسيعرض مربع الحوار رسالة تفيد بوجود خطأ. ويجب أن يتمتع المستخدم أيضًا بالوصول إلى كتالوجات المنتجات ومجموعاتها. ولضمان أنه لا توجد أي أخطاء، يجب على المستخدم أن يحصل على وصول إلى مدير الأعمال ويتمتع بأذونات لإنشاء الإعلانات للصفحة.
حينها يمكنك تشغيل مربع حوار إعلانات التشكيلة.
FB.ui({ display: 'popup', method: 'instant_experiences_builder', account_id: 'AD_ACCOUNT_ID'. business_id: 'BUSINESS_ID', page_id: 'PAGE_ID', template_id: 'TEMPLATE_ID' }, function(response) { // callback });
يمكنك توفير الإعدادات التالية للمكون الإضافي:
الاسم | الوصف |
---|---|
| مطلوب |
| مطلوب |
| مطلوب |
| مطلوب |
| مطلوب |
| مطلوب |
| اختياري |
| اختياري |
يمكن العثور على كل أنواع القوالب الصالحة والمعرف المطابق في التجارب الفورية: استخدام قالب.
تتوفر المعلمتان product_catalog_id
وproduct_set_id
بشكل اختياري. ولكن إذا قمت بتوفير المعلمة product_set_id
، فستحتاج إلى توفير المعلمة product_catalog_id
. وبمجرد توفير هذه المعرفات، لن يتمكّن المستخدم من تغيير المجموعة في واجهة المستخدم. وإذا لم تتوفر إحدى المعلمتين، فيمكن للمستخدم تحديد الكتالوج ومجموعة المنتجات في واجهة المستخدم. لمعانية إعلان تشكيلة، نوصي باستخدام مربع حوار معاينة التجارب الفورية.
عند نجاح العملية، يوفر المكون الإضافي الاستجابة التالية:
{ "success": true, "id": "CANVAS_ID" }
سيكون id
الذي يتم إرجاعه تجربة فورية غير منشورة. وستحتاج إلى النشر قبل استخدامها في الحملات الإعلانية.
إذا لم تكن هناك استجابة أو تم إرجاع استجابة undefined
، فهذا يعني أن المستخدم أغلق مربع الحوار قبل إكمال التجربة الفورية، أو أن المستخدم قد قام بحفظ التجربة الفورية ولكن لم يكملها. ويمكنك الاستعلام عن واجهة Graph API لعرض كل التجارب الفورية التي تنتمي إلى صفحة، وهذا يسمح لك بمعرفة إذا كانت هناك أي تجارب فورية غير مكتملة.
يمكنك عرض تصاميم الإعلان من كتالوج الوجهة في الصورة الرئيسية لإعلان التشكيلة. ويمكنك أيضًا عرض إعلان دوّار يتضمن صورًا لفندق في هذه الوجهة. ولإجراء ذلك، يجب توفير صورة احتياطية لعرضها في الصورة الرئيسية في حالة عدم العثور على وجهة مقابلة للفنادق في الإعلان الدوّار. لمزيد من المعلومات، راجع كتالوج الوجهة.
ضع القيود التالية في الاعتبار:
لاستخدام هذه الميزة، يمكنك إضافة المعلمة destination_set_id
عند إنشاء العنصر canvas_photo
، ثم اتبع الخطوات القياسية الأخرى لإنشاء التجربة الفورية وإعلان التشكيلة.
المثال
curl \
-F 'canvas_photo={
"photo_id": "PHOTO_ID",
"destination_set_id": "DESTINATION_SET_ID",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer