الحجز

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

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

التقييدات

• متوفرة لحسابات إعلانية معينة. التحقق من معلمة CAN_USE_REACH_AND_FREQUENCYللحساب الإعلاني.
• يجب أن يقع stop_time للمجموعة الإعلانية في نطاق 180 يومًا من تاريخ التوقع.
• ترتبط الحسابات أيضًا بتقييدات تستند إلى البلدان؛ يمكنك التحقق من ذلك من خلال إرسال استدعاء API GET إلى https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
• يمكنك تعيين بلدًا واحدًا في المرة فقط إلى target_spec.
• لا يوجد حد أدنى لإصدار نظام التشغيل iOS بالنسبة إلى user_os، مثل iOS_ver_2.0_and_above.
• عند إنشاء حملة الحجز وتحديدها، لا يمكنك تعيين ميزانية الحملة كلها أو الميزانية اليومية، ولا حد الظهور طيلة مدة الحملة أو الظهور اليومي، ولا الحد الأقصى لتكرار ظهور الإعلان أو عرض الأسعار الخارجي، ولا الحقل PacingType.

ابحث في rf_spec للتعرف على القيود السارية:

تبدو النتائج كما يلي:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

إنشاء التوقعات

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

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

التقييدات

فيما يلي القيود الافتراضية للتوقعات:

• الجماهير المستهدفة التي تضم 300 ألف حساب على الأقل بمركز الحسابات.
• الحد الأدنى للوصول إلى 200 ألف حساب بمركز الحسابات.
• يجب تشغيل المجموعات الإعلانية لمدة يوم واحد بحد أدنى و90 يومًا بحد أقصى (يتم حساب عدد الأيام على أنها عدد الأيام التي تمتد خلالها الحملة الإعلانية. على سبيل المثال، إذا كانت الحملة الإعلانية تبدأ في الساعة 12:00 م من اليوم الأول وتنتهي الساعة 10:00 ص من اليوم الثاني، يتم اعتبار تشغيل الحملة الإعلانية أنه امتد على مدار يومين على الرغم من أن الفرق بين الساعات أقل من 24 ساعة).
• يجب أن يقع وقت إيقاف تشغيل المجموعة الإعلانية في نطاق 180 يومًا من تاريخ التوقع.
• يجب أن تنتهي الحملة الإعلانية بعد الساعة 6 ص في آخر يوم من أيام الحملة الإعلانية تبعًا للمنطقة الزمنية للحساب الإعلاني.

قراءة التوقعات

للحصول على التفاصيل حدد الحقول. لعرض كل reachfrequencyprediction لحساب ما، يجب إجراء طلب HTTP GET إلى https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

للوصول إلى كل reachfrequencyprediction استنادًا إلى معرف reachfrequencyprediction، يمكنك إجراء طلب HTTP GET يحتوي على الحقول التي تريدها: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

بشكل افتراضي، ترجع Meta المعرف. للحصول على تفاصيل الحقول، راجع توقع الحجز، القراءة.

رموز حالة الاستجابة

يعرض هذا نتائج status المحتملة في reachfrequencyprediction. يتم عرض القيود المبدئية في حالة توفرها، إلا أنها قد تتغير تبعًا للحساب الإعلاني أو حسب البلد في المستقبل:

استخدام التوقعات

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

إذا نجحت عملية الحجز، فسيتم حجز المخزون لك بشكل مؤقت. يُسمح لك بساعة تقريبًا بعد الحجز لتعيين إعلان إلى مجموعة إعلانية.

الحجز

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

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

لحجز مخزون استنادًا إلى التوقع، يمكنك إجراء استدعاء API POST إلى https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

بالنسبة إلى reach وbudget وimpression، يمكنك حجز توقع عند نقطة معينة على curve_budget_reach بدلاً من الهيكل الأصلي للميزانية/الوصول الخاص بالتوقع. استخدم الحقول التالية:

تحجز Meta التوقعات على نحوٍ غير متزامن؛ يجب عليك إجراء استطلاع والتحقق من حالة التوقع. تكون الحالة الأولية للتوقع هي 2 (PENDING). بعد الاكتمال، تكون الحالة إما 1 أو SUCCESS أو 15، FAIL وهو ما يعني عدم توفر مخزون لدينا لإكمال عملية الحجز.

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

التعيين إلى المجموعات الإعلانية

بعد الانتهاء من حجز التوقع بنجاح، يمكنك إنشاء مجموعة إعلانية مستخدمًا إياه:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

حتى تتمكن من تعيين توقع بنجاح، يجب أن تستوفي مجموعتك الإعلانية هذه المعايير:

• يجب عدم تحديد المعلمات التالية:
• start_time - يتم استخلاصها من التوقع
• end_time - يتم استخلاصها من التوقع
• targeting - يتم استخلاصها من التوقع
• bid_amount
• optimization_goal
• إما lifetime_budget أو daily_budget
• يمكنك تعيين الحجوزات إلى المجموعات الإعلانية التي لا تتضمن إعلانات نشطة. على الرغم من ذلك، يجب توفير إعلان واحد نشط على الأقل قبل بدء تشغيل المجموعة الإعلانية.
• يجب تضمين معرف rf_prediction_id والذي يعمل على إرفاق التوقع بالمجموعة الإعلانية الجديدة.
• تكون سمة الحملة الإعلانية للمعلمة buying_type هي RESERVED

