حملات Advantage+‎ الإعلانية للتسوق

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

بدلاً من تشغيل عدة حملات إعلانية تحتوي على جماهير مقسمة، تتيح لك حملات Advantage+‎ الإعلانية للتسوق دمج كل شرائح الجمهور لسوق معين في بنية حملة إعلانية واحدة. تم تصميم هذا لتبسيط عملية الإنشاء والإدارة، مع تقليل احتمالية تداخل الجمهور.

الإعداد اليدوي للحملة مقارنةً بحملات Advantage+‎ الإعلانية للتسوق

إعداد حملة BAU الإعلانية يدويًا	حملة Advantage+‎ الإعلانية للتسوق
حملات BAU الإعلانية المتعددة	استبدال حافظة BAU
الاستهداف اليدوي مع 7 عناصر للتحكم في الاستهداف	الاستهداف التلقائي، والأتمتة لزيادة كفاءة الإعداد من خلال إدخال دولة واحدة
تخصيصات صارمة للميزانية في حملات إعلانية متعددة	مرونة الميزانية خلال حملة إعلانية واحدة
اختبر ما يصل إلى 50 من مجموعات التصاميم	يُسمح بالإعلانات الديناميكية والثابتة مع ما يصل إلى 150 مجموعة تصميم

يوضح هذا المستند الخطوات المطلوب اتباعها لإعداد الدمج لحملات Advantage+‎ الإعلانية للتسوق. ستحتاج إلى ما يلي:

تحديد العملاء الحاليين
إنشاء حملة إعلانية
التحقق من إنشاء الحملة الإعلانية
إنشاء مجموعة إعلانية
توفير التصميم وإنشاء الإعلانات
تعيين الحد الأدنى للعمر والاستبعاد حسب الموقع الجغرافي (راجع المستند المرجعي لعناصر التحكم في الحساب الإعلاني)

الخطوة الأولى: تحديد العملاء الحاليين

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

يمكنك تحديد إعلانك من خلال النشر على نقطة النهاية /act_{ad_account_id}. ستحتاج إلى تضمين المعلمة التالية لإعداد هذا التحديد:

المعلمة الوصف

المعلمة	الوصف
`existing_customers` Array (مصفوفة)<string>	مصفوفة من معرفات الجمهور المخصصة التي يمكن للحساب الإعلاني الوصول إليها. المصادر المدعومة حاليًا للجمهور المخصص هي موقع الويب ونشاط التطبيق وقائمة العملاء والكتالوج والنشاط بلا اتصال. للحصول على معلومات حول كيفية إنشاء جمهور مخصص، راجع هذه الصفحة.

existing_customers

Array (مصفوفة)<string>

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

للحصول على معلومات حول كيفية إنشاء جمهور مخصص، راجع هذه الصفحة.

مثال

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>

لمزيد من المعلومات حول تتبع الجماهير الجديدة والحالية في أدوات التتبع التابعة لجهات خارجية، راجع معلمات عنوان URL لنوع الجمهور.

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

ابدأ بإنشاء الحملة الإعلانية. للقيام بذلك، أرسل طلب POST إلى /act_{ad_account_id}/campaigns.

المعلمات

المعلمة	الوصف
string (سلسلة)`name`	مطلوب اسم حملة Advantage+‎ الإعلانية للتسوق
`objective` enum (تعداد)	مطلوب هدف الحملة الإعلانية. تحديد `OUTCOME_SALES` لنوع الإعلان هذا
`special_ad_categories` list (قائمة)<Object>	مطلوب فئات إعلانية خاصة مرتبطة بحملة Advantage+‎ الإعلانية للتسوق
`adlabels` list (قائمة)<Object>	اختياري تسميات الإعلانات المرتبطة بحملة Advantage+‎ الإعلانية للتسوق
`buying_type` string (سلسلة)	اختياري تدعم حملات Advantage+‎ الإعلانية للتسوق القيمة `AUCTION` فقط
`execution_options` list (قائمة)<enum>	اختياري القيمة الافتراضية: `set`. الخيارات الأخرى هي: `validate_only`: عند تحديد هذا الخيار، لن يقوم استدعاء API بإجراء التغيير ولكن سيتم تشغيله من خلال قواعد التحقق من الصحة مقابل قيم كل حقل. `include_recommendations`: لا يمكن استخدام هذا الخيار بمفرده. عند استخدام هذا الخيار، سيتم تضمين التوصيات الخاصة بتكوين كائن الإعلان. سيتم تضمين توصيات لقسم منفصل في الاستجابة، ولكن فقط إذا كانت هناك توصيات لهذه المواصفات. إذا اجتاز الاستدعاء عملية التحقق أو المراجعة، فستكون الاستجابة `{"success": true}`. إذا لم يجتز الاستدعاء هذه العمليات، فسيتم إرجاع خطأ مع مزيد من التفاصيل.
`smart_promotion_type` enum (تعداد)	مطلوب لتحديد أن هذه حملة Advantage+‎ إعلانية للتسوق، يجب تعيين نوع الترويج الذكي على `AUTOMATED_SHOPPING_ADS`
`status` enum (تعداد)	اختياري الخيارات الصالحة هي: `PAUSED` و`ACTIVE`. إذا كانت هذه الحالة `PAUSED`، فسيتم إيقاف جميع المجموعة الإعلانية والإعلانات النشطة مؤقتًا وستكون لها حالة فعالة بالقيمة `CAMPAIGN_PAUSED`

