إعلانات النقر لفتح محادثة في Messenger

إعلانات النقر لفتح محادثة في Messenger

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

• access_token
• name
• object_story_spec تتضمن كائن *_data يحدد نوع الوسائط

المرجع السريع لإعلان الصورة

مثال على طلب إعلان الصورة

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"page_access_token",
           "name":"Your_CTM_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": { 
               "page_welcome_message": "Your_welcome_message",
               "image_hash": "Your_image_hash", 
               "link": "Your_image_URL", 
               "call_to_action": {
                 "type":"LEARN_MORE",
                 "value":{ "app_destination":"MESSENGER" }
               }   
             }
           }
         }'          

المرجع السريع لإعلان الفيديو للنقر لفتح محادثة في Messenger

مثال على طلب إعلان الفيديو

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTM_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "video_data": { 
               "call_to_action": {
                 "type": "LEARN_MORE",
                 "value": { "app_destination": "MESSENGER" }
               },
               "link_description": "Your_link_description",
               "image_url": "Your_thumbnail_URL", 
               "page_welcome_message": "Your_welcome_text",
               "video_id": "video_id"
             } 
           }
         }'

الإعلان الذي يستخدم دفق مراسلة تم تكوينه على تطبيق شريك

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTM_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "link_data": { 
               "image_hash": "your_image_hash",
               "link": "your_image_URL",
               "call_to_action": {
                 "type": "MESSAGE_PAGE",
                 "value": { "app_destination":"MESSENGER" }
               }   
             }
           },
           "asset_feed_spec": {
             "additional_data": {
               "partner_app_welcome_message_flow_id": "FLOW-ID"
             }
           }
         }'

لمزيد من المعلومات حول تدفقات تطبيقات المراسلة، راجع تدفقات الرسائل الترحيبية في وثائق منصة Messenger.

النقر للاشتراك

إعلانات النقر للاشتراك (CTS) هي إعلانات النقر لفتح محادثة في Messenger حيث تكون object_story_spec.page_welcome_message مصفوفة من الكائنات تتضمن قالب رسالة إشعار. عندما ينقر الشخص على زر الحصول على الرسائل في الإعلان، يوافق الشخص بذلك على تلقي الرسائل التسويقية من النشاط التجاري.

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

• access_token
• name
• object_story_spec يتضمن كائن

  • *_data يحدد نوع الوسائط
  • مصفوفة page_welcome_message التي تحدد طلب الاشتراك في الرسائل التسويقية. يجب تضمين landing_screen_type مع التعيين على marketing_messages ومرفق الرسالة payload.template_type مع التعيين على nofitication_messages

