نماذج تجميع بيانات العملاء المحتملين للإعلانات

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

لإنشاء إعلان تجميع بيانات عملاء محتملين ونشره، ستتبع الخطوات التالية:

إنشاء حملة إعلانية
إنشاء مجموعة إعلانية تربط الإعلانات بالحملة الإعلانية
إنشاء نموذج تجميع بيانات العملاء المحتملين
إنشاء تصميم إعلان يتضمن نموذجًا لتجميع بيانات العملاء المحتملين
ربط الحملة الإعلانية والتصميم لإنشاء إعلان
نشر الإعلان

قبل البدء

يفترض هذا الدليل أنك قد قرأت نظرة عامة على منصة Messenger ونفذت المكونات اللازمة لإرسال الرسائل والإشعارات وتلقيها.

ستحتاج إلى ما يلي:

الإذن ads_management
الإذن pages_manage_ads
الإذن pages_read_engagement
الإذن pages_show_list
رمز وصول الصفحة من جانب الشخص الذي يمكنه تنفيذ المهمة ADVERTISE في الصفحة

الخطوة الأولى. إنشاء حملة إعلانية

لإنشاء حملة إعلانية مخصصة لإعلانات تجميع بيانات العملاء المحتملين، أرسل طلب POST إلى نقطة النهاية /act_AD_ACCOUNT_ID/campaigns مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
buying_type يتم تعيينها على AUCTION
name يتم تعيينها على اسم الحملة الإعلانية
objective يتم تعيينها على LEAD_GENERATION
special_ad_categories يتم تعيينها على NONE أو الفئة الإعلانية الخاصة
تعيين status على PAUSED

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل AD_ACCOUNT_ID بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "buying_type":"AUCTION",
           "name":"Messenger_ad_campaign_name",
           "objective":"LEAD_GENERATION",
           "special_ad_categories":["NONE"],
           "status":"PAUSED"
         }'

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

{
  "id": "YOUR_CAMPAIGN_ID"
}

تفضل بزيارة مرجع الحملات الإعلانية لمعرفة المزيد.

الخطوة الثانية. إنشاء مجموعة إعلانية

لإنشاء مجموعة إعلانية، أرسل طلب POST إلى نقطة النهاية act_ad_account_id/adsets حيث يكون ad_account_id هو معرف حسابك الإعلاني على Meta. يجب أن يتضمن طلبك:

access_token يتم تعيينها على رمز وصول الصفحة
bid_amount يتم تعيينها على الحد الأقصى للمبلغ الذي تريد دفعه
billing_event يتم تعيينها على IMPRESSIONS
campaign_id يتم تعيينها على معرف الحملة الإعلانية من الخطوة الأولى
daily_budget يتم تعيينها على المبلغ الذي تريد إنفاقه يوميًا
name يتم تعيينها على اسم المجموعة الإعلانية
optimization_goal يتم تعيينها على LEAD_GENERATION أو QUALITY_LEAD
promoted_object – يتم تعيينها على المعرف في صفحة النشاط التجاري على فيسبوك
تعيين status على PAUSED

ملاحظة: إذا تم إعداد مصدر بيانات إدارة علاقات العملاء واختيار QUALITY_LEAD كهدف تحسين، فيمكنك إضافة pixel_id إلى promoted_object لتحسين الجودة بشكل أكبر. لاحظ أنك لا تحتاج إلى توفير pixel_rule جنبًا إلى جنب مع pixel_id.

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل AD_ACCOUNT_ID بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"Your_page_access_token",
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "name:"YOUR_LEADADS_ADSET",
           "optimization_goal:LEAD_GENERATION",
           "promoted_object":"YOUR_PAGE_ID",
           "status:PAUSED"
         }'

عند نجاح العملية، يتلقى التطبيق استجابة JSON التالية والتي تتضمن معرف المجموعة الإعلانية.

{
  "id": "YOUR_ADSET_ID"
}

تفضل بزيارة مرجع المجموعات الإعلانية لمعرفة المزيد.

الخطوة الثالثة. إنشاء نموذج لتجميع بيانات العملاء المحتملين

