إعلانات الفيديو والإعلانات الدوّارة

يمكنك بسهولة إنشاء إعلانات الفيديو والإعلانات الدوّارة وقياسها وتحسينها على فيسبوك باستخدام API. ويمكنك الرجوع إلى Facebook للأعمال، الإعلانات الدوّارة. لمعرفة تنسيقات الفيديو المدعومة للإعلانات، يمكنك الرجوع إلى مركز مساعدة المُعلنين، مقاطع الفيديو.

إعلانات الفيديو

لإنشاء إعلان فيديو في هدف VIDEO_VIEWS وتحسين عرض الأسعار من أجل الوصول، اتبع هذه الخطوات:

• الخطوة الأولى: توفير تصميمات الإعلانات
• الخطوة الثانية: إنشاء الحملة الإعلانية
• الخطوة الثالثة: إنشاء المجموعة الإعلانية
• الخطوة الرابعة: إنشاء الإعلان

الخطوة الأولى: توفير تصميمات الإعلانات

أنشئ إعلان فيديو باستخدام معرف فيديو حالٍ وفيديو تم تحميله على فيسبوك.

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

• الإذنان pages_read_engagement وads_management
• فيديو تم تحميله على نقطة النهاية act_{ad-account-id}/advideos

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

عرض شرائح

لتوسيع نطاق الحملات الإعلانية للعلامات التجارية أو بدء تشغيلها على الهواتف محدودة المزايا في الأسواق الناشئة أو لإنشاء فيديو بسيط، يمكنك تجربة عروض شرائح الصور (تحتاج إلى 3 صور على الأقل). قم بتحميل الصور إلى أحد أصول الفيديو. على سبيل المثال:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

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

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

قم بتعيين الهدف على VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

يمكنك الرجوع إلى المرجع: الحملة الإعلانية وAdObjectives بلغة PHP وAdObjectives بلغة Python

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

إذا كان هدفك هو تحقيق أقل تكلفة لكل مشاهدة، فيجب عليك إقران هدف الحملة الإعلانية لمشاهدة الفيديو مع optimization_goal=THRUPLAY لمجموعة إعلانية. ويمكنك تعيين bidding_event إلى IMPRESSIONS أو THRUPLAY للدفع لكل مرة ظهور أو لكل مشاهدة فيديو. كما يمكنك الرجوع إلى عرض أسعار التكلفة لكل مشاهدة.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

تقل أسعار التكلفة لكل مشاهدة للمجموعات الإعلانية التي تتضمن optimization_goal=THRUPLAY مقارنة بأسعار التكلفة لكل مشاهدة من نوع شراء الوصول وتكرار الظهور الذي تم تحسينه لمشاهدات الفيديو. يجب أن يكون تاريخ الانتهاء في المستقبل. يمكنك الرجوع إلى المرجع: المجموعة الإعلانية.

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

استخدم مجموعة إعلانية وتصميم إعلان موجود:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

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

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}
    

يمكنك الرجوع إلى مدير الإعلانات: حملاتي الإعلانية والمرجع: الإعلان.

مثال على الوعي بالعلامة التجارية

لإنشاء إعلان فيديو بهدف الوعي بالعلامة التجارية، يمكنك الرجوع إلى مدونة الوعي بالعلامة التجارية.

مثال على الوصول وتكرار الظهور

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

يمكنك متابعة إنشاء مشاهدات الفيديو، ولكن قم بتطبيق الوصول وتكرار الظهور على مجموعتك الإعلانية. وحدد هذه المعلمات الإضافية:

-F "rf_prediction_id=<RESERVATION_ID>" \

فيديو من أجل الاستجابة المباشرة

لتشجيع الأشخاص على الانتقال من الوعي إلى اتخاذ الإجراء، يمكنك الرجوع إلى تصميم الفيديو بتنسيق الإعلان الدوّار.

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

إعادة التسويق

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

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

بالنسبة للجمهور، قم بتعيين subtype=ENGAGEMENT. وبعد ذلك، أدخل قواعد للجمهور الذي تريد إنشائه. ويتوفر لدى كل قاعدة المعرف object_id، مثل معرف الفيديو، وكذلك الاسم event_name. كما يمثل الاسم event_name واحدًا مما يلي:

