‏API التسويق‏

الإعلانات للاتصال

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

قبل البدء

يفترض هذا الدليل:

لإجراء استدعاءات ناجحة لكل نقاط النهاية في هذا الدليل، ستحتاج إلى ما يلي:

  • يجب توفير رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ المهمة ADVERTIZE في الصفحة
  • يجب منح الأذونات التالية للشخص الذي يستخدم التطبيق:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

التوصيات

تأكد من تعيين ساعات العمل للنشاط التجاري في إعدادات صفحة فيسبوك.

عند اختبار استدعاء API، يمكنك تضمين المعلمة access_token وتعيينها على رمز الوصول. مع ذلك، عند إجراء استدعاءات آمنة من التطبيق، استخدم فئة رمز الوصول.

التقييدات

  • يجب أن يكون عمر الجمهور المستهدف 18 عامًا أو أكثر
  • يجب أن يكون رقم الهاتف المضمن في زر الدعوة لاتخاذ إجراء من البلد ذاته الذي يتواجد فيه الجمهور المستهدف

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

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

  • name
  • objective - يتم التعيين على أحد الأهداف المدعومة التالية:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

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

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل ad_account_id بالقيم المتوفرة لديك.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

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

{
  "id": "campaign_id"
}

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

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

  • bid_amount
  • تعيين billing_event إلى IMPRESSIONS
  • campaign_id
  • daily_budget
  • تعيين destination_type على PHONE_CALL
  • name
  • تعيين optimization_goal على QUALITY_CALL لإعلانات الاتصال
  • targeting

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

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل ad_account_id بقيمك.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

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

{
  "id": "adset_id"
}

الخطوة الثالثة: إنشاء تصميم إعلان

يسمح لك تصميم الإعلان بإضافة الأصول إلى الإعلانات. يتم دعم الإعلان الدوّار وإعلانات الصورة والنصوص فقط والفيديو.

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

  • name
  • object_story_spec
  • object_story_spec مع الكائن link_data الذي يحدد call_to_action مع تعيين type على CALL_NOW وvalue كرقم الهاتف للنشاط التجاري

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

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_access_token بالقيم المتوفرة لديك.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

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

{
  "id": "ad_creative_id"
}

الخطوة الرابعة: إنشاء الإعلان

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

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

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل ad_account_id بالقيم المتوفرة لديك.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

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

{
  "id": "ad_id"
}

الخطوات التالية

تفضل بزيارة دليل بدء الاستخدام للتعرف على كيفية إرسال الإعلان للمراجعة.

معرفة المزيد

تعرف على المزيد حول API التسويق والخيارات الإضافية لإعلانات الاتصال.

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

API التسويق