لإنشاء نموذج، أرسل طلب POST إلى نقطة النهاية /PAGE_ID/leadgen_forms مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
تعيين name إلى اسم النموذج
تعيين questions إلى مصفوفة من الكائنات التي تحدد نوع الأسئلة وترتيب الظهور في النموذج باستخدام المعلمة key
- سؤال مخصص باستخدام المعلمة label
- سؤال مخصص باستخدام المعلمة options مع قائمة منسدلة من الإجابات

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_PAGE_ACCESS_TOKEN",
           "name": "YOUR_LEADADS_FORM_NAME",
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

النماذج في المحادثات على Messenger

يجب أن تحتوي النماذج التي تريد استخدامها في إعلان في محادثة على Messenger على ما يلي:

لا يمكن تعيين المعلمة questions.type إلا على إحدى القيم التالية:
CUSTOM
EMAIL
FIRST_NAME
FULL_NAME
LAST_NAME
PHONE
إذا كان النموذج يتضمن معلمة questions.type تم تعيينها على أي قيمة أخرى بخلاف القيم المدرجة، فسيكون النموذج غير مؤهل.
يجب تعيين المعلمة block_display_for_non_targeted_viewer على false. سيحدد ذلك النموذج باعتباره متوفر للمشاركة.

مثال على طلب نموذج تجميع بيانات العملاء المحتملين المؤهل في Messenger

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "page_ACCESS_TOKEN"
           "block_display_for_non_targeted_viewer": "false"
           "name": "LeadAds Form for Messenger Conversation Name"
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

أنواع الأسئلة الإضافية

