يشرح هذا الدليل طريقة إنشاء إعلانات النقر لفتح محادثة في Messenger ونشرها باستخدام API التسويق.
إذا كنت ترغب في استخدام مدير الإعلانات لإنشاء حملة لإعلانات تجميع بيانات العملاء المحتملين، فيمكنك زيارة مركز مساعدة الأعمال من Meta.
تعمل الإعلانات النقر لفتح محادثة في Messenger على توجيه الأشخاص الذين يقومون بالنقر على إعلاناتك إلى بدء محادثات مع نشاطك التجاري مباشرةً على Messenger. استخدم هذه الإعلانات للوصول إلى الأشخاص على نطاق واسع وتقديم خدمة مميزة حسب حاجة الشخص.
تدعم إعلانات النقر لفتح محادثة في Messenger الإعلانات التي تتضمن صورة أو فيديو أو إعلانًا دوّارًا أو عرض شرائح. كما يمكنك أيضًا تضمين مطالبات الاستدعاءات في الإعلان.
إذا كنت مهتمًا بإنشاء الإعلانات التي ترسل الأشخاص إلى دردشات Instagram أو واتساب، فراجع إعلانات النقر لفتح محادثة في Instagram أو إعلانات النقر لفتح محادثة في واتساب للحصول على الإرشادات. كما يمكنك أيضًا إنشاء الإعلانات التي تحدد الوجهة التي من المرجح أن يستجيب المستخدم منها، راجع إعلانات النقر للانتقال إلى وجهات متعددة للحصول على المزيد من المعلومات.
لإنشاء إعلان ونشره، ستحتاج إلى ما يلي:
يفترض هذا الدليل أنه:
لإجراء استدعاءات ناجحة لكل نقاط النهاية في هذا الدليل، ستحتاج إلى ما يلي:
ADVERTIZE
في الصفحةads_management
pages_manage_ads
pages_read_engagement
pages_show_list
لإنشاء حملة إعلانية، أرسل طلب POST
إلى نقطة النهاية act_ad_account_id/campaigns
حيث يكون ad_account_id هو معرف حساب Meta الإعلاني. يجب أن يتضمن طلبك:
|
|
المرجع السريع للحملة الإعلانية
curl -X POST "https://graph.facebook.com/v21.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":"OUTCOME_TRAFFIC",
"status":"PAUSED",
"special_ad_categories":["NONE"],
}'
عند النجاح، يتلقى التطبيق استجابة JSON تتضمن معرف الحملة الإعلانية.
{ "id": "campaign_id" }
لإنشاء مجموعة إعلانية، أرسل طلب POST
إلى نقطة النهاية act_ad_account_id/adsets
حيث يكون ad_account_id هو معرف حساب Meta الإعلاني. يجب أن يتضمن طلبك:
access_token
bid_amount
billing_event
إلى IMPRESSIONS
campaign_id
daily_budget
destination_type
على MESSENGER
name
optimization_goal
على CONVERSATIONS
أو IMPRESSIONS
أو LEAD_GENERATION
أو QUALITY_LEAD
لإعلانات تجميع بيانات عملاء محتملينpromoted_object
– يتم تعيينها على المعرف في صفحة النشاط التجاري على فيسبوك.status
على PAUSED
targeting
المرجع السريع للحملة الإعلانية
curl -X POST "https://graph.facebook.com/v21.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",
"destination_type":"MESSENGER",
"name:"Your_messenger_adset_name",
"optimization_goal:IMPRESSIONS",
"status:PAUSED",
"targeting":{
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"],
"publisher_platforms": ["messenger"]
}
}'
عند النجاح، يتلقى التطبيق استجابة JSON التالية تتضمن معرف المجموعة الإعلانية.
{ "id": "adset_id" }
يسمح لك تصميم الإعلان بإضافة الأصول إلى الإعلانات.
التقييدات
|
لإنشاء مجموعة إعلان، أرسل طلب POST
إلى نقطة النهاية /act_ad_account_id/adcreatives
حيث يكون ad_account_id هو معرف حساب Meta الإعلاني. يجب أن يتضمن طلبك:
access_token
name
object_story_spec
– مطلوبprivacy_url
– مطلوب لإعلانات تجميع بيانات عملاء محتملينstandard_enhancements.enroll_status
– مطلوب لتصاميم الإعلانات المؤهلة للتحسينات القياسية. مرجع سريع لمعلمة تصميم الإعلان عالي المستوى
لإنشاء تصميم إعلان النقر لفتح محادثة في 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/v21.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/v21.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/v21.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.
الرسالة الافتراضية التي يتم عرضها للعميل هي "مرحبًا! هل يمكنني الحصول على المزيد من المعلومات حول ذلك؟". يمكنك إنشاء المزيد من تجارب المستخدمين المخصصة لإعلانات النقر لفتح محادثة في Messenger عن طريق تخصيص الرسالة الترحيبية وأدوات التفاعل ورسائل الملء التلقائي للإعلانات في الحقل page_welcome_message
ضمن object_story_spec
.
لمزيد من المعلومات حول أدوات التفاعل، راجع مرجع ice_breakers
.
أنشئ كائن page_welcome_message
لإضافة أدوات التفاعل مع رسالة ترحيبية.
"page_welcome_message": { "type":"VISUAL_EDITOR", "version":2, "landing_screen_type":"welcome_message", "media_type":"text", "text_format":{ "customer_action_type":"ice_breakers", "message":{ "ice_breakers":[ {"title":"Can I make a purchase?","response":"This is a response 1"}, {"title":"Can I see a menu?", "response":"This is a response 2"}, {"title":"Where are you located?", "response":"This is a response 3"}], "quick_replies":[], "text":"Hi {{user_first_name}}! Please let us know how we can help you."} }, "user_edit":false, "surface":"visual_editor_new" }
إعلانات النقر للاشتراك (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/v21.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 بتجميع بيانات العملاء المحتملين عبر قالب الدردشة التلقائية. يمكنك طرح أسئلة محددة على الأشخاص المهتمين بالنشاط التجاري مباشرةً في منصة المراسلة المفضلة وتجميع تفضيلات العملاء وطرح الأسئلة المخصصة لإعطاء أولوية لبيانات العملاء المحتملين الأكثر تأهيلاً.
قبل أن تتمكن من إنشاء تصاميم الإعلانات لإعلانات Messenger لتجميع بيانات العملاء المحتملين، عليك قبول شروط وأحكام إعلانات 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/v21.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
curl -X POST "https://graph.facebook.com/v21.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" }"
}
}
}'
curl -X POST "https://graph.facebook.com/v21.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"
}
}
}'
يُرجى الرجوع إلى استخدام المنشورات كإعلانات Instagram لمزيد من التفاصيل.
curl -X POST \
-F 'name=Sample ad creative from Instagram post' \
-F 'object_id=<PAGE_ID>' \
-F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
-F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
-F 'call_to_action={
"type": "INSTAGRAM_MESSAGE",
"value": {
"link": "https://www.instagram.com"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
curl -X POST \
-F 'name=Sample ad creative from Instagram image' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
"link_data": {
"message": "<AD_PRIMARY_TEXT>",
"picture": "<IMAGE_URL>"
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT"
}
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
راجع استخدام المنشورات كإعلانات Instagram: منشورات فيسبوك لمزيد من التفاصيل.
curl -i -X POST \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives
?object_story_id=<postOwnerID_postID>
&instagram_actor_id=<IG_USER_ID>
&call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
&access_token=<ACCESS_TOKEN>"
حيث يكون object_story_id
هو معرف المنشور بتنسيق postOwnerID_postID
ويكون instagram_actor_id
إما معرف حساب Instagram المتصل بالصفحة أو معرف حساب Instagram المدعوم بالصفحة. راجع المزيد من التفاصيل في إعداد حسابات Instagram بالصفحات.
لإنشاء الإعلان، تحتاج إلى ربط تصميم الإعلان والمجموعة الإعلانية. لإنشاء الإعلان، أرسل طلب POST
إلى نقطة النهاية /act_ad_account_id/ads
حيث يكون ad_account_id هو معرف حساب Meta الإعلاني. يجب أن يتضمن طلبك:
access_token
adset_id
(من الخطوة الثانية)creative_id
(من الخطوة الثالثة)name
status
المرجع السريع لإعلانات الحساب الإعلاني
curl -X POST "https://graph.facebook.com/v21.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": "ad_id" }
يمكنك أيضًا تعيين زر دعوة لاتخاذ إجراء عند إنشاء الإعلان.
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
تحقق من وجود إعلانك في مدير الإعلانات . انقر على زر المراجعة والنشر في أعلى الجانب الأيسر. حدّد الحملة الإعلانية والمجموعة الإعلانية للحملة الإعلانية والإعلان.
يمكنك نشر الإعلان من مدير الإعلانات أو باستخدام API. للنشر باستخدام API، كرّر الخطوة الرابعة مع تعيين المعلمة status
على ACTIVE
.
ستتم مراجعة الإعلان من خلال Meta وستكون الحالة PENDING_REVIEW
. بمجرد الموافقة، ستكون الحالة ACTIVE
وسيتم عرض الإعلان.
يمكنك إنشاء الرسائل التي تتضمن المزيد من عنصر رسالة واحد، مثل مطالبة مكالمة أو قوالب متعددة. ستضيف هذه العناصر عن طريق تعيين مصفوفة من الكائنات للقيمة *_data.page_welcome_message
بدلاً من قيمة سلسلة.
المرجع السريع لمصفوفة صفحة الرسالة الترحيبية
يمكنك إضافة مطالبة مكالمة إلى إعلان النقر لفتح محادثة في Messenger من خلال تعيين القيمة *_data.page_welcome_message
إلى مصفوفة من الكائنات التي تحدد عناصر مطالبة المكالمة. قم بتعيين المعلمة landing_screen_type
إلى call_prompt
وmedia_type
إلى text
والكائن text_format.message
مع text
إلى نص الرسالة الترحيبية وقم بتعيين call_prompt_data.call_prompt_message
إلى مطالبة مكالمة النشاط التجاري.
... "page_welcome_message": "[ { "landing_screen_type": "call_prompt", "media_type": "text", "text_format": { "message": { "text": "Your_welcome_message", "call_prompt_data": { "call_prompt_message": "Your_call_prompt_message" } } }, } ]" ...
لإنشاء إعلان يتضمن قوالب متعددة، قم بتعيين المعلمة *_data.page_welcome_message
إلى مصفوفة بقالب رسالة يضيف المثال التالي قالبًا للرد السريع.
... "page_welcome_message": "[{ 'message': { 'text':' Your_question_or_directive ', 'quick_replies':[ { 'content_type':'text', 'title':' Option_1 ', 'payload':' Option_1_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_2 ', 'payload':' Option_2_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_3 ', 'payload':' Option_3_information_for_webhook ' } ] } }]", ...
إذا لم تقم بذلك بالفعل، فقم بإعداد أحداث webhooks للحصول على إشعارات عندما ينقر أحد الأشخاص على إعلانك.
تعرف على المزيد حول API التسويق والخيارات الإضافية لإعلانات النقر لفتح محادثة في Messenger.