يمكنك أيضًا إرفاق reachfrequencyprediction في المجموعات الإعلانية لتعديل التوقع الخاص بها. إرسال طلب POST إلى: https://graph.facebook.com/{ad_set_id} يتضمن rf_prediction_id الذي يخص reachfrequencyprediction الذي تريد استخدامه.

يمثل ما يلي قيودًا على المجموعة الإعلانية:

• خيارات منصة الناشر: facebook وinstagram.
• خيارات موضع فيسبوك: feed وrightcolumn.
• خيارات موضع Instagram: stream وstory وexplore وexplore_home وreels. إذا تضمن الموضع instagram، فيجب استخدام destination_ids وليس destination_id. يجب أن يحتوي الحقل destination_ids على معرف صفحة فيسبوك كـ destination_id، بالإضافة إلى معرف حساب Instagram.
• إما الجمهور المخصص أو الفئات الشريكة ولكن ليس كلاهما
• غير مسموح بالاستهداف حسب استبعاد المعجبين أو التفاعل مع الفيديو أو الجماهير المخصصة لموقع الويب.
• يجب أن يتطابق promoted_object للمجموعة الإعلانية مع معرف destination_id الخاص بالتوقع. بالنسبة إلى منشورات الصفحة، يجب أن يكون معرف الصفحة المحدد، وبالنسبة إلى إعلانات التطبيق، يجب أن يتطابق مع معرف التطبيق المحدد.
• يُعتبر معدل عرض الإعلانات القياسي والمجدول مدعومًا، بينما لا يتم دعم العرض السريع.

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

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

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

قد تتضمن المجموعات الإعلانية للحجز عدة إعلانات؛ حيث يمكنك إضافة المزيد من المعلومات في أي وقت. إذا تم تنشيط المجموعة الإعلانية ولم تكن تحتوي على أي إعلانات نشطة بداخلها، فيجب إنشاء إعلانك الأول في غضون 24 ساعة بالنسبة إلى المجموعات الإعلانية التي تستمر لمدة تتراوح بين 3 إلى 30 يومًا، أو في غضون 6 ساعات بالنسبة إلى المجموعات الإعلانية التي تستمر لمدة يوم واحد أو اثنين. وإذا لم تقم بذلك، فسيتم حذف الحجز.

فصل التوقعات وتعديل المجموعات الإعلانية

يمكنك إجراء تعديلات أو إيقاف حملة الحجز مؤقتًا قبل أن تبدأ. بمجرد بدء الحملة الإعلانية، يمكنك فقط تعديل تصميم إعلانك أو ميزانيتك أو تمديد تاريخ الانتهاء. يمكنك فقط تعديل تصميم الإعلان، أما التوقع فلن يتم تغييره.

إذا قمت بتغيير ميزانيتك أو تاريخ الانتهاء، فقد ينشئ هذا توقعًا جديدًا لحملتك الإعلانية ستراه في تقديرات الحجز.

لا يمكنك إيقاف حملة الحجز الإعلانية مؤقتًا بعد بدئها، ولكن يمكنك حذف الحملة لإلغاء حملتك في أي وقت.

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

لاحظ أنه لتجنب حالات الفشل المحتملة، لا نشجع بشدة حذف كل الإعلانات عندما يتم نشر مجموعة إعلانات الحجز.

إذا تم تعيين حجز إلى مجموعة إعلانية قبل بدء تنشيط المجموعة الإعلانية، فلن تتمكن من تغيير الغالبية العظمى من السمات إلا إذا تم فصل الحجز. ويمكنك إجراء طلب HTTP POST إلى المجموعة وتعيين معرف rf_prediction_id إلى القيمة 0. يمكنك فقط تعديل السمة name في كائن المجموعة الإعلانية.

لفصل حجز ما:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

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

• name
• creative_id
• creative_spec
• conversion_specs
• tracking_specs
• view_tags

إيقاف المجموعات الإعلانية مؤقتًا وإعادة تشغيلها

يمكنك إيقاف مجموعة إعلانية نشطة مؤقتًا، راجع المجموعة الإعلانية، المرجع. وإذا تم إيقاف مجموعة إعلانية مؤقتًا لمدة تزيد عن 30 دقيقة، فإننا لا يمكن أن نضمن التوقع لهذه المجموعة الإعلانية بعد ذلك.