مثال على إنشاء حملة إعلانية

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns

التحديث

يمكنك تحديث حملة إعلانية عن طريق إرسال طلب POST إلى /{campaign_id}.

المعلمات

المعلمة	الوصف
string (سلسلة)`name`	اسم حملة Advantage+‎ الإعلانية للتسوق
`special_ad_categories` list (قائمة)<Object>	الفئات الإعلانية الخاصة المرتبطة بحملة Advantage+‎ الإعلانية للتسوق
`adlabels` list (قائمة)<Object>	تسميات الإعلانات المرتبطة بحملة Advantage+‎ الإعلانية للتسوق
`execution_options` list (قائمة)<enum>	القيمة الافتراضية: `set`. الخيارات الأخرى هي: `validate_only`: عند تحديد هذا الخيار، لن يقوم استدعاء API بإجراء التغيير ولكن سيتم تشغيله من خلال قواعد التحقق من الصحة مقابل قيم كل حقل. `include_recommendations`: لا يمكن استخدام هذا الخيار بمفرده. عند استخدام هذا الخيار، سيتم تضمين التوصيات الخاصة بتكوين كائن الإعلان. سيتم تضمين توصيات لقسم منفصل في الاستجابة، ولكن فقط إذا كانت هناك توصيات لهذه المواصفات. إذا اجتاز الاستدعاء عملية التحقق أو المراجعة، فستكون الاستجابة `{"success": true}`. إذا لم يجتز الاستدعاء هذه العمليات، فسيتم إرجاع خطأ مع مزيد من التفاصيل.
`topline_id` numeric string (سلسلة رقمية) أو integer (عدد صحيح)	معرف الملخص
`status` enum (تعداد)	يمكنك استخدام الحالة التالية لإرسال استدعاء API للتحديث: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` إذا تم تعيين حملة إعلانية على `PAUSED`، فسيتم إيقاف الكائنات التابعة النشطة مؤقتًا وتكون لها حالة فعالة بالقيمة `CAMPAIGN_PAUSED`.

مثال على تحديث الحملة الإعلانية

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<CAMPAIGN_ID>

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

للتحقق من أنك نجحت في إنشاء حملة Advantage+‎ إعلانية للتسوق، يمكنك إرسال طلب GET إلى /<AD_CAMPAIGN_ID> مع الحقل smart_promotion_type.

ستُرجع حملة Advantage+‎ الإعلانية للتسوق الصالحة قيمة الحقل AUTOMATED_SHOPPING_ADS.

مثال

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_CAMPAIGN_ID>

الاستجابة

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

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

بمجرد أن تتوفر لديك حملة إعلانية، قم بإنشاء مجموعة الإعلانات. يمكن أن تحتوي كل حملة Advantage+‎ إعلانية للتسوق على مجموعة إعلانية واحدة فقط مرتبطة بها.

لإنشاء مجموعة إعلانية، أرسل طلب POST إلى /act_{ad_account_id}/adsets.

المعلمات

المعلمة	الوصف
`campaign_id` numeric string (سلسلة رقمية) أو integer (عدد صحيح)	مطلوب حملة Advantage+‎ الإعلانية للتسوق الصالحة التي ترغب في إضافة هذه المجموعة الإعلانية إليها.
string (سلسلة)`name`	مطلوب اسم حملة Advantage+‎ الإعلانية للتسوق
`promoted_object` Object (كائن)	مطلوب الكائن الذي تروج له هذه المجموعة الإعلانية عبر جميع إعلاناتها. بالنسبة إلى حملات Advantage+‎ الإعلانية للتسوق، قم بتوفير ما يلي: `pixel_id` `custom_event_type`: المجموعة الإعلانية +Advantage للتسوق تدعم الأحداث التالية: `PURCHASE` و`ADD_TO_CART` و`INITIATED_CHECKOUT` و`ADD_PAYMENT_INFO` و`ADD_TO_WISHLIST` و`CONTENT_VIEW` و`COMPLETE_REGISTRATION` و`DONATE` و`START_TRIAL` و`SUBSCRIBE` و`SEARCH` و`OTHER`. تعرف على المزيد حول التحسين من أجل التحويلات على مستوى القنوات في حملات Advantage+‎ الإعلانية للتسوق.
`targeting` Targeting object (كائن استهداف)	مطلوب بنية الاستهداف في مجموعة Advantage+‎ الإعلانية للتسوق. مسموح بتحديد `geo_locations` فقط.
`geo_locations` array (مصفوفة)	مطلوب يستخدم لتقييد جمهور المجموعة الإعلانية حسب `countries` - استهداف البلد. تتطلب مصفوفة من الرموز المكونة من رقمين بتنسيق ISO 3166. مثال: { "geo_locations": { "countries": [“US”] }, } `regions` — الولاية أو المقاطعة أو المنطقة. راجع البحث بمعايير الاستهداف، المناطق لمعرفة القيم المتوفرة. التقييد: 200. مثال: { "geo_locations": { "regions": [{"key":"3847"}] }, }
`daily_budget` int64	اختياري الميزانية اليومية المحددة بعملة حسابك مسموح بها فقط للمجموعات الإعلانية ذات المدة (الفرق بين `end_time` و`start_time`) التي تتجاوز 24 ساعة. يجب أن تكون `daily_budget` أو `lifetime_budget` أكبر من 0.
`lifetime_budget` int64	اختياري ميزانية الحملة كلها، محددة بعملة حسابك. إذا كانت محددة، فيجب أيضًا تحديد `end_time`. يجب أن تكون `daily_budget` أو `lifetime_budget` أكبر من 0.
`end_time` الوقت/التاريخ	مطلوب عند تحديد `lifetime_budget`. عند إنشاء مجموعة إعلانية تتضمن `daily_budget`، حدّد `end_time=0` لتعيين المجموعة الإعلانية باعتبارها مستمرة من دون تاريخ انتهاء. طابع زمني بتنسيق UNIX للتوقيت العالمي الموحد (UTC) مثال: `2015-03-12 23:59:59-07:00` أو `2015-03-12 23:59:59 PDT`.
`optimization_goal` enum (تعداد)	اختياري حدّد `OFFSITE_CONVERSIONS` كهدف تحسين لزيادة عدد التحويلات إلى الحد الأقصى. حدّد `VALUE` كهدف تحسين إذا كنت تريد زيادة قيمة التحويلات إلى الحد الأقصى. في مدير الإعلانات، نعرض أعلى قيمة باعتبارها استراتيجية عرض الأسعار لديك.
`bid_strategy` enum (تعداد)	اختياري `LOWEST_COST_WITHOUT_CAP`: يقدم فيسبوك تلقائيًا عروض أسعار نيابة عنك ويحقق لك نتائج بأقل تكلفة. ويمكن زيادة عرض الأسعار الفعّال تلقائيًا حسب الحاجة للحصول على النتائج التي تريدها استنادًا إلى الهدف `optimization_goal` المحدد. تكون هذه هي `bid_strategy` الافتراضية عندما يكون optimization_goal بالقيمة `OFFSITE_CONVERSION` أو `VALUE`. `LOWEST_COST_WITH_MIN_ROAS`: خيار عروض أسعار محدد لتحسين القيمة. يجب تحديد `roas_average_floor` الذي يمثل الحد الأدنى لعائد الإنفاق الإعلاني المطلوب. يمكنك الرجوع إلى الحد الأدنى لعرض أسعار عائد الإنفاق الإعلاني. `COST_CAP`: يمكنك الحصول على أقصى عدد من النتائج المحتملة بينما نحاول تلبية التكلفة لكل إجراء التي قمت بتعيينها. يجب توفير الحد الأقصى في الحقل `bid_amount`. ملاحظة: إن الالتزام بتقييدات الحد الأقصى للتكلفة ليس مضمونًا. راجع الحد الأقصى للتكلفة.
`bid_amount`	مطلوب إذا كانت bid_strategy بالقيمة `COST_CAP`.
`bid_constraints` كائن JSON	اختياري يجب أن يكون `optimization_goal` بالقيمة `VALUE`. يجب أن تكون `bid_strategy` بالقيمة `LOWEST_COST_WITH_MIN_ROAS`. يستخدم عرض أسعار الحد الأدنى لعائد الإنفاق الإعلاني `bid_constraints` لإرسال "حد عائد الإنفاق الإعلاني"، ولكن لا يمكنك استخدامه مع `bid_constraints`، وبدلاً من ذلك يمكنك استخدام `roas_average_floor`. يمكنك الرجوع إلى الحد الأدنى لعرض أسعار عائد الإنفاق الإعلاني. يتوفر النطاق الصالح `roas_average_floor` بالقيمة `[100, 10000000]` إجمالاً. يعني ذلك أن النطاق الصالح "للحد الأدنى لعائد الإنفاق الإعلاني" هو `[0.01, 1000.0]` أو `[1%, 100000.0%]` إجمالاً.
`billing_event` enum (تعداد)	مطلوب حدث فوترة للمجموعة الإعلانية. تكون `IMPRESSIONS` مدعومة فقط في حملات Advantage+‎ الإعلانية للتسوق.
`existing_customer_budget_percentage` number (رقم)	اختياري يحدد الحد الأقصى لنسبة الميزانية التي يمكن إنفاقها على العملاء الحاليين المرتبطين بهذا الحساب الإعلاني. قد تؤدي القيم المنخفضة إلى ارتفاع تكاليف التحويل. تقع القيم الصالحة بين 0-100.
`adlabels` list (قائمة)<Object>	اختياري يحدد قائمة التسميات التي سيتم ربطها بهذا الكائن.
`start_time` datetime (تاريخ/وقت)	اختياري. وقت بدء المجموعة. طابع زمني بتنسيق UNIX للتوقيت العالمي الموحد (UTC) مثال: `2015-03-12 23:59:59-07:00` أو `2015-03-12 23:59:59 PDT`.
`time_start` datetime (تاريخ/وقت)	اختياري بدء الوقت
`time_stop` datetime (تاريخ/وقت)	اختياري وقت التوقف
`attribution_spec` list<JSON Object>	اختياري مواصفات إسناد التحويل المستخدمة لإسناد التحويلات للتحسين.

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

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

التحديث

يمكنك تحديث المجموعة الإعلانية من خلال إرسال طلب POST إلى /{ad_set_id}.

المعلمات

المعلمة	الوصف
`adlabels` list (قائمة)<Object>	يحدد قائمة التسميات التي سيتم ربطها بهذا الكائن. يكون هذا الحقل اختياريًا.
`daily_budget` int64	الميزانية اليومية المحددة بعملة حسابك، المسموح بها فقط للمجموعات الإعلانية ذات المدة (الفرق بين `end_time` و`start_time`) التي تتجاوز 24 ساعة. يجب أن تكون `daily_budget` أو `lifetime_budget` أكبر من 0.
`existing_customer_budget_percentage` number (رقم)	يحدد الحد الأقصى لنسبة الميزانية التي يمكن إنفاقها على العملاء الحاليين المرتبطين بهذا الحساب الإعلاني. قد تؤدي القيم المنخفضة إلى ارتفاع تكاليف التحويل. تقع القيم الصالحة بين 0-100.
`end_time` الوقت/التاريخ	وقت الانتهاء، مطلوب عند تحديد `lifetime_budget`. مثال: `2015-03-12 23:59:59-07:00` أو `2015-03-12 23:59:59 PDT` عند إنشاء مجموعة إعلانية تتضمن ميزانية يومية، حدّد `end_time=0` لتعيين المجموعة الإعلانية باعتبارها مستمرة من دون تاريخ انتهاء. طابع زمني بتنسيق UNIX للتوقيت العالمي الموحد (UTC).
`execution_options` list (قائمة)<enum>	القيمة الافتراضية: `set`. الخيارات الأخرى هي: `validate_only`: عند تحديد هذا الخيار، لن يقوم استدعاء API بإجراء التغيير ولكن سيتم تشغيله من خلال قواعد التحقق من الصحة مقابل قيم كل حقل. `include_recommendations`: لا يمكن استخدام هذا الخيار بمفرده. عند استخدام هذا الخيار، سيتم تضمين التوصيات الخاصة بتكوين كائن الإعلان. سيتم تضمين توصيات لقسم منفصل في الاستجابة، ولكن فقط إذا كانت هناك توصيات لهذه المواصفات. إذا اجتاز الاستدعاء عملية التحقق أو المراجعة، فستكون الاستجابة `{"success": true}`. إذا لم يجتز الاستدعاء هذه العمليات، فسيتم إرجاع خطأ مع مزيد من التفاصيل.
`start_time` datetime (تاريخ/وقت)	وقت بدء المجموعة. يجب أن يتوفر في صورة طابع زمني بتنسيق UNIX للتوقيت العالمي الموحد (UTC). مثال: `2015-03-12 23:59:59-07:00` أو `2015-03-12 23:59:59 PDT`.
`status` enum (تعداد)	الخيارات المتوفرة للتحديثات: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` إذا تم التعيين على `PAUSED`، فسيتم إيقاف جميع الإعلانات النشطة المرتبطة بها مؤقتًا وسيكون لها حالة فعالة بالقيمة `ADSET_PAUSED`.
`lifetime_budget` int64	ميزانية الحملة كلها، محددة بعملة حسابك. إذا كانت محددة، فيجب أيضًا تحديد `end_time`. يجب أن تكون `daily_budget` أو `lifetime_budget` أكبر من 0.
`time_start` datetime (تاريخ/وقت)	بدء الوقت
`time_stop` datetime (تاريخ/وقت)	وقت التوقف
`targeting` Targeting object (كائن استهداف)	بنية الاستهداف لمجموعتك الإعلانية. القيم الصالحة للاستهداف هي `geo_locations`.
`geo_locations` array (مصفوفة)	مطلوب يستخدم لتقييد جمهور المجموعة الإعلانية حسب `countries` - استهداف البلد. تتطلب مصفوفة من الرموز المكونة من رقمين بتنسيق ISO 3166. مثال: { "geo_locations": { "countries": [“US”] }, } `regions` — الولاية أو المقاطعة أو المنطقة. راجع البحث بمعايير الاستهداف، المناطق لمعرفة القيم المتوفرة. التقييد: 200. مثال: { "geo_locations": { "regions": [{"key":"3847"}] }, }
`attribution_spec` list<JSON Object>	اختياري مواصفات إسناد التحويل المستخدمة لإسناد التحويلات للتحسين.

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

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_SET_ID>

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