• video_watched: يمثل عدد مرات مشاهدة الفيديو لمدة 3 ثوانٍ على الأقل إجمالًا، أو مشاهدة إجمالي مدة الفيديو تقريبًا، أيهما يحدث أولًا.
• video_completed: عدد مرات مشاهدة الفيديو بنسبة 95% من مدته، بما في ذلك المشاهدات التي تم تخطيها إلى هذه النقطة.
• video_view_10s: يمثل عدد مرات مشاهدة الفيديو لمدة 10 ثوانٍ على الأقل إجمالًا، أو مشاهدة إجمالي مدة الفيديو تقريبًا، أيهما يحدث أولًا.
• video_view_15s: يمثل عدد مرات مشاهدة الفيديو لمدة 15 ثانية على الأقل إجمالًا، أو مشاهدة إجمالي مدة الفيديو تقريبًا، أيهما يحدث أولًا.
• video_view_25_percent: عدد مرات مشاهدة الفيديو بنسبة 25% من مدته، بما في ذلك المشاهدات التي تم تخطيها إلى هذه النقطة.
• video_view_50_percent: يمثل عدد مرات مشاهدة الفيديو بنسبة 50٪ من مدته، بما في ذلك المشاهدات التي تم تخطيها إلى هذه النقطة.
• video_view_75_percent: يمثل عدد مرات مشاهدة الفيديو بنسبة 75٪ من مدته، بما في ذلك المشاهدات التي تم تخطيها إلى هذه النقطة.

يمكنك تجميع مقاطع الفيديو لإنشاء جمهور استنادًا إلى مجموعة متنوعة من مقاطع الفيديو والإجراءات. فعلى سبيل المثال، يمكن أن يتضمن الجمهور مشاهدات فيديو لمدة 3 ثوانٍ من الفيديو أ، ومشاهدات فيديو مكتملة من الفيديو ب وج.

يؤدي ذلك إلى إنشاء جمهور من مشاهدي الفيديو 1 خلال مدة 14 يومًا الماضية لمدة تزيد عن 3 ثوان، وجمهور من مشاهدي الفيديو 2 بالكامل. يقوم الجمهور أيضًا بملء المشاهدين تلقائيًا قبل إنشاء الجمهور من خلال prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

يتم دعم إعادة التعبئة لمشاهدات الفيديو اعتبارًا من 16 أكتوبر 2015.

دعوة لاتخاذ إجراء

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

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

لا يمكنك استخدام فيديو مع أزرار الدعوة لاتخاذ إجراء إلا في أهداف الحملات الإعلانية التالية:

• PAGE_LIKES
• LEAD_GENERATION
• LOCAL_AWARENESS
• LINK_CLICKS
• CONVERSIONS
• APP_INSTALLS
• VIDEO_VIEWS
• BRAND_AWARENESS
• التفاعل مع تطبيق الهاتف المحمول

راجع توسيع نطاق الفيديو ليتضمن أهدافًا إضافية. ويؤدي ذلك إلى إنشاء إعلان فيديو من خلال الدعوة لاتخاذ إجراء GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

أدوات قياس إعلانات الفيديو

رؤى حول منشور الفيديو، مجاني

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

رؤى حول إعلان الفيديو، مدفوع

استخدم واجهة API رؤى الإعلانات. تحتوي الاستجابة على العديد من أدوات قياس الفيديو.

نوع الفيديو

يمكنك استرداد إحصائيات إعلان الفيديو مُجمّعة حسب نوع الفيديو، مثل التشغيل التلقائي أو النقر للتشغيل. قم بتضمين النوع action_video_type في action_breakdowns. علمًا بأن القيم المتوقعة للنوع action_video_type هي total وclick_to_play وauto_play.

نجري حاليًا اختبارًا محدودًا للخيار action_video_type. ولتحديد العملاء باستخدام التقسيم، تحقق من CAN_USE_VIDEO_METRICS_BREAKDOWNللحساب الإعلاني.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

تحتوي الاستجابة على كائنات تتضمن action_type كنوع video_view، وتحتوي على نوع action_video_type أساسي:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

يمكنك الرجوع إلى واجهة API رؤى الإعلانات

الإعلانات الدوّارة

احصل على المزيد من عناصر التصميم المتعلقة بالعقارات في الموجز وشجع الأشخاص على زيارة موقعك على الويب أو تطبيقك على الهواتف المحمولة من أجل التحويل. ويمكنك إنشاء إعلان دوّار بطريقتين:

• إنشاء إعلان ومنشور صفحة لم يتم نشره في استدعاء واحد: واجهة API تصميم الإعلان.
• إنشاء منشور صفحة لم يتم نشره، ثم إنشاء تصميم إعلان باستخدام المنشور (غير متوفر في إعلانات الفيديو الدوّارة).

الإعلانات الدوّارة غير مدعومة في Facebook Stories.

إنشاء مُضمن

أنشئ منشور صفحة لإعلان دوّار أثناء إنشاء تصميم إعلان. وحدد محتوى منشور الصفحة في object_story_spec الذي ينشئ منشور صفحة لم يتم نشره من adcreatives. يمكنك الرجوع إلى تصميمات الإعلانات. على سبيل المثال:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

