التجارب الفورية

تتمثل التجارب الفورية في ملء الشاشة ووجهة الإعلانات ما بعد النقر التي يتم تحميلها بشكل فوري تقريبًا من الإعلانات الموجودة في الموجز.

قبل البدء

لإنشاء التجارب الفورية وإدارتها، تحتاج إلى ما يلي:

• الإذن pages_manage_ads
• الإذن pages_read_engagement
• الإذن pages_show_list
• إمكانية تنفيذ المهمة ADVERTISE على الصفحة

التقييدات

• يمكنك تحديث التجارب الفورية التي لم يتم نشرها فقط.
• API التجارب الفورية متوفرة على Instagram بشكل محدود.
• علمًا بأن الإعلانات التي تستخدم التجارب الفورية غير مدعومة لدى Facebook Stories.

الإنشاء

لإنشاء تجربة فورية، ستحتاج إلى معرف صفحة فيسبوك (PAGE-ID) وأي عناصر، مثل الصور والأزرار والنصوص التي تريد تضمينها في تجربتك.

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

العناصر

حذف عنصر

لحذف عنصر ما، أرسل طلب DELETE مع معرف العنصر الذي تريد حذفه.

curl -X DELETE \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ELEMENT_ID>

الحصول على تجارب فورية موجودة

للحصول على معلومات بشأن أي تجربة فورية موجودة، ستحتاج إلى معرف التجربة الفورية (CANVAS-ID).

curl -G \
  --data-urlencode 'fields=[ 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "name" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

الحصول على كل التجارب الفورية لأي صفحة

للحصول على معلومات حول كل التجارب الفورية الموجودة لصفحة فيسبوك، ستحتاج إلى معرف الصفحة (PAGE-ID).

curl -G \
  --data-urlencode 'fields=[ 
    "background_color", 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "last_editor", 
    "name", 
    "owner", 
    "update_time" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

تحديث تجربة فورية

لتحديث تجربة فورية، يجب إلغاء نشر التجربة وستحتاج إلى معرف التجربة الفورية (CANVAS-ID) وأي معرفات عناصر تريد تحديثها.

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

استخدام قالب

استخدم قالبًا كطريقة سريعة لإنشاء تجربة فورية خاصة بتحقيق هدف معين لنشاط تجاري. لا يتغير التخطيط من قالب لآخر، ولكن يمكنك استبدال المحتوى الافتراضي بصور ومقاطع فيديو ومنتجات ونصوص وروابط خاصة بك.

الحصول على أنواع العناصر في القالب

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

أرسل طلب GET لتحديد العناصر اللازمة لقالب محدد، مثل قالب الحصول على عملاء جدد في المثال التالي.

curl -i -X GET \
 "https://graph.facebook.com/VERSION/133471657203838?fields=document&access_token=ACCESS-TOKEN"

مثال على الاستجابة

{
  "document": {
    "name": "Get New Customers",
    "id": "397246414010297"
  },
  "id": "133471657203838"
}

الخطوة الثانية. الحصول على أنواع العناصر

استخدم معرف الحقل document للحصول على العناصر الخاصة المتوفرة للقالب المحدد.

curl -i -X GET \
 "https://graph.facebook.com/VERSION/397246414010297?fields=body_elements&access_token=ACCESS-TOKEN"

تعرض القائمة التي تم إرجاعها أنواع العناصر المتوفرة لاستخدامها في قالب الحصول على عملاء جدد.

    {
  "body_elements": [
    {
      "name": "Cover Image or Video",
      "element_type": "PHOTO",
      "id": "397271930674412"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271920674413"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271910674414"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271914007747"
    },
    {
      "name": "Carousel",
      "element_type": "CAROUSEL",
      "id": "397271940674411"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271917341080"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271924007746"
    }
  ],
  "id": "397246414010297"
}

النشر

لنشر إعلان التجربة الفورية، أرسل طلب POST إلى معرف التجربة الفورية (CANVAS-ID) مع بتعيين الحقل is_published على true.

curl \
  -F 'is_published=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

إنشاء تصميم إعلان

أنشئ تصميم إعلان باستخدام رابط التجربة الفورية الحالية (CANVAS-LINK).

curl -X POST \
  -F 'image_hash="<IMAGE_HASH>"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "<CANVAS_LINK>",
         "name": "Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

بمجرد أن يكون تصميم الإعلان جاهزًا، يمكنك الانتقال إلى إنشاء مجموعة الإعلانات والمجموعة الإعلانية والحملة الإعلانية.

مربع حوار إعلانات التجارب الفورية

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

لإعداد مجموعة Facebook SDK للغة JavaScript، راجع:

• دليل البدء السريع
• مرجع بدء التشغيل

تعتمد مجموعة SDK للغة JavaScript على أذونات المستخدم الذي سجّل الدخول لإنشاء تجربة فورية. إذا لم تتوفر لدى المستخدم الأذونات اللازمة لإنشاء تجربة فورية للصفحة والنشاط التجاري المتوفر، فسيعرض مربع الحوار رسالة تفيد بوجود خطأ. لضمان أنه لا توجد أي أخطاء، يجب أن يكون المستخدم مرتبطًا بالنشاط التجاري وتتوفر لديها أذونات "إنشاء الإعلانات" في الصفحة.

بعد ذلك، قم بتشغيل مربع الحوار:

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  business_id: '<BUSINESS_ID>',
  page_id: '<PAGE_ID>'
}, function(response) {
  // callback
});

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