بمجرد أن تتوفر لديك مجموعة إعلانية، يمكنك إنشاء إعلانك عن طريق النشر على نقطة النهاية /act_{ad_account_id}/ads. يمكنك تضمين المعلمات التالية

المعلمات

المعلمة	الوصف
string (سلسلة)`name`	مطلوب اسم الإعلان
`adset_id` int64	مطلوب معرف المجموعة الإعلانية، مطلوب عند الإنشاء.
`creative` AdCreative (تصميم إعلان)	مطلوب مواصفات التصميم أو معرف تصميم الإعلان الذي سيستخدمه هذا الإعلان. الحقول الصالحة هي: `object_story_spec` `product_set_id` `use_page_actor_override` `creative_id` يمكنك قراءة المزيد حول التصميمات هنا قم بتوفير التصميم بالتنسيق التالي: `{"creative_id": <CREATIVE_ID>}` أو قم بتوفير مواصفات التصميم: { "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }
`status` enum (تعداد)	اختياري تكون القيم `ACTIVE` و`PAUSED` فقط صالحة أثناء الإنشاء. أثناء الاختبار، يُوصى بتعيين الإعلانات على حالة `PAUSED` حتى لا تتكبد أي عمليات إنفاق بشكل غير مقصود.
`adlabels` list (قائمة)<Object>	اختياري تسميات الإعلانات المرتبطة بهذا الإعلان
`execution_options` list (قائمة)<enum>	اختياري القيمة الافتراضية: `set`. `validate_only`: عند تحديد هذا الخيار، لن يقوم استدعاء API بإجراء التغيير ولكن سيتم تشغيله من خلال قواعد التحقق من الصحة مقابل قيم كل حقل. `synchronous_ad_review`: لا ينبغي استخدام هذا الخيار بمفرده. يجب أن يتم تحديده دائمًا بالحالة `validate_only`. عند تحديد هذه الخيارات، سيؤدي استدعاء API إلى إجراء عمليات التحقق من صحة الإعلانات، والتي تتضمن التحقق من لغة الرسالة، وقاعدة النص بنسبة 20% للصورة، وما إلى ذلك، بالإضافة إلى منطق التحقق من الصحة. `include_recommendations`: لا يمكن استخدام هذا الخيار بمفرده. عند استخدام هذا الخيار، سيتم تضمين التوصيات الخاصة بتكوين كائن الإعلان. سيتم تضمين توصيات لقسم منفصل في الاستجابة، ولكن فقط إذا كانت هناك توصيات لهذه المواصفات. إذا اجتاز الاستدعاء عملية التحقق أو المراجعة، فستكون الاستجابة `{"success": true}`. إذا لم يجتز الاستدعاء هذه العمليات، فسيتم إرجاع خطأ مع مزيد من التفاصيل.

مثال على إنشاء الإعلان

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

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

للاطلاع على قائمة كاملة من حقول التصاميم الإعلانية، انظر هنا.

الحقل	الوصف
`object_story_spec` AdCreativeObjectStorySpec	مطلوب استخدمه إذا كنت تريد إنشاء منشور صفحة جديد غير منشور وتحويل المنشور إلى إعلان. معرف الصفحة والمحتوى الطلوب لإنشاء منشور صفحة جديد غير منشور.
`use_page_actor_override` AdCreative	مطلوب إذا كانت القيمة `true`، فسنعرض صفحة فيسبوك المرتبطة بإعلانات Advantage للتسوق.

مثال على إنشاء تصميم

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

التحديث

يمكنك تحديث إعلان عن طريق إرسال طلب POST إلى /{ad_id}.

المعلمات

المعلمة	الوصف
string (سلسلة)`name`	الاسم الجديد للإعلان
`adlabels` list (قائمة)<Object>	تسميات الإعلان المرتبطة بهذا الإعلان.
`execution_options` list (قائمة)<enum>	القيمة الافتراضية: `set`. الخيارات الأخرى هي: `validate_only`: عند تحديد هذا الخيار، لن يقوم استدعاء API بإجراء التغيير ولكن سيتم تشغيله من خلال قواعد التحقق من الصحة مقابل قيم كل حقل. `synchronous_ad_review`: لا ينبغي استخدام هذا الخيار بمفرده. يجب أن يتم تحديده دائمًا بالحالة `validate_only`. عند تحديد هذه الخيارات، سيؤدي استدعاء API إلى إجراء عمليات التحقق من صحة الإعلانات، والتي تتضمن التحقق من لغة الرسالة، وقاعدة النص بنسبة 20% للصورة، وما إلى ذلك، بالإضافة إلى منطق التحقق من الصحة. `include_recommendations`: لا يمكن استخدام هذا الخيار بمفرده. عند استخدام هذا الخيار، سيتم تضمين التوصيات الخاصة بتكوين كائن الإعلان. سيتم تضمين توصيات لقسم منفصل في الاستجابة، ولكن فقط إذا كانت هناك توصيات لهذه المواصفات. إذا اجتاز الاستدعاء عملية التحقق أو المراجعة، فستكون الاستجابة `{"success": true}`. إذا لم يجتز الاستدعاء هذه العمليات، فسيتم إرجاع خطأ مع مزيد من التفاصيل.
`status` enum (تعداد)	الخيارات هي: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` أثناء الاختبار، يُوصى بتعيين الإعلانات على حالة `PAUSED` حتى لا تتكبد أي عمليات إنفاق بشكل غير مقصود.
`creative` AdCreative (تصميم إعلان)	مواصفات تصميم الإعلان الذي سيستخدمه هذا الإعلان. الحقول الصالحة هي `object_story_spec` و`asset_feed_spec` و`use_page_actor_override` ويمكن عرضها هنا. يمكنك قراءة المزيد حول التصميمات هنا قم بتوفير التصميم بالتنسيق التالي: { "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }

مثال على تحديث الإعلان

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>

حملات Advantage+‎ الإعلانية للتسوق

الإعداد اليدوي للحملة مقارنةً بحملات Advantage+‎ الإعلانية للتسوق

الخطوة الأولى: تحديد العملاء الحاليين

مثال

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

المعلمات

مثال على إنشاء حملة إعلانية

التحديث

المعلمات

مثال على تحديث الحملة الإعلانية

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

مثال

الاستجابة

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

المعلمات

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

التحديث

المعلمات

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

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

المعلمات

مثال على إنشاء الإعلان

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

مثال على إنشاء تصميم

التحديث

المعلمات

مثال على تحديث الإعلان

التعرف على المزيد