مثال على طلب إعلان الصورة

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTS_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "link_data": { 
               "image_hash": "Your_image_hash", 
               "link": "Your_image_URL", 
               "call_to_action": {
                 "type": "LEARN_MORE",
                 "value":{ "app_destination": "MESSENGER" }
               }
               "page_welcome_message": "{
                 "landing_screen_type": "marketing_messages",
                 "media_type": "image",
                 "image_format": {
                   "customer_action_type": "buttons",
                   "message": {
                     "text": "Your_welcome_message",
                     "attachment": {
                       "type": "template",
                       "payload":{
                         "template_type":"notification_messages",
                         "elements": [{
                             "title": "Your_CTS_title",
                             "subtitle": "Your_CTS_subtitle",
                             "image_url": "Your_image_URL",
                             "app_id": "Your_Meta_app_ID",
                             "buttons": [{
                               "type": "postback",
                               "payload": "Data_to_include_in_webhook_notification",
                               "title": "Get messages"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'          

إعلانات تجميع بيانات العملاء المحتملين في المحادثات

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

متطلبات قالب الرسالة

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

التقييدات

• لا يمكن تعديل قوالب الرسائل أو حذفها بمجرد إنشائها

إنشاء قالب رسالة

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

• access_token
• privacy_url
• مصفوفة step_list التي تتضمن message وreply_type وstep_id وstep_type
• template_name
• reminder_text

يتضمن قالب الرسالة التالي template_name وprivacy_url وstep_list مع رسالة ترحيبية في step_id: 0 وأسئلة في step_id: 1 إلى 4 ورسالة تأكيد في step_id: 5 ورسالة الاستبعاد في step_id: 6.

المرجع السريع لقالب الرسالة

مثال على قالب رسالة تجميع بيانات العملاء المحتملين

curl -X POST "https://graph.facebook.com/v19.0/your_page_ID/messenger_lead_forms"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "privacy_url": "Your_privacy_policy_URL",
           "reminder_text": "Your_reminder_text",
           "template_name": "Your_template_name",
           "step_list": [
             {
               "step_id": "0",
               "message": "Your_welcome_message",
               "step_type": "INTRO",
               "reply_type": "NONE",
               "next_step_ids": "1"
             },
             {
               "step_id": "1"
               "message": "Are_you_interested_in_our_products_or_services?",
               "step_type": "QUESTION",
               "reply_type": "QUICK_REPLIES",
               "answers": ["Yes", "Not now", "Maybe"],
               "next_step_ids": [2,6,2],
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "2",
               "message": "What city do you live in?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "CITY",
               "next_step_ids": "3",
               "allow_to_skip": true
             },
             {
               "step_id": "3",
               "message": "What is your phone number?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "PHONE",
               "next_step_ids": "4",
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "4",
               "message": "What is your email address?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "EMAIL",
               "next_step_ids": "5",
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "5",
               "message": "Your_confirmation_message",
               "step_type": "CONFIRMATION",
               "reply_type": "NONE"
             },
             {
               "step_id": "6",
               "message": "Your_disqualification_message",
               "step_type": "DISQUALIFY",
               "reply_type": "NONE"
             }
           ]
        }'

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

{
  "id": "your_messenger_lead_gen_template_id"
}

يتم إنشاء fblead_form أيضًا وربطه بقالب الرسالة كجزء من هذه العملية.

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

للحصول على قائمة قوالب نموذج تجميع بيانات العملاء المحتملين في Messenger، يمكنك إرسال قالب GET إلى نقطة النهاية /page_id/messenger_lead_forms. يمكنك أيضًا الحصول على معلومات حول قالب محدد عن طريق إرسال طلب GET إلى نقطة النهاية /Your_messenger_lead_gen_template_id.

أمثلة على تصميم الإعلان

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

• access_token
• name
• object_story_spec مع الكائن *_data الذي يحدد نوع الوسائط، صورة أو فيديو، ويحتوي على ما يلي:

  • المعلمة *_data.page_welcome_message مع تعيينها إلى زوج القيمة الرئيسية

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

مثال على تصميم إعلان لإعلانات تجميع بيانات العملاء المحتملين التي تتضمن صورة على Messenger

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
    -H "Content-Type: application/json" 
    -d '{
          "access_token": "Your_page_access_token",
          "degrees_of_freedom_spec": {
            "creative_features_spec": {
              "standard_enhancements": { "enroll_status": "OPT_IN" }
            }
          },
          "name": "Your_lead_ad_image_ad_name",
          "object_story_spec": {
            "page_id": "Your_page_id",
            "link_data": {
              "call_to_action": {
                "type": "MESSAGE_PAGE",
                "value": { "app_destination": "MESSENGER" }
              },
              "description": "Sample_description",
              "image_hash": "Your_image_hash", 
              "message": "Sample_message_for_Creative",
              "page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }"
            }
          }
       }' 

مثال على تصميم إعلان لإعلانات تجميع بيانات العملاء المحتملين التي تتضمن فيديو على Messenger

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
    -H "Content-Type: application/json" 
    -d '{
          "access_token": "Your_page_access_token",
          "degrees_of_freedom_spec": {
            "creative_features_spec": {
              "standard_enhancements": { "enroll_status": "OPT_IN" }
            }
          },
          "name": "Your_lead_ad_video_ad_name",
          "object_story_spec": {
            "page_id": "your_page_id",
            "video_data": { 
              "call_to_action": {
                "type": "MESSAGE_PAGE",
                "value":{ "app_destination": "MESSENGER" }
              },
              "image_url": "Your_thumbnail_url", 
              "link_description": "Your_link_description ",
              "message": "Sample message for Creative ",
              "page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }",
              "video_id": "Your_video_id" 
            }
          }
       }' 

الرسائل المُموَّلة

تمثل الرسائل المُموَّلة أحد أنواع الإعلانات التي يمكن إرسالها إلى أي حساب مركز الحسابات لديه محادثة على Messenger موجودة مع صفحة النشاط التجاري على فيسبوك. يمكنك أيضًا تضمين معايير استهداف أخرى، مثل المعلومات الديموغرافية أو البيانات الجغرافية أو الجماهير المخصصة أو الاهتمامات. المتطلبات لا تستخدم الجماهير المخصصة لاستبعاد المستخدمين من تلقي الرسائل المُموَّلة يجب أن يكون targeting.publisher_platformsmessenger فقط يجب أن يكون targeting.messenger_positionssponsored_messages فقط يجب أن يكون targeting.device_platforms كلاً من mobile وdesktop يجب أن يكون promoted_object معرف صفحة النشاط التجاري على فيسبوك يتعين عليك تحديد حمولة بيانات أو عنوان URL للزر يجب توفير خيارات ضمن المحادثة لإلغاء الاشتراك في تلقي الرسائل أو حظر الرسائل على كل من أجهزة الكمبيوتر أو الهاتف المحمول. التقييد لا يتم دعم إلا التكلفة لكل ألف ظهور مع billing_event=IMPRESSIONS وoptimization_goal=IMPRESSIONS. يختلف الحد الأدنى لعرض الأسعار حسب البلد. معرفة المزيد. لا يتم دعم إلا النص أو الصور التي تتضمن أزرار أو الردود السريعة.

لإنشاء تصميم إعلان لرسالة مُموَّلة، يجب أن يتضمن الطلب المعلمة object_id مع التعيين إلى معرف صفحة فيسبوك، وتعيين object_type على SHARE والكائن messenger_sponsored_message مع تعيين المعلمة message.text على النص للإعلان والكائن message.attachment بالمعلمات التالية:

المرجع السريع لمرفق الرسالة المُموَّلة على Messenger

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

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "attachment":{
                 "type":"template",   
                 "payload":{
                   "template_type":"generic", 
                   "elements":[{
                     "title":"Your_image_text",
                     "image_hash":"Your_image_hash",
                     "buttons":[{
                       "type":"web_url", 
                       "title":"Your_button_text", 
                       "url":"Your_destination_URL"
                     }]
                   }]
                 }
               }
             }
           }
         }'

مثال على طلب تصميم إعلان الرد السريع

لإنشاء رسالة مُموَّلة تتضمن رسالة الردود السريعة، قم بتعيين الكائن messenger_sponsored_message.message مع تعيين text إلى سؤال أو توجيه ومصفوفة quick_replies لكل خيار الرد السريع.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "quick_replies":[
                 {
                   "content_type": "text",
                   "title": "Your_reply_first_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_1_is_selected"
                 },
                 {
                   "content_type": "text",
                   "title": "Your_reply_second_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_2_is_selected"
                 }
               ]              
             }
           }'