‏كتالوج المنتجات‏

API العروض

تتوفر API العروض ضمن برنامج الإصدار التجريبي المغلق المتاح بالدعوة فقط. الرجاء التعاون مع ممثل Meta للحصول على صلاحية الوصول إذا تمت دعوتك إلى البرنامج.


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

إنشاء العروض

يمكنك إنشاء العروض عبر قائمة بيانات العروض أو يدويًا عبر مدير المعاملات التجارية.

قائمة البيانات

لإنشاء قائمة بيانات عروض جديدة، أرسل طلب POST إلى عنصر الربط /{product_catalog_id}/product_feeds وقم بتعيين feed_type على OFFER. عند النشر على عنصر الربط هذا، يتم إنشاء قائمة بيانات منتجات من نوع "العرض" للكتالوج المحدد في الحقل product_catalog_id.

بمجرد إنشاء قائمة بيانات العروض، يمكنك تحميل بيانات العرض عبر إرسال طلب POST إلى عنصر الربط /{product_feed_id}/uploads.

أعمدة قائمة البيانات

يمكنك تعيين معظم الحقول المتوفرة المدرجة أدناه كأعمدة في ملف قائمة البيانات لديك. لا يمكن تعيين الحقول التي تم تحديدها للقراءة فقط أثناء الإنشاء.

مسرد المصطلحات

مجموعات المنتجات

مجموعة المنتجات هي مجموعة من العناصر ذات الصلة الموجودة في كتالوج المنتجات.

العناصر المستهدفة في العروض

هذه هي المنتجات التي يسري عليها عرض.

المتطلبات الأساسية للعروض

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

نوع تطبيق العرض

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

الحقول الأساسية

يمكن استخدام الحقول أدناه لتكوين جميع أنواع العروض.

الحقلالوصف

id

النوع: numeric string

قراءة فقط.

معرف فريد (معرف فيسبوك) لهذا العنصر.

offer_id

النوع: string

مطلوب.

المعرف الذي تم توفيره من جانب البائع للعرض.


يتم استخدام هذا الحقل لتحديد عرض بشكل فريد داخل الكتالوج.

title

النوع: string

اختياري.

عنوان عنصر العرض.


يتم حاليًا استخدام هذا العنوان فقط للمساعدة في تحديد العروض داخل مدير المعاملات التجارية ولا يتم عرضه للمشترين.

description

النوع: string

قراءة فقط.

الوصف الذي تم إنشاؤه تلقائيًا للعرض.

application_type

النوع: enum{SALE, AUTOMATIC_AT_CHECKOUT, BUYER_APPLIED}

مطلوب.

يحدد متى ينطبق العرض وكيفية ذلك. الخيارات المتوفرة هي:

  • SALE: يتم تخفيض أسعار العناصر بشكل مباشر، وتظهر للمشترين كتسعير يتوسّطه خط. لا تتطلب هذه العروض أي متطلبات أساسية من جانب المشتري ولا تتأثر بالعناصر الأخرى عند إتمام الشراء. يتم دائمًا اختيار الخصم الذي يوفر أقل سعر للعنصر، حيث لا يتم دمج الخصومات مطلقًا. يمكن دمج الخصومات مع أنواع العروض الأخرى ولكن يتم تطبيقها دائمًا أولاً. إذا كان المنتج يحتوي بالفعل على حقل sale_price ، فسيتم حساب السعر النهائي باستخدام sale_price كسعر أساسي.
  • AUTOMATIC_AT_CHECKOUT: يتم تطبيق العرض تلقائيًا عند إتمام الشراء عندما يستوفي المشتري معايير التحصيل اللازمة. يحتوي هذا العرض على بعض التكوينات التي تمنعه ​​من التأهل كخصم. لا يمكن دمجه إلا مع عروض الخصم. قد يكون ما يصل إلى 25 من هذه العروض نشطة في وقت واحد.
  • BUYER_APPLIED: يتم تطبيق هذا العرض عند إتمام الشراء بناءً على إجراء معين يتخذه المشتري، مثل إدخال رمز ترويجي. لا يمكن حاليًا دمج هذه العروض مع بعضها بعضًا أو تطبيق العروض تلقائيًا عند إتمام الشراء. يلزم توفير واحد من [public_coupon_code، coupon_codes].