تكون المعلمة canvas_id اختيارية وتسمح للمستخدم بتعديل تجربة فورية موجودة أو معاينتها. في حالة اكتمال التجربة الفورية، لا يمكنك تعديلها. نوصي باستخدام مربع حوار معاينة التجارب الفورية لمعاينة التجربة الفورية.

عند نجاح العملية، يوفر المكون الإضافي الاستجابة التالية:

{
  "success": true,
  "id": "CANVAS-ID"
}

المعرف الذي تم إرجاعه هو تجربة فورية منشورة. يمكنك الآن استخدامه في الحملات الإعلانية. في حالة عدم وجود أي استجابة أو إرجاع الاستجابة undefined، يعني ذلك أن العارض قد أغلق مربع الحوار قبل إكمال التجربة الفورية. قد يكون المستخدم قد حفظ التجارب الفورية، لكنه لم يكملها. يمكنك سحب كل التجارب الفورية التي تنتمي إلى صفحة باستخدام Graph API لمعرفة ما إذا كانت توجد أي تجارب غير مكتملة.

معاينة التجربة الفورية

API معاينة Iframe

يمكنك إنشاء معاينة تجربة فورية عن طريق استدعاء API المعاينات التي ترجع iframe، على غرار API معاينات الإعلانات:

curl -X GET \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v18.0/<CANVAS_ID>/preview
  
Open In Graph API Explorer

ترجع API استجابة مشابهة، والتي يمكن عرضها عن طريق تضمين عنصر iframe الذي تم إرجاعه في HTML:

{
"data": [
    {
      "body": "<iframe src=\"https://www.facebook.com/ads/canvas/preview?d=AQKELApdJxoVp2f3PHl8-pRtYuAh4-_eDupMDbh-pS9zde_EFxckhYQCXu7NYUi4PhhBA7uskIo2Ys3IjIVNGZiS&t=AQKGOPqGI-NWcv1YKbA\" width=\"405\" height=\"720\" scrolling=\"yes\" style=\"border: none;\"></iframe>"
    }
  ],
  "__www_request_id__": "AQnyr47Qp2r5M-ISqSiMgrw"
}

مجموعة Facebook SDK

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

لإعداد مجموعة Facebook SDK للغة JavaScript، راجع:

• دليل البدء السريع
• مرجع بدء التشغيل

تعتمد مجموعة SDK للغة JavaScript على أذونات المستخدم الذي سجّل الدخول لإنشاء تجربة فورية. إذا لم تتوفر لدى المستخدم الأذونات اللازمة لعرض التجربة الفورية، فسيعرض مربع الحوار رسالة تفيد بوجود خطأ.

بعد ذلك، قم بتشغيل مربع حوار المعاينة:

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_preview',
  canvas_id: 'CANVAS-ID'
});

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

إنشاء جماهير للتجارب الفورية

لإنشاء جمهور التفاعل وهو جمهور من الأشخاص الذين يتفاعلون مع التجربة الفورية، قم بتعيين المعلمة object_id الخاصة بالحقل rule على معرف التجربة الفورية (CANVAS-ID) في استدعاء POST /act_AD-ACCOUNT/customaudiences.

الأشخاص الذين فتحوا التجربة الفورية

curl \
  -F 'name=Instant Experience 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/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

الأشخاص الذين نقروا على أي روابط في التجربة الفورية

curl \
  -F 'name=Instant Experience 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/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

لمزيد من المعلومات حول الجماهير المخصصة، يمكنك الرجوع إلى الجمهور المخصص، المرجع.

إعلانات التجارب الفورية وInstagram

يستخدم تنفيذ التجارب الفورية من خلال Instagram استدعاءات واجهة API نفسها التي تستخدمها للتجربة الفورية على Facebook. ولاحظ وجود قيود يتم تطبيقها عند استخدام Instagram والتجارب الفورية:

• المواضع - متوفرة لموجز Instagram وInstagram Stories. إذا حددت Instagram Stories، فيجب تحديد ذلك فقط كموضع إعلاناتك الحصري.
• عناصر التجربة الفورية - تدعم العناوين ومجموعات المنتجات بالكامل.

ندعم جزئيًا عناصر التجربة الفورية التالية على Instagram:

• التذييل - لا يتم عرض swipe to open في الأجهزة العميلة باسم Tap to open.
• الإعلان الدوّار - لا توجد صور ترتبط بتجربة فورية أخرى؛ وتظهر في الأجهزة العميلة كرابط لا يمكن النقر عليه. بالنسبة إلى الصور ومقاطع الفيديو، لا يوجد احتواء ضمن الارتفاع أو احتواء ضمن العرض أو إمالة للتحريك، ويتم عرضها كاحتواء ضمن العرض.
• الزر - لا يمكن الربط بتجربة فورية أخرى أو بمتجر App Store.
• النص - لا يتم دعم لغات من اليمين إلى اليسار.
• الفيديو - لا يتم دعم مقاطع فيديو بتقنية 360 درجة.
• محددات مواقع المتاجر - غير مدعومة.

رؤى الإعلانات

راجع رؤى الإعلانات للاطلاع على نظرة عامة وأوصاف أدوات القياس المتوفرة.

راجع أيضًا

• دليل إعلانات Facebook: مواصفات التجربة الفورية
• مركز مساعدة الأعمال: تعرف على التجربة الفورية