بالإضافة إلى أنواع الأسئلة النموذجية الموضحة في [Create a Lead Form section]{#create-a-lead-form}، يمكنك إضافة المزيد من أنواع الأسئلة المخصصة لحالات الاستخدام التالية:

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

تحديد الموعد

يعرض سؤال تحديد الموعد أداة تحديد التاريخ والوقت مع إمكانية محدودة لتحديد الساعات ورسالة تأكيد أسفل السؤال.

لإضافة سؤال تحديد موعد، أضف كائن السؤال مع تعيين المعلمة type على DATE_TIME. يمكنك أيضًا إضافة رسالة تأكيد اختياريًا في المعلمة inline_context والتي سيتم عرضها مباشرةً أسفل حقل السؤال لتوفير مزيد من السياق إذا لزم الأمر.

...
           "questions": "[
               ...
               {"type": "DATE_TIME", 
                "label": "Appointment time", 
                "inline_context": "We will verify and call you to confirm your appointment."
               },
...

معرف الهوية القومية

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

الأرجنتين – {"type": "ID_AR_DNI"}
البرازيل – ID_CPF
تشيلي – ID_CL_RUT
كولومبيا – ID_CO_CC
الإكوادور - ID_EC_CI
بيرو - ID_PE_DNI

لإضافة سؤال عن الهوية القومية، أضف كائن سؤال مع تعيين المعلمة type إلى نوع بلد الشخص.

التقييدات

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

...
           "questions": "[
               ...
               {"type": "ID_AR_DNI"
               },
...

محدد موقع المتجر

يعرض سؤال محدد مواقع المتاجر أداةً لتحديد محدد مواقع المتاجر استنادًا إلى إدخال الرمز البريدي للشخص.

ستحتاج إلى إعداد بنية صفحات المتاجر لاستخدام هذا السؤال. تعرف على كيفية إجراء ذلك في إعداد بنية صفحات المتاجر على فيسبوك – مركز مساعدة الأعمال من Meta

لإضافة سؤال حول محدد مواقع المتاجر، أضف كائن سؤال مع تعيين المعلمة type على STORE_LOOKUP وتعيين المعلمة context_provider_type على LOCATION_MANAGER.

...
           "questions": "[
               ...
               {"type": "STORE_LOOKUP", 
                "label": "Which store do you want to visit?", 
                "context_provider_type": "LOCATION_MANAGER"
               },
...

إعدادات النموذج المتقدمة

يمكنك الحصول على بيانات عملاء محتملين بجودة أعلى عن طريق إضافة واحد أو أكثر من إعدادات النموذج التالية:

تتبع أداء النموذج لتتبع مصدر بيانات العملاء المحتملين
نماذج النية الأعلى لإضافة مراجعة وتأكيد الخطوة في دفق النموذج
فلترة العملاء المحتملين من الوصول العادي لفلترة العملاء المحتملين الواردين من الوصول العادي

إضافة إعداد تتبع الأداء

لمساعدتك في تتبع مصدر بيانات العملاء المحتملين، أضف الحقل tracking_parameters، وقم بتعيينه على قائمة بأزواج المفتاح والقيمة للمعلمات التي تريد تتبعها، في النموذج. لا تظهر هذه المعلمات في الإعلان ولكنها تسمح لـ Meta بتوفير بيانات تعريفية لك حول بيانات العملاء المحتملين التي تم تجميعها من النموذج.

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "tracking_parameters": {"your_tracking_parameter_name":"your_tracking_parameter_value"},
           "questions": "[
...

إضافة إعداد النية الأعلى

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

لإضافة دفق التأكيد هذا إلى النموذج، أضف المعلمة is_optimized_for_quality مع تعيينها على true عند إنشاء النموذج.

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "is_optimized_for_quality": "true",
           "questions": "[
...

فلترة العملاء المحتملين من الوصول العادي

فلترة العملاء المحتملين من الوصول العادي، أضف المعلمة block_display_for_non_targeted_viewer مع تعيينها على true عند إنشاء النموذج.

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "block_display_for_non_targeted_viewer": "true",
           "questions": "[
...

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

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

{
  "id": "leadgen_form_id",
}

الخطوة الرابعة. إنشاء تصميم إعلان

لإنشاء تصميم إعلان يتضمن صورة والنموذج المتوفر لديك، أرسل طلب POST إلى نقطة النهاية /act_AD_ACCOUNT_ID/adcreatives مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
object_story_spec التي تتضمن كائن link_data يحتوي على المعلمات التالية:
- call_to_action يتم تعيينها على كائن يحتوي على type وvalue يتم تعيينها على معرف نموذج بيانات العميل المحتمل
- description يتم تعيينها على وصف التصميم
- image_hash يتم تعيينها على تجزئة الصورة الموجودة في تصميم الإعلان
- link_url يتم تعيينها على عنوان URL. لا يمكن أن تكون صفحتك على فيسبوك
- message يتم تعيينها على النص الموجود في تصميم الإعلان
page_id يتم تعيينها على معرف صفحة فيسبوك لديك

ملاحظة: أثناء إنشاء link_data، يمكن أن تكون القيمة المرتبطة بالحقل link عبارة عن https//fb.me/ فقط.

يجب تعيين المعلمة link_data.call_to_action على إحدى القيم التالية:

APPLY_NOW
DOWNLOAD
GET_QUOTE
LEARN_MORE
SIGN_UP
SUBSCRIBE

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل AD_ACCOUNT_ID بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/act_AD_ACCOUNT_ID/adcreatives" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "object_story_spec":{ 
             "link_data": { 
               "call_to_action": {
                 "type":"SIGN_UP",
                 "value":{
                   "lead_gen_form_id":"YOUR_FORM_ID"
                 }
               }, 
               "description": "YOUR_AD_CREATIVE_DESCRIPTION", 
               "image_hash": "YOUR_IMAGE_HASH", 
               "link": "http:\/\/fb.me\/", 
               "message": "YOUR_AD_CREATIVE_MESSAGE" 
             }, 
           "page_id": "YOUR_PAGE_ID" 
         }'

تصميم يحتوي على إعلان دوّار

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

لا يمكنك سوى تحديد <FORM_ID> نفسه لجميع المرفقات التابعة.

curl \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "link_data": { 
      "message": "My description", 
      "link": "http:\/\/www.google.com", 
      "caption": "WWW.EXAMPLE.COM", 
      "child_attachments": [ 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        } 
      ], 
      "multi_share_optimized": true, 
      "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/act_<AD_ACCOUNT_ID>/adcreatives