إذا أردت إعادة تنشيط مجموعة إعلانية تم إيقافها مؤقتًا لأكثر من 30 دقيقة، فيجب الحصول على توقع جديد. ويمكنك إجراء POST إلى reachfrequencypredictions. راجع إنشاء توقع وحجز التوقع. ويجب تمرير معرف existing_campaign_id للمجموعة الإعلانية النشطة حتى يتم إعادة تنشيطها في الطلب. بعد إنشاء توقع جديد وحجزه، يجب إرفاق reachfrequencyprediction إلى المجموعة الإعلانية من خلال إجراء طلب HTTP POST إلى: https://graph.facebook.com/{ad_set_id} لتحديد معرف rf_prediction_id الخاص بالتوقع الذي تريد استخدامه.

تعديل المجموعات الإعلانية قيد التشغيل

يمكنك إجراء التحديثات التالية بعد بدء تشغيل المجموعة الإعلانية.

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

لا يمكنك تعديل مجموعة إعلانية نشطة أو إيقافها مؤقتًا إذا كانت تستوفي أحد المعايير التالية:

• تتعرض إلى انخفاض شديد في مرات عرض الإعلانات. تم عرض نسبة أقل من 10% من التوقع المحدد. المجموعات الإعلانية ذات الإنفاق الزائد التي تنفق ميزانية مرتفعة
• المجموعات الإعلانية التي يتم تشغيلها ليوم واحد فقط
• المجموعات الإعلانية التي تنتهي في خلال مدة 24 ساعة القادمة

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

بعد الانتهاء من إنشاء التوقع الجديد وحجزه، يمكنك إرفاق reachfrequencyprediction بالمجموعة الإعلانية من خلال إجراء طلب HTTP POST إلى: https://graph.facebook.com/{ad_set_id} لتحديد rf_prediction_id باعتباره معرف reachfrequencyprediction الذي تريد استخدامه.

إعادة استخدام الجماهير المحجوزة

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

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

لحجز التوقع الجديد، يجب عليك أيضًا إدخال المعلمة الإضافية rf_prediction_id_to_release والتي تمثل معرف الحجز السابق.

تدوير الإعلان وتسلسل عرض الإعلانات

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

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

إذا كان طول مصفوفة creative_sequence يساوي الصفر، فذلك يعني أنك لا تستخدم أي تسلسل لعرض الإعلانات. وإذا لم يكن طول المصفوفة يساوي الصفر، فإنه يوصى بأن تجعله يساوي frequency_cap في rf_prediction_id. إذا كان الطول أكبر من frequency_cap، فسيتم اقتطاع آخر عدة إعلانات من المصفوفة. إذا كان الطول أقل من frequency_cap، فسيتم إجراء التعبئة الآلية للمصفوفة بشكل متكرر من خلال تكرار التسلسل من البداية. حتى تكون النتائج واضحة، يجب تعيين طول creative_sequence إلى كمية مطابقة لقيمة frequency_cap.

يكون كل إعلان موجود ضمن التسلسل بالحالة ACTIVE أو PENDING_REVIEW أو CREDIT_CARD_NEEDED. لن يتم عرض إعلان بعينه في التسلسل على المستخدمين إلا بعد عرض كل الإعلانات التي تسبقه في التسلسل. ولن يتم عرض الإعلانات غير المدرجة في creative_sequence.

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

تتوفر هذه الميزة مع المجموعات الإعلانية بالحجز، بمعنى أن يكون buying_type لحملتها الإعلانية الرئيسية هو RESERVED، مع تعيين rf_prediction_id لهذه المجموعة الإعلانية.

يمكن العثور على المزيد من التفاصيل في مستند المجموعة الإعلانية.

حجز Instagram

بالنسبة إلى الوصول المتوقع على Instagram، يمكنك إنشاء حملة حجز إعلانية مع تعيين buying_type على RESERVED.

يساعدك الحجز في تخطيط حملات الوعي والتفاعل وحجزها، وتحسين الوصول، وتحسين معدل تذكر الإعلانات، وThruPlay.

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

رموز الأخطاء

أمثلة

إنشاء reachfrequencyprediction لـ destination_id للتطبيق:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

إنشاء reachfrequencyprediction لـ destination_id للصفحة:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

إنشاء reachfrequencyprediction لـ destination_id للتطبيق مع موضع Instagram:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

استطلع نقطة النهاية التالية عبر طلبات HTTP GET لاسترداد الحالة حتى تصبح أي حالة أخرى بخلاف 2:

https://graph.facebook.com/67890123456?fields=status

إذا كانت الحالة هي 1 (ناجحة)، فإنه يمكن إرفاق ذلك بمجموعة إعلانية أو حجزه.

حجز التوقع:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

استطلع نقطة النهاية التالية عبر طلبات HTTP GET لاسترداد الحالة حتى تصبح أي حالة أخرى بخلاف 2:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

إذا كانت الحالة هي 1 (ناجحة)، فإنه يمكن إرفاق ذلك بمجموعة إعلانية. لنقم بإعداد بنية الحملة الإعلانية من خلال إنشاء حملة إعلانية ومجموعة إعلانية وتصميم وإعلان وتعيين حجز للمجموعة الإعلانية.

إنشاء حملة إعلانية:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

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

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

إنشاء تصميم إعلان:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

إنشاء إعلان:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

تعيين توقع جديد للمجموعة الإعلانية:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"