coupon_codes

النوع: Array<string>

قائمة برموز القسائم غير الحساسة لحالة الأحرف التي يستخدمها العملاء عند إتمام الشراء لتحصيل العرض. الحد الأقصى المسموح به هو 100 رمز قسيمة. على سبيل المثال: ["10OFF", "HOLIDAY_SALE"]


لا يمكن تحديد رموز القسائم إلا عندما يكون application_type بالقيمة BUYER_APPLIED.


إذا تم تعيين هذا الحقل، فيجب أن يكون public_coupon_code فارغًا.

public_coupon_code

النوع: string

اختياري.

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


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


لا يمكن أن يتجاوز طول رمز القسيمة العام 20 حرفًا ويجب ألا يحتوي الكتالوج إلا على 10 عروض نشطة بحد أقصى مع رموز قسيمة عامة في المرة الواحدة.


لا يمكن تعيين رمز قسيمة عام إلا عندما يكون application_type بالقيمة BUYER_APPLIED.


إذا تم تعيين هذا الحقل، فيجب أن يكون coupon_codes فارغًا.

start_date_time

النوع: timestamp

مطلوب.

طابع زمني بتنسيق Unix، بالثواني، يشير إلى موعد بدء العرض.


قد يكون الإدخال عبارة عن طابع زمني بتنسيق Unix، بالثواني، أو سلسلة تاريخ بتنسيق ISO-8601 (مثل، 2021-09-25T12:34:56Z).

end_date_time

النوع: timestamp

اختياري. ويتم التعيين افتراضيًا على القيمة null.

طابع زمني بتنسيق Unix، بالثواني، يشير إلى موعد انتهاء العرض. إذا تم تركه فارغًا أو بالقيمة null، فلن يكون للعرض تاريخ انتهاء.


قد يكون الإدخال عبارة عن طابع زمني بتنسيق Unix، بالثواني، أو سلسلة تاريخ بتنسيق ISO-8601 (مثل، 2021-09-25T12:34:56Z).

min_quantity

النوع: int64

اختياري. ويتم التعيين افتراضيًا على 0.


استخدم هذا الحقل إذا كان عرضك ساريًا فقط عندما يشتري العميل الحد الأدنى من عدد المنتجات.


يمثل هذا الحقل عدد المنتجات التي يحتاج العميل إلى شرائها حتى يكون العرض ساريًا. على سبيل المثال: "اشترِ 5 قمصان واحصل على خصم 20%".


لا يمكن تعيين سوى واحد من min_quantity أو min_subtotal.

min_subtotal

النوع: string

اختياري. ويتم التعيين افتراضيًا على القيمة null.


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


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


يجب تنسيق هذا الحقل على النحو التالي: المبلغ، متبوعًا برمز العملة ISO المكون من ثلاثة أرقام، مع وجود مسافة بين المبلغ والعملة. على سبيل المثال: تمثل السلسلة "30.99 دولارًا أمريكيًا" مجموع إجمالي فرعي بقيمة 30.99 دولارًا أمريكيًا كمطلب أساسي لتطبيق العرض.


لا يمكن تعيين سوى واحد من min_quantity أو min_subtotal.

redeem_limit_per_user

النوع: int64

اختياري. ويتم التعيين افتراضيًا على 0 (غير محدود).

الحد الأقصى لعدد المرات التي يمكن لمستخدم واحد استخدام العرض فيها.


قم بتعيين هذا الحقل إلى 1 لإنشاء رمز قسيمة للاستخدام لمرة واحدة.


يجب تعيين هذا الحقل فقط إذا كان application_type بالقيمة BUYER_APPLIED.

value_type

النوع: enum {FIXED_AMOUNT, PERCENTAGE}

مطلوب.

نوع الخصم الذي يوفره العرض.


الخيارات المتوفرة هي:

  • FIXED_AMOUNT: يتم تطبيق خصم بالقيمة المأخوذة من fixed_amount_off.
  • PERCENTAGE: يتم تطبيق نسبة خصم بالقيمة المأخوذة من percent_off.

fixed_amount_off

النوع: string

مطلوب، إذا تم تعيين value_type إلى FIXED_AMOUNT.

