إعلانات التشكيلة

يحتوي تنسيق إعلان التشكيلة على تجربة فورية ويتيح للأشخاص إمكانية التعرُّف على المنتجات والخدمات من أجهزتهم المحمولة وتصفحها وشراءها بسهولة بطريقة رائعة تتميز باستخدام عناصر بصرية جاذبة للانتباه. وسيقوم إعلانك في قائمة المنتجات بتمييز ثلاثة منتجات ضمن فيديو أو صورة رئيسية تفتح في التجربة الفورية بشاشة كاملة عندما يتفاعل شخص ما مع إعلانك. ويتوفر نوعان من إعلانات التشكيلة وهما: إعلانات تستند إلى الصور وإعلانات تستند إلى الفيديو.

يجب مراعاة كل المراجع المتعلقة "باللوحة" بحيث تمثل تجربة فورية، علمًا بأن اللوحة هي الاسم السابق لهذا التنسيق.

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

كما يمكنك تضمين واجهات مستخدم إنشاء الإعلانات في 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
الاسمالوصف

layout_type

string (سلسلة)

مطلوب.. كيفية عرض مجموعة المنتجات.
القيم:GRID_2COL وGRID_3COL وCAROUSEL وHSCROLL_LIST

لاستخدام customized_section_titles، يجب تعيين enable_sections إلى true. يتوقع الحقل customized_section_titles مصفوفة من الكائنات، تتضمن كل منها المعلمتين title_id وcustomized_title.

حقول customized_section_titles
الاسمالوصف

title_id

string (سلسلة)

مطلوب.
سلسلة تعداد تمثل سلسلة عنوان القسم الافتراضي الذي تود استبداله.
القيم:keep_shopping وtake_another_look وyou_may_also_like وrelated_products وtrending وpopular وtop_items وfavorites وmost_viewed وtop_picks_for_you وsuggested_for_you وfeatured_favorites وjust_for_you وexplore_more وshop_by_category

customized_title

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

المعلمات

الاسمالوصف

link

string (سلسلة)

مطلوب
يعمل على إعادة توجيه المشاهد إلى تجربة فورية.

collection_thumbnails

array (مصفوفة)

مطلوب
مصفوفة من الصور المصغرة. يتطلب وجود أربع صور مصغرة.

حقول collection_thumbnails

الاسمالوصف

element_id

numeric string (سلسلة رقمية)

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

element_child_index

integer (عدد صحيح)

مطلوب لعنصر صورة بإشارات إلى المنتج وعنصر قائمة المنتجات
فهرس المنتجات من مصفوفة تتضمن معرفات عناصر الصور بإشارات على الصور. أو فهرس منتجات من مصفوفة product_id_list، والتي تحتوي على عناصر قائمة المنتجات.
ملاحظة: يجب أن يكون عدد صحيح إيجابي.

element_crops
AdsImageCrops

مطلوب لعنصر صورة
يمثل كائنًا بلغة JSON يحدد أبعاد الاقتصاص للصورة المحددة. وغير مسموح إلا باستخدام مفتاح اقتصاص بأبعاد 100x100.

إنشاء جماهير التفاعل

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

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

يمكنك توفير الإعدادات التالية للمكون الإضافي:

الاسم الوصف

display

مطلوب
معلمة ضرورية يتم تعيينها إلى القيمة popup.

method

مطلوب
معلمة ضرورية ينم تعيينها إلى القيمة instant_experiences_builder.

account_id

مطلوب
معرف الحساب الإعلاني.

business_id

مطلوب
معرف النشاط التجاري.

page_id

مطلوب
معرف الصفحة التي تريد ربطها بالتجربة الفورية.

template_id

مطلوب
معرف القالب الذي تريد استخدامه.

product_catalog_id

اختياري
معرف كتالوج المنتجات الذي يجب استخدامه في التشكيلة. هذا ضروري إذا تم توفير product_set_id.

product_set_id

اختياري
معرف مجموعة المنتجات التي يجب استخدامها في التشكيلة.

يمكن العثور على كل أنواع القوالب الصالحة والمعرف المطابق في التجارب الفورية: استخدام قالب.

تتوفر المعلمتان 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