تكون الاستجابة عبارة عن معرف تصميم:

{"id":"<CREATIVE_ID>"}

إنشاء منشور، ثم إعلان

أنشئ منشور صفحة لم يتم نشره. حيث يكون child_attachments عبارة عن مصفوفة من كائنات الروابط. في كل كائن رابط، تتوفر الصورة picture والاسم name والوصف description اختياريًا. ويمكنك نشر ذلك بواسطة الصفحة باستخدام رمز وصول الصفحة فقط.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

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

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

إنشاء إعلان فيديو دوّار

يمكن أن تحتوي إعلانات الفيديو الدوّارة على 'شرح توضيحي' في المرفق الفرعي لتخصيص عنوان URL الخاص بالعرض في الشاشة النهائية:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

للحصول على تفاصيل حول المرفقات الفرعية، يمكنك استخدام المعرف واستدعاء واجهة Graph API، الفيديو، المرجع.

إنشاء إعلان لتطبيق الهاتف المحمول

التقييدات:

• تدعم الإعلانات الدوّارة لتطبيقات الهواتف المحمولة تطبيقًا واحدًا فقط
• يمكن استخدام ثلاث صور كحد أدنى مقارنةً بصورتين بالنسبة للإعلانات الدوّارة في الإعلانات خارج التطبيقات
• يجب أن تتضمن إعلانات تطبيقات الهواتف المحمولة زر الدعوة لاتخاذ إجراء
• لن تظهر بطاقة الإنهاء، والتي تعرض عادة صورة الملف الشخصي للصفحة،, بالنسبة للإعلانات الدوّارة لتطبيقات الهواتف المحمولة. لاحظ أنه يجب تحديد رابط متجر التطبيقات نفسه في كل child_attachment. لا تحتاج إلى تحديد الرابط مجددًا في call_to_action:{'value':{'link':... }}}

على سبيل المثال، لإنشاء إعلان دوّار لعمليات تثبيت تطبيقات الهواتف المحمولة:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

يمكنك فقط نشر منشورك باسم صفحة فيسبوك المرتبطة بتطبيقك على الهاتف المحمول. ويجب عليك استخدام رمز وصول الصفحة.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

استخدم المعرف id من الاستجابة لإنشاء AdCreative:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

مواصفات الحقل

فيما يلي إعلان دوّار على نظام iOS يعرض كيفية استخدام الحقول الموضحة.

إحصائيات الإعلانات لكل منتج

يمكنك تجميع الإجراءات للإعلانات الدوّارة حسب كل منتج باستخدام actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. يحتوي كل child_attachment على معرف بطاقة مختلف. ولا يتم استخدام action_carousel_card_id وaction_carousel_card_name إلا مع الإعلانات الدوّارة فقط.

يمكنك الحصول على الإحصائيات التالية لكل بطاقة:

• website_ctr: يتوفر عند تحديد fields=['website_ctr']
• app_install وapp_use وapps.uses وcredit_spent وmobile_app_install وtab_view وlink_click وmobile_app_install وapp_custom_event.* وoffsite_conversion.*: يتوفر عند تحديد fields=['actions']. لا تتوفر الإجراءات الأخرى مع تقسيم البطاقة.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

الاستجابة:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

يمكنك أيضًا طلب cost_per_action_type لتقسيم التكاليف حسب نوع الإجراء:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

عينة من الاستجابة:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

المواضع

إذا قمت بتحديد right_hand_column فقط ليكون الموضع، فيمكنك فقط استخدام تنسيق دوّار أو فيديو واحد في مجموعة الإعلانات لديك. ولا ندعم تنسيق الفيديو عند تحديد موضع right_hand_column فقط. ويمكنك الرجوع إلى الاستهداف المتقدم والموضع.

فعلى سبيل المثال، يمكنك إنشاء مجموعة إعلانية باستخدام right_hand_column كموضعك الوحيد:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

قم بتوفير تصميم إعلان يتضمن فيديو:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

أو قم بتوفير تنسيق إعلان اللوحة لتصميم الإعلان:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

إذا حاولت إنشاء إعلان مع المجموعة الإعلانية وتصميم الإعلان:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

في حالة الحصول على رمز خطأ، يجب توفير تصميم مدعوم أو تغيير الاستهداف.

راجع أيضًا

• تحميل مقاطع الفيديو إلى دليل فيسبوك
• الإعلانات الدوّارة لتطبيقات الهواتف المحمولة
• مرجع Graph API موجز الصفحات
• منشورات صفحة لم يتم نشرها
• تصميمات الإعلانات
• الإعلانات الدوّارة في Instagram