مبلغ الخصم داخل العرض. يجب تنسيقه على النحو التالي: المبلغ، متبوعًا برمز العملة ISO المكون من ثلاثة أرقام، مع وجود مسافة بين المبلغ والعملة. على سبيل المثال، تمثل السلسلة "30.99 دولارًا أمريكيًا" خصمًا بقيمة 30.99 دولارًا أمريكيًا.


يجب تعيين هذا الحقل فقط إذا كان value_type بالقيمة FIXED_AMOUNT.

percent_off

النوع: int64

مطلوب، إذا تم تعيين value_type إلى PERCENTAGE.

نسبة الخصم داخل العرض. يجب أن تكون عددًا صحيحًا بين 0 و100. على سبيل المثال، يمثل العدد "30" خصمًا بنسبة 30%.


يجب تعيين هذا الحقل فقط إذا كان value_type بالقيمة PERCENTAGE.

target_granularity

النوع: enum {ITEM_LEVEL, ORDER_LEVEL}

مطلوب.

التقسيم الذي يتم عنده تطبيق الخصم الموجود في العرض.


الخيارات المتوفرة هي:

  • ITEM_LEVEL: يمثل خصمًا يتم تطبيقه على كل عنصر مستهدف في عربة التسوق.
  • ORDER_LEVEL: يمثل خصمًا يتم تطبيقه على جميع العناصر المستهدفة في عربة التسوق بشكل مجمع. على سبيل المثال، إذا كان لديك عرض "خصم 30 دولارًا على الأحذية" مع 3 أزواج من الأحذية في سلة التسوق، فسيطبق ITEM_LEVEL خصمًا بقيمة 30 دولارًا على كل زوج من الأحذية (بقيمة 90 دولارًا)، بينما سيطبق ORDER_LEVEL خصمًا بقيمة 30 دولارًا على مجموع أزواج الأحذية الثلاثة (بحد أقصى 30 دولارًا).

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

offer_terms

النوع: string

اختياري.

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


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


يجب أن يتبع المحتوى سياسات المحتوى لدينا.

تحديد المنتجات المؤهلة

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

الحقلالوصف

target_selection

النوع: enum{ALL_CATALOG_PRODUCTS, SPECIFIC_PRODUCTS}

مطلوب.

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


الخيارات المتوفرة هي:

  • ALL_CATALOG_PRODUCTS: يمكن تطبيق العرض على أي منتج في الكتالوج.
  • SPECIFIC_PRODUCTS: لا يمكن تطبيق العرض إلا على المنتجات المستهدفة المحددة بواسطة target_filter أو target_product_retailer_ids أو target_product_group_retailer_ids أو target_product_set_retailer_ids.

إذا كان target_selection بالقيمة SPECIFIC_PRODUCTS، فيجب تحديد إحدى القيم التالية بالضبط: target_filter أو target_product_retailer_ids أو target_product_group_retailer_ids أوtarget_product_set_retailer_ids.

target_filter

النوع: JSON-encoded string

اختياري.


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


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


يجب تعيين هذا الحقل فقط إذا تم تعيين target_selection إلى SPECIFIC_PRODUCTS.

target_product_retailer_ids

النوع: Array<product_retailer_id>

اختياري.


قائمة بمعرفات بائع التجزئة لعناصر المنتجات التي يمكن تطبيق العرض عليها.


يجب تعيين هذا الحقل فقط إذا تم تعيين target_selection إلى SPECIFIC_PRODUCTS.

target_product_group_retailer_ids

النوع: Array<product_group_retailer_id>

اختياري.


قائمة بمعرفات بائع التجزئة لمجموعة المنتجات التي يمكن تطبيق العرض عليها.


ستكون جميع أشكال المنتجات المتنوعة المضمنة في مجموعة المنتجات مؤهلة للحصول على العرض.


يجب تعيين هذا الحقل فقط إذا تم تعيين target_selection إلى SPECIFIC_PRODUCTS.

target_product_set_retailer_ids

النوع: Array<product_set_retailer_id>

اختياري.


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

prerequisite_filter

النوع: JSON-encoded string

اختياري.


قاعدة فلترة لتحديد المنتجات التي يجب على المشتري شراؤها حتى يتمكن من تحصيل العرض. يتم استخدام منطق قاعدة الفلتر نفسه المستخدم لإضافة المنتجات إلى مجموعة المنتجات. يستخدم عادة في العروض بأسلوب "اشترِ X واحصل على Y".


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