تصميم يتضمن فيديو

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

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "link_description": "try it out",
         "image_url": "<IMAGE_URL>",
         "video_id": "<VIDEO_ID>",
         "call_to_action": {
           "type": "SIGN_UP",
           "value": {
             "link": "http://fb.me/",
             "lead_gen_form_id": "<FORM_ID>"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

مثال على استجابة تصميم الإعلان

عند النجاح، يتلقى التطبيق استجابة JSON التالية بمعرف تصميم الإعلان.

{
  "id": "YOUR_AD_CREATIVE_ID"
}

الخطوة الخامسة. إنشاء الإعلان

لإنشاء الإعلان، تحتاج إلى ربط تصميم الإعلان والمجموعة الإعلانية. لإنشاء إعلان، أرسل طلب POST إلى نقطة النهاية /act_AD_ACCOUNT_ID/ads. يجب أن يتضمن طلبك:

access_token يتم تعيينها على رمز وصول الصفحة
adset_id (من الخطوة الثانية)
creative_id (من الخطوة الرابعة)
name
status

مثال على طلب تصميم يحتوي على إعلان

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل AD_ACCOUNT_ID بالقيم المتوفرة لديك.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token"="YOUR_PAGE_ACCESS_TOKEN",
           "adset_id"="YOUR_AD_SET_ID",
           "creative"={ "creative_id": "YOUR_AD_CREATIVE_ID" },
           "status"="PAUSED"
         }'

عند نجاح العملية، يتلقى التطبيق استجابة JSON التالية والتي تتضمن معرف الإعلان.

{
  "id": "YOUR_AD_ID"
}

الخطوة السادسة. نشر الإعلان

تحقق من وجود إعلانك في مدير الإعلانات . انقر على زر المراجعة والنشر في أعلى الجانب الأيسر. حدّد الحملة الإعلانية والمجموعة الإعلانية للحملة الإعلانية والإعلان.

يمكنك نشر الإعلان من مدير الإعلانات أو باستخدام API. للنشر باستخدام API، كرّر الخطوة الرابعة مع تعيين المعلمة status على ACTIVE.

ستتم مراجعة الإعلان من خلال Meta وستكون الحالة PENDING_REVIEW. بمجرد الموافقة، ستكون الحالة ACTIVE وسيتم عرض الإعلان.

إدارة النموذج

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

الحصول على قائمة بالنماذج

للحصول على قائمة بنماذج تجميع بيانات العملاء المحتملين، أرسل طلب GET إلى نقطة النهاية /page_id/leadgen_forms مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
(اختياري) تعيين fields إلى قائمة مفصولة بفاصلة من الحقول للحصول على معلومات محددة مثل الاسم ومعرف النموذج

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=name,id
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

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

الحصول على قائمة بالنماذج المؤهلة في Messenger

وحدها النماذج التي تحتوي على متطلبات محددة تكون مؤهلة للإرسال في محادثة على Messenger.

للحصول على قائمة بنماذج تجميع بيانات العملاء المحتملين المؤهلة، أرسل طلب GET إلى نقطة النهاية /page_id/leadgen_forms مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
تعيين fields على is_eligible_for_in_thread_forms

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=is_eligible_for_in_thread_forms
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON تحتوي على قائمة بمعرفات النماذج المؤهلة.

{
  "data": [
    {
      "id": "eligible_form_1_id"
    },
    {
      "id": "eligible_form_2_id"
    }
  ],
...
}

الحصول على قائمة بالأسئلة

للحصول على قائمة بالأسئلة في نموذج تجميع بيانات العملاء المحتملين محدد، أرسل طلب GET إلى نقطة النهاية /page_id/leadgen_form_id مع تضمين المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
تعيين fields على questions

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?fields=questions
    &access_token=page_access_token"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON تحتوي على قائمة بالأسئلة.

أرشفة النموذج

لا يمكنك سوى أرشفة نموذج تجميع بيانات العملاء المحتملين لأن الحذف غير مدعوم. بمجرد أرشفة النموذج:

لن يظهر النموذج (بشكل افتراضي) في مكتبة النماذج
لا يمكنك استخدام نموذج مؤرشف في إعلان، ومحاولة إجراء ذلك يمكن أن تؤدي إلى إنشاء خطأ عبر API.
لن تكون النماذج المؤرشفة متوفرة أثناء إنشاء الإعلانات في CF أو PE.

لأرشفة نموذج تجميع بيانات العملاء المحتملين محدد، أرسل طلب POST إلى نقطة النهاية /page_id/leadgen_form_id تتضمن المعلمات التالية:

access_token يتم تعيينها على رمز وصول الصفحة
تعيين status على ARCHIVED

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON تحتوي على كائن مع تعيين success على true.

يمكن إعادة تنشيط نموذج مؤرشف عن طريق إرسال طلب مع تعيين status على ACTIVE.

إضافة نموذج إلى موقع الويب

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

التقييدات

يكون مربع الحوار هذا غير مدعوم في الأجهزة المحمولة.

لاحظ أنه لا يتم تضمين act_ في القيمة ad_account_id.

مثال على مجموعة SDK

استبدل القيم الغامقة والمائلة بالقيم المتوفرة لديك.


FB.ui({
  method: 'lead_gen',
  page_id: YOUR_PAGE_ID,
  ad_account_id: AD_ACCOUNT_ID, 
}, function(response) {
...
});

تتضمن استجابة الاستدعاء التي تتلقاها معلومات حول النموذج.

{
  follow_up_action_text: "YOUR_FOLLOW_UP_ACTION_TEXT",
  follow_up_action_url: "YOUR_FOLLOW_UP_ACTION_URL",
  formID: YOUR_FORM_ID,
  form_url: "YOUR_FORM_URL",
  is_tcpa_compliant: false,
  name: "YOUR_FORM_NAME",
  pageID: YOUR_PAGE_ID,
  privacy_policy_url: "YOUR_PRIVACY_POLICY_URL",
  status: "success"
}

خصائص الاستجابة

الاسم	الوصف
`custom_disclaimer_responses`string (سلسلة)	الاستجابات لمربعات اختيار إخلاء المسؤولية المخصصة
`follow_up_action_text`string (سلسلة)	شرح توضيحي لنص إجراء المتابعة الذي يظهر على الشاشة النهائية للنموذج
`follow_up_action_url`string (سلسلة)	وجهة نص إجراء المتابعة الذي يظهر على الشاشة النهائية للنموذج
`formID`string (سلسلة)	مطلوب. معرف النموذج
`form_url`string (سلسلة)	عنوان URL للنموذج
`name`string (سلسلة)	اسم النموذج
`pageID`string (سلسلة)	معرف الصفحة التي ينتمي إليها هذا النموذج
`privacy_policy_url`string (سلسلة)	عنوان URL لسياسة الخصوصية المقدمة
`status`string (سلسلة)	يتم إرجاع القيمة `success` عند الانتهاء من إنشاء النموذج

في حالة إلغاء الإنشاء، سيظهر ما يلي:

{
  error_code: 4201,
  error_message: "User canceled the Dialog flow"
}

راجع أيضًا

تفضل بزيارة الدلائل الأخرى لمعرفة المزيد حول مكونات هذا المستند.

نماذج تجميع بيانات العملاء المحتملين للإعلانات

قبل البدء

الخطوة الأولى. إنشاء حملة إعلانية

مثال على الطلب

الخطوة الثانية. إنشاء مجموعة إعلانية

مثال على الطلب

الخطوة الثالثة. إنشاء نموذج لتجميع بيانات العملاء المحتملين

مثال على الطلب

النماذج في المحادثات على Messenger

مثال على طلب نموذج تجميع بيانات العملاء المحتملين المؤهل في Messenger

أنواع الأسئلة الإضافية

تحديد الموعد

معرف الهوية القومية

التقييدات

محدد موقع المتجر

إعدادات النموذج المتقدمة

إضافة إعداد تتبع الأداء

مثال على الطلب

إضافة إعداد النية الأعلى

مثال على الطلب

فلترة العملاء المحتملين من الوصول العادي

مثال على الطلب

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

الخطوة الرابعة. إنشاء تصميم إعلان

مثال على الطلب

تصميم يحتوي على إعلان دوّار

تصميم يتضمن فيديو

مثال على استجابة تصميم الإعلان

الخطوة الخامسة. إنشاء الإعلان

مثال على طلب تصميم يحتوي على إعلان

الخطوة السادسة. نشر الإعلان

إدارة النموذج

الحصول على قائمة بالنماذج

مثال على الطلب

الحصول على قائمة بالنماذج المؤهلة في Messenger

مثال على الطلب

الحصول على قائمة بالأسئلة

مثال على الطلب

أرشفة النموذج

مثال على الطلب

إضافة نموذج إلى موقع الويب

التقييدات

مثال على مجموعة SDK

خصائص الاستجابة

راجع أيضًا

وثائق مطوّري API التسويق

مركز مساعدة الأعمال من Meta