‏API التسويق‏

إعلانات الاتصال من API التسويق من Meta

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

نظرة عامة على إنشاء الإعلان

لإنشاء إعلان ونشره، ستحتاج إلى ما يلي:

  1. إنشاء حملة إعلانية
  2. إنشاء مجموعة إعلانية تربط الإعلانات بالحملة الإعلانية
  3. إنشاء تصميم إعلان لإعلان للاتصال
  4. إنشاء إعلان من خلال ربط تصميم الإعلان بالمجموعة الإعلانية
  5. نشر الإعلان على فيسبوك وInstagram

قبل البدء

يفترض هذا الدليل أنك:

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

  • يجب توفير رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ المهمة 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/v19.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/v19.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"
}

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

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

لإنشاء مجموعة إعلان، أرسل طلب 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/v19.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/v19.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 التسويق