إذا تم تعيين هذا الحقل، فيجب أن يكون كل من prerequisite_product_retailer_ids، وprerequisite_product_group_retailer_ids، وprerequisite_product_set_retailer_ids بالقيمة null.

prerequisite_product_retailer_ids

النوع: Array<product_retailer_id>

اختياري.


معرفات بائع التجزئة لعناصر المنتجات التي يجب على المشتري شراؤها لتحصيل العرض. جميع العناصر المدرجة في القائمة مؤهلة للاستخدام من قبل المشتري كمطلب أساسي لتحصيل العرض. يستخدم عادة في العروض بأسلوب "اشترِ X واحصل على Y".


إذا تم تعيين هذا الحقل، فيجب أن يكون كل من prerequisite_filter، وprerequisite_product_group_retailer_ids، وprerequisite_product_set_retailer_ids بالقيمة null.

prerequisite_product_group_retailer_ids

النوع: Array<product_group_retailer_id>

اختياري.


معرفات بائع التجزئة لمجموعات المنتجات التي يجب على المشتري شراؤها لتحصيل العرض. جميع أشكال المنتجات المتنوعة المضمنة في كل مجموعة مؤهلة للاستخدام من قبل المشتري كمطلب أساسي لتحصيل العرض. يستخدم عادة في العروض بأسلوب "اشترِ X واحصل على Y".


إذا تم تعيين هذا الحقل، فيجب أن يكون كل من prerequisite_filter، وprerequisite_product_retailer_ids، وprerequisite_product_set_retailer_ids بالقيمة null.

prerequisite_product_set_retailer_ids

النوع: Array<product_set_retailer_id>

اختياري.


معرفات بائع التجزئة لمجموعات المنتجات التي تحتوي على عناصر يجب على المشتري شراؤها لتحصيل العرض. تُعد أي عناصر تم الحصول عليها من إجمالي تقييم مجموعات المنتجات مؤهلة للاستخدام من قبل المشتري كمطلب أساسي لتحصيل العرض. يستخدم عادة في العروض بأسلوب "اشترِ X واحصل على Y".


إذا تم تعيين هذا الحقل، فيجب أن يكون كل من prerequisite_filter، وprerequisite_product_retailer_ids، وprerequisite_product_group_retailer_ids بالقيمة null.

exclude_sale_priced_products

النوع: bool enum {YES, NO}

اختياري.

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


قم بتعيين هذا الحقل إلى YES لتجنب المنتجات ذات الخصم المزدوج المحتملة. احذف هذا الحقل أو قم بتعيينه إلى NO لتضمين المنتجات التي لها sale_price مخفض في الكتالوج لديك.


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

عروض الشحن

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

لإنشاء عرض شحن يجب تعيين target_type إلى SHIPPING. يتم حاليًا دعم عروض الشحن المجاني فقط، وبالتالي يجب أن يكون value_type دائمًا بالقيمة PERCENTAGE مع تعيين percent_off إلى 100.

الحقلالوصف

target_type

النوع: enum{LINE_ITEM, SHIPPING}

مطلوب.

نوع الكائن الذي ينطبق عليه العرض:

  • LINE_ITEM: يتم تطبيق العرض على عناصر المنتجات نفسها.
  • SHIPPING: يتم تطبيق العرض على تكاليف الشحن. لا يكون هذا الخيار صالحًا إلى عندما يكون target_granularity بالقيمة ITEM_LEVEL.

target_shipping_option_types

النوع: Array<shipping_service_tier>

مطلوب، إذا كان target_type بالقيمة SHIPPING.

قائمة بمستويات خدمة الشحن (على سبيل المثال، STANDARD، RUSH، EXPEDITED) التي يسري العرض عليها.


على سبيل المثال، لتحديد عرض شحن ينطبق على سرعات الشحن القياسية والعاجلة ولكن ليس الشحن في اليوم التالي، استخدم:

  • target_type ليكون بالقيمة SHIPPING
  • target_shipping_option_types ليكون بالقيمة ["STANDARD", "RUSH"]

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

عروض "اشترِ X واحصل على Y"

تتيح العروض من نوع "اشترِ X واحصل على Y" للمشترين شراء كمية محددة من "منتجات X" مختارة للحصول على منتج واحد أو أكثر من "منتجات Y" بسعر مخفض أو مجانًا. يتم أيضًا دعم العروض بأسلوب "أنفق X واحصل على Y" حيث يجب على المشتري الوصول إلى حد الإنفاق الأدنى لمجموعة من منتجات X للحصول على خصم. يمكنك إنشاء عرض شراء X والحصول على Y عن طريق تعيين حقل target_quantity بالإضافة إلى حقل min_quantity أو min_subtotal.

في بعض الحالات، مثل العرض الشائع "اشترِ واحدًا واحصل على واحد مجانًا"، قد يشير كل من X وY إلى مجموعة المنتجات نفسها. ومع ذلك يمكنك أيضًا استخدام prerequisite_filter، وprerequisite_product_retailer_ids، وprerequisite_product_group_retailer_ids، وprerequisite_product_set_retailer_ids لتحديد مجموعة من منتجات X مختلفة عن منتجات Y المستهدفة. انظر تحديد المنتجات المؤهلة لمعرفة كيفية تكوين هذه الحقول.

الحقلالوصف

target_quantity

النوع: int64

اختياري. ويتم التعيين افتراضيًا على 0 (غير محدود).

عدد المنتجات التي سيتم تطبيق الخصم عليها عند كل عملية تحصيل للعرض. يؤدي تعيين target_quantity على قيمة أكبر من 0 إلى إنشاء عرض "اشترِ X واحصل على Y".


استخدم هذا الحقل للتحكم في عدد المنتجات التي يتم تطبيق الخصم عليها عندما يلبي المشتري المتطلبات الأساسية لتحصيل العرض. على سبيل المثال، في عرض "اشترِ 2 واحصل على 1 بخصم 50%"، تكون الكمية المستهدفة 1، وفي عرض "اشترِ 5 واحصل على 2 مجانًا"، تكون الكمية المستهدفة 2.

redemption_limit_per_order

النوع: int64

اختياري. ويتم التعيين افتراضيًا على 0 (غير محدود).

عدد المرات التي يمكن فيها تحصيل هذا العرض لكل طلب.


استخدم هذا الحقل لتحديد عدد المرات التي يمكن فيها تطبيق العرض على المنتجات في عملية الشراء من جانب المشتري. على سبيل المثال، في عرض "اشترِ قميصًا واحدًا واحصل على آخر مجانًا"، سيحصل المشتري الذي يشتري 6 قمصان بشكل افتراضي على 3 قمصان بالسعر الكامل و3 قمصان مجانًا. ومع ذلك، في المثال نفسه، إذا تم تعيين redemption_limit_per_order إلى 2، فسيحصل المشتري على قميصين مجانًا و4 بالسعر الكامل.


إذا تم تعيين هذا الحقل، فيجب أن تكون target_quantity أكبر من 0.

دمج العروض

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

  • بالنسبة لمنتج معين، إذا كان هناك أي عروض من شأنها أن تؤدي إلى عرض تسعير يتوسّطه خط (خصم) (application_type = SALE)، فسيتم تطبيق العرض الذي يوفر أقل سعر للمنتج. يتم تكرار هذا الأمر مع جميع العناصر الموجودة في عربة التسوق. سيتم استخدام السعر المخفض الجديد للعنصر في جميع عمليات حساب المتطلبات الأساسية للعروض المستقبلية.
  • في طلب واحد، يمكن للمشتري تحصيل عرض BUYER_APPLIED واحد أو AUTOMATIC_AT_CHECKOUT واحد لكل target_type (LINE_ITEM أو SHIPPING). على سبيل المثال، قد يطبق المشتري قسيمة شحن مجاني وقسيمة اشترِ واحدًا واحصل على واحد مجانًا، ولكن لا يمكنه تحصيل عرضين يقدمان خصمًا على أسعار المنتجات.
  • قد تقوم Meta في بعض الأحيان بتمويل العروض لجذب العملاء الجدد والعائدين من دون أي تكلفة على البائعين. يمكن دائمًا دمج العروض الممولة بواسطة Meta مع العروض الممولة من جانب البائعين.

تقييد أهلية المستخدم للحصول